接口参考与示例

基本信息

接口地址: https://api.token-x.cn/v1
协议: 兼容 OpenAI 接口和 Anthropic 接口
鉴权: Authorization: Bearer <API 密钥>
模型名: 模型广场里每个模型的模型名

对话补全

POST /chat/completions，请求和返回按 OpenAI 的 Chat Completions 格式：model 填模型名，messages 是对话消息。也支持 OpenAI 的 Responses 格式（POST /responses，Codex 用的就是它）。

只把 <你的密钥> 换成你的完整密钥；换模型就改 model，模型名在模型广场。调用按用量扣 Credits，额度为 0 时会因额度不足被拒绝。

返回样例

choices[0].message.content 是回复，usage 是这次用的 tokens，按它扣 Credits：

流式输出：请求里加 "stream": true

回复一段段到达：每行 data: 后是一段 JSON，choices[0].delta.content 是这一段文字，最后一行是 data: [DONE]。加 "stream_options": { "include_usage": true } 时，最后一段带 usage。curl 加 -N，收到一段打印一段。

Anthropic 接口：POST /v1/messages，请求和返回按 Anthropic 的 Messages 格式。接口地址填 https://api.token-x.cn（不带 /v1，Claude Code 这类客户端会自己加上），密钥放在 x-api-key 或 Authorization: Bearer 请求头里。

视频、图片与音频

视频生成

视频按任务生成：POST /videos 提交，返回任务 id；GET /videos/{id} 查进度，status 是 completed 表示生成好了，failed 表示失败；生成好后 GET /videos/{id}/content 下载视频。请求按 OpenAI 的 Videos 格式，seconds 是时长（秒）；按分辨率计价的模型用 resolution 选分辨率，可选的值就是模型详情页价格里的档位。

export TOKENX_API_KEY="<你的密钥>"
curl https://api.token-x.cn/v1/videos \
  -H "Authorization: Bearer $TOKENX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "model": "<接口模型名>", "prompt": "一只橘猫趴在窗台上晒太阳", "seconds": 5 }'

export TASK_ID="<上一步返回的 id>"
curl https://api.token-x.cn/v1/videos/$TASK_ID \
  -H "Authorization: Bearer $TOKENX_API_KEY"

curl -o video.mp4 https://api.token-x.cn/v1/videos/$TASK_ID/content \
  -H "Authorization: Bearer $TOKENX_API_KEY"

图片生成

POST /images/generations，请求和返回按 OpenAI 的 Images 格式：prompt 写画面，返回的 data 里是生成的图片。

export TOKENX_API_KEY="<你的密钥>"
curl https://api.token-x.cn/v1/images/generations \
  -H "Authorization: Bearer $TOKENX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "model": "<接口模型名>", "prompt": "一只橘猫趴在窗台上晒太阳" }'

音频及其他模型

暂不支持 API 调用。

错误与计费

调用被拒时看 HTTP 状态码；返回体是 { "error": { "message", "type", "code" } }，同一个状态码再看 code 或 message 分清是哪种。

情况	状态码	返回体里	怎么办
密钥不对	401	Invalid token	密钥写错、没带上，或已暂停、撤销、过期。到 API 密钥页看它的状态；撤销和过期的不能再用，建一把新的。
额度不足	403	`insufficient_user_quota`Credits 额度不足，请到 AI 模型 · 充值查看余额	空间的 Credits 额度用完了，或不够这次调用。空间管理员在充值页看余额和批次。
超出密钥上限	403	`pre_consume_token_quota_failed`这把密钥的每月用量上限不够这次调用	到 API 密钥页调高这把密钥的每月用量上限。
密钥不能用这个模型	403	This token has no access to model …	到 API 密钥页，在这把密钥的可用模型里勾上它。
限流	429	随限流的一方而定	请求太快，或模型上游繁忙。等几秒再试，每次把间隔拉长。

按模型广场标的价格从 Credits 额度里扣；同一次调用不重复扣。
中途中断的，按中断前已生成的计；没有任何输出的不扣，但模型服务报告了用量的按报告计。
密钥暂停、撤销、过期或用完它的用量上限后，新调用会被拒绝。
完整规则见充值协议。调用频率另受上游厂商的限速，平台的频率和配额档位以平台公告为准。