进阶：用接口把平台接进你的程序和工具

先想好你要怎么用

三种用法都要先拿到地址、密钥和模型 ID，区别在后面怎么填。

拿齐三样东西，发出第一个请求

前五步在网页上点，第六步在你电脑的终端里运行。只有第六步会扣一点点钱。

1. 1

   打开「API 文档」

   点右上角自己的头像，在菜单「模块」这一组里点 API 文档。

   打开 API 文档页：左边是目录，右上角有「复制」「模型价格」「导出文档」「管理密钥」。

   打开这一页
2. 2

   复制接口地址

   页面右上角写着「BASE」的那一格，后面那串就是你这个网站的接口地址，点旁边的 复制。

   写代码时一般用这个地址后面接 /v1，比如对话接口是「地址/v1/chat/completions」。填进第三方工具时要不要加 /v1，以它在「第三方接入」里那一页写的为准。

   打开这一页
3. 3

   建一个密钥

   点右上角 管理密钥，会打开「API 开放平台」的「API 密钥」页，点 创建密钥。「名称」写上它用在哪，比如「我的脚本」；其他先不动，点右下角 保存。

   提示「密钥已创建」，列表里多了一行。

   建不出来？

   • 提示「请输入名称」「名称」是必填的，随便写一个你认得的名字。
   • 只想让它调某几个模型在「可用渠道」里勾上要用的，或者在「高级设置」的「模型限制」里精确到单条线路。没勾的调了会被拒绝。
   • 想给它封个花钱上限关掉「不限额度」，填「额度（⚡）」，花到这个数就停。

   打开这一页
4. 4

   复制密钥，存好

   在列表里新密钥那一行点 复制，粘贴到安全的地方存好，比如密码管理器。

   按钮变成「已复制」。以后也能随时回到这里，点那一串打码的密钥看完整的，或者再点 复制。

   复制不了？

   • 提示「浏览器拒绝了复制操作」点那一串打码的密钥，在弹出的框里手动全选复制。

   打开这一页
5. 5

   找到模型 ID

   回到 API 文档，在左边「模型参考」上面的搜索框里搜模型的名字，点进去。大标题下面灰底小框里那一串等宽字就是模型 ID，选中复制；下面「请求示例」里也已经替你填好了。

   请求里的 model 要填这个 ID，不是界面上看到的名字，大小写也要一样。

   打开这一页
6. 6

   发出第一个请求

   把下面这段里尖括号的三处换成你刚复制的地址、密钥和模型 ID（尖括号也去掉），在电脑的终端里运行。

   curl <接口地址>/v1/chat/completions \ -H "Authorization: Bearer <你的密钥>" \ -H "Content-Type: application/json" \ -d '{"model": "<模型 ID>", "messages": [{"role": "user", "content": "你好"}]}'

   返回一段 JSON，里面 choices → message → content 就是模型的回答。这一次按对话扣费，和在网页上聊一句一样。

   报错了？

   • 401，提示无效的令牌密钥不对：少复制了几位、多了空格，或者这个密钥已经被删、被禁用、过期或轮换掉了。
   • 403，说模型不在这个密钥的允许范围这个密钥设了「可用渠道」或「模型限制」，你调的模型不在里面。编辑密钥把它加上，或者换一个没设限制的密钥。
   • 503，写着 model_not_foundmodel 填成了界面上的名字，换成模型 ID。
   • 403 或 402，提示余额 / 额度不足账号余额不够，或者这把密钥设的额度用完了。充值，或者编辑密钥调高额度。

创建密钥时，每一格管什么

第一次建密钥，除了「名称」都可以不动。想让密钥更安全、更省心，再回来看这几格。

容易忽略的几件事

都和钱、和安全有关，建密钥之前最好知道。

接口调用怎么扣钱、有哪些规矩

和网页上用是同一个余额、同一套扣费规则。

还是不对？