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

先想好你要怎么用

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

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

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

1. 1
   真实页面

   打开「API 文档」

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

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

   指给我看
2. 2
   真实页面

   复制接口地址

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

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

   地址和浏览器地址栏里的不一样？

   • BASE 里显示的是另一个网址以 BASE 里的为准，照着填。有的网站接口走单独的地址。

   指给我看
3. 3
   真实页面

   建一个密钥

   点右上角 管理密钥，在弹窗里点 创建密钥。「名称」写上它用在哪，比如「我的脚本」；「权限范围」保持「全量访问」；其他先不动，点右下角的 创建密钥。

   弹窗里出现一长串完整的密钥。

   建不出来？

   • 提示「创建密钥前需先完成一次充值」这个账号还没充过值。充一次值再来建，充多少都可以。
   • 提示「请输入名称」「名称」是必填的，随便写一个你认得的名字。
   • 只想让它聊天，不想让它做图做视频「权限范围」选「对话」。但要调视频、音频，就只能用「全量访问」，其他几个选项都调不了。

   指给我看
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，写着「Invalid API key」密钥不对：少复制了几位、多了空格，或者这个密钥已经删掉了。
   • 403，写着「API key does not grant access to this endpoint」这个密钥的「权限范围」不包含这类接口。比如「对话」密钥调了图片接口。换一个全量访问的密钥。
   • 404，写着「模型 … 不存在或当前不可用」model 填成了界面上的名字，换成模型 ID。
   • 402，提示余额不足账号余额不够这一次，充值后再调。

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

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

12345

名称

真实页面

1. 1名称只是给你自己认的。按用途起名，比如「正式环境」「测试」「某某脚本」，出问题时一眼知道该删哪个。
2. 2权限范围这个密钥能调哪类接口：「全量访问」全都能调；「对话」只能聊天；「图片」只能做图；「账单」调不了生成。视频、音频只有全量访问能调。
3. 3速率限制限制这个密钥调用的快慢。第一次保持默认就行。
4. 4渠道策略用这个密钥调模型时，默认怎么挑渠道。注意这里的叫法和网页上不一样：这里「智能调度」是综合挑，「稳定优先」只挑成功率高的。拿不准就用默认的「智能调度」。
5. 5模型访问控制打开右边「限制可用模型」，这个密钥就只能调你勾选的模型，调别的会被拒绝。勾选的模型还可以锁定只用哪几个渠道。

容易忽略的几件事

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

真实页面

泄露了就删掉

为什么急

每一行都写着「限额 不限」：密钥没有花钱上限，谁拿到都能用你的余额。

怎么做

在列表里点那一行的「删除」并确认，立刻失效。再建一个新的，换到你的程序里。

不知道的话

密钥贴进了公开的代码仓库或群聊，余额被别人用光。

一个用途一个密钥

怎么做

正式跑的程序、测试、每个工具，各建一个，名称写清楚。

好处

哪个出了问题，只删那一个，别的照常用。

不知道的话

一个密钥到处用，泄露后删了它，所有程序一起停。

别把密钥写进网页或 App 里

为什么

网页和手机 App 里的代码，别人都能拆开看到，密钥等于公开了。

怎么做

密钥只放在你自己的服务器上，由服务器去调接口。

不知道的话

上线没几天密钥就被人拿走。

视频要先提交、再查结果

什么时候

调视频、音乐这类要做很久的接口。

怎么做

提交后先拿到一个任务编号，再隔一会儿用它查结果。写法在 API 文档「通用接口」的「任务与轮询」里。

不知道的话

以为请求卡住了，一直重复提交，重复扣费。

「导出文档」

在哪

API 文档页右上角。

用来

把文档导出来，发给写代码的同事，或者交给 AI 工具当参考。

不知道的话

只能一页一页截图发给别人。

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

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

还是不对？