跳到主要内容

快速开始

本指南带你走完接入 187API 的完整最短路径：注册账号、登录控制台、充值额度、创建 API 令牌、发起第一次请求。

阅读建议​

第一次接入时，建议按顺序完成下面五步，再开始正式调用：

注册账号 → 登录控制台 → 充值额度 → 创建 API 令牌 → 发起第一次请求

已能正常调用后，再按你使用的客户端阅读对应的接入教程（Claude Code、OpenAI SDK 等）。

第一步：注册账号​

注册入口：

https://187api.com/register

打开后填写邮箱/手机号与密码完成注册。注册完成后，建议先确认能正常跳转到 登录页 或 控制台。

第二步：登录账号​

登录入口：

https://187api.com/login

登录成功后进入控制台首页。

  • 顶部导航：首页、控制台、文档
  • 左侧菜单：数据看板、令牌管理、钱包管理、日志、用量明细 等

第三步：充值额度​

进入控制台后，先确认账户余额是否充足。

  1. 左侧菜单点 钱包管理（或「充值」）进入充值页面
  2. 完成充值后，回 数据看板 查看：
    • 当前余额
    • 历史消耗
    • 请求次数

:::warning 额度不足会导致请求失败 如果账户没有可用额度，即使 API 令牌创建成功，接口请求也可能依然失败（返回余额或额度相关错误）。 :::

充值与计费的关系：充值是增加可用额度，调用模型是消耗可用额度。扣多少看对应模型的价格，详见 模型与计费。

第四步：创建 API 令牌​

API Key（也叫「令牌」或「密钥」）是后面要粘贴到配置文件或请求头里的那串身份凭证。它不是模型名称，也不是请求地址。

新手只要记住这 3 步：

  1. 按你要用的模型/客户端，选择对应分组创建令牌
  2. 提交后回到令牌列表，直接复制；复制出来的是纯 key（形如 sk- 开头），不含 Bearer
  3. 回到配置页：独立输入框直接粘贴完整 key；只有配置文件或示例里的占位文字才需要替换

具体步骤​

  1. 左侧菜单点 令牌管理
  2. 点 添加令牌
  3. 填写令牌信息：
字段说明建议
令牌名称仅用于你自己辨认用项目名，如 blog-prod、测试
令牌分组决定这把 key 能调用哪些模型默认 default；不确定就选 default
额度这把 key 能扣的最大余额按用量给，先给小额
过期时间到点自动失效生产 key 建议设 90 天轮换
模型可用列表可选，限制可调用的模型新手建议留空（不额外限制）
  1. 点 提交，完成创建
  2. 回令牌列表，找到刚创建的记录，直接复制密钥

出于安全原因，页面可能只显示部分字符；点密钥栏的「查看/复制」按钮即可拿到完整 key。

你的 API Key 到底填在哪里？​

你的API_KEY / YOUR_API_KEY / *** 只是占位文字，不能原样保留。以下是填写规则：

看到的位置正确填写方式注意事项
JSON / TOML 配置把引号里的占位符替换为完整 key保留原有引号，别删字段名或等号
.env 文件OPENAI_API_KEY=你的完整key不加引号，等号两边不加空格
网页上的 key 输入框直接粘贴完整 key不加引号，不要输入 Bearer
示例里的 Authorization: Bearer ***只替换 *** 为完整 keyBearer 只有在示例已写出时才保留

例如这行：

"OPENAI_API_KEY": "你的API_KEY"

替换后应仍然保持同样结构：

"OPENAI_API_KEY": "sk-你的完整key"

:::danger key 等同余额 API Key 只应保存在本机受控配置文件、服务端环境变量或密钥管理工具中，不要写进前端代码、公开仓库或聊天截图。泄露了立刻回控制台删除/禁用该令牌。 :::

第五步：发起第一次请求​

在开始调用前，先确认下面三项：

  • Base URL：https://187api.com
  • Authorization：Bearer YOUR_API_KEY
  • 模型名：以控制台实际可用模型为准（下文示例用 MiniMax-M2.5）

curl​

curl https://187api.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "MiniMax-M2.5",
    "messages": [
      {"role": "user", "content": "你好，请简单介绍一下你自己。"}
    ]
  }'

PowerShell（Windows）​

$headers = @{
    Authorization = "Bearer YOUR_API_KEY"
}

$body = @{
    model    = "MiniMax-M2.5"
    messages = @(
        @{ role = "user"; content = "你好，请简单介绍一下你自己。" }
    )
} | ConvertTo-Json -Depth 5

Invoke-RestMethod `
  -Uri "https://187api.com/v1/chat/completions" `
  -Method Post `
  -Headers $headers `
  -ContentType "application/json" `
  -Body $body

Python​

import requests

url = "https://187api.com/v1/chat/completions"
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer YOUR_API_KEY",
}
payload = {
    "model": "MiniMax-M2.5",
    "messages": [
        {"role": "user", "content": "你好，请简单介绍一下你自己。"}
    ],
}

response = requests.post(url, headers=headers, json=payload, timeout=60)
print(response.status_code)
print(response.json())

Node.js​

const response = await fetch("https://187api.com/v1/chat/completions", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    Authorization: "Bearer YOUR_API_KEY",
  },
  body: JSON.stringify({
    model: "MiniMax-M2.5",
    messages: [
      { role: "user", content: "你好，请简单介绍一下你自己。" },
    ],
  }),
});
const result = await response.json();
console.log(result);

调用失败时优先检查什么​

按顺序排查：

  1. 请求地址是否正确（Base URL 是 https://187api.com，Chat 接口是 /v1/chat/completions）
  2. Authorization 是否为 Bearer 你的key（Bearer 后要有空格）
  3. API Key 是否复制完整（少了首尾字符）
  4. 模型名是否可用（拼写、大小写、是否在你的分组内）
  5. 账户是否还有可用额度
  6. 请求体 JSON 格式是否正确

具体错误含义见 错误码。

下一步阅读​