API 参考

基础地址：https://aitokone.com/v1　｜　协议：OpenAI 兼容（HTTP + JSON）

鉴权

所有请求通过 HTTP 头携带 API Key：

Authorization: Bearer sk-你的密钥

密钥在控制台「令牌」页面创建。请勿在前端代码、公开仓库或截图里暴露密钥。

端点一览

方法	路径	说明
POST	`/v1/responses`	Responses API，新项目推荐使用
POST	`/v1/chat/completions`	对话补全，兼容性最好
POST	`/v1/images/generations`	图像生成
GET	`/v1/models`	获取当前可用模型列表

POST /v1/chat/completions

请求体

字段	类型	必填	说明
`model`	string	是	模型名，见模型列表
`messages`	array	是	消息数组，每项含 `role` 与 `content`
`stream`	bool	否	是否流式返回，默认 `false`
`temperature`	number	否	采样温度
`max_tokens`	integer	否	最大生成 token 数

示例

curl https://aitokone.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-你的密钥" \
  -d '{
    "model": "gpt-5.6-sol",
    "messages": [
      {"role": "system", "content": "你是一个简洁的助手"},
      {"role": "user", "content": "解释一下什么是流式输出"}
    ],
    "stream": false
  }'

响应要点

{
  "id": "chatcmpl-...",
  "object": "chat.completion",
  "created": 1790093702,
  "model": "gpt-5.6-sol",
  "choices": [
    {
      "index": 0,
      "message": {"role": "assistant", "content": "..."},
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 26,
    "completion_tokens": 128,
    "total_tokens": 154
  }
}

usage 中的三个字段就是本次计费的依据，可在控制台「日志」页面核对。

POST /v1/responses

与 Chat Completions 语义一致，但使用 input 字段承载输入，并返回 output 数组。

curl https://aitokone.com/v1/responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-你的密钥" \
  -d '{
    "model": "gpt-5.6-sol",
    "input": "用三句话介绍 HTTP 协议"
  }'

若你使用的客户端（例如 Codex）声明 wire_api = "responses"，请把基础地址设为 https://aitokone.com/v1，客户端会自动拼出 /v1/responses。

POST /v1/images/generations

字段	类型	必填	说明
`model`	string	是	图像模型名，如 `gpt-image-1`
`prompt`	string	是	图像描述文本
`size`	string	否	如 `1024x1024`
`n`	integer	否	生成张数

curl https://aitokone.com/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-你的密钥" \
  -d '{
    "model": "gpt-image-1",
    "prompt": "一只在图书馆看书的柴犬，扁平插画风格",
    "size": "1024x1024",
    "n": 1
  }'

GET /v1/models

curl https://aitokone.com/v1/models \
  -H "Authorization: Bearer sk-你的密钥"

返回该令牌所属分组可用的全部模型，可直接用于客户端「拉取模型列表」功能。

错误码对照

HTTP	含义	排查方向
400	请求参数错误	检查 JSON 是否合法、`model` 是否拼错、`messages` 是否为数组
401	鉴权失败	密钥错误或已删除；确认 `Bearer` 前缀与空格
403	无权限	该令牌分组不允许使用此模型，或令牌已过期
404	端点或模型不存在	检查基础地址是否多了或少了 `/v1`
429	请求过于频繁或额度不足	降低并发；到「钱包」页面确认余额
500 / 502	上游服务异常	稍后重试；若持续出现请在控制台提交工单

关于 429：本站按账号与令牌双维度限流。若你是批量任务场景，请先降低并发到 2–4，再逐步上调；一次性打满并发会触发限流并返回 429。

幂等与重试建议

对 5xx 与网络超时采用指数退避重试（1s → 2s → 4s），最多 3 次。
对 4xx 不要盲目重试，先按上表修正请求。
流式请求中断后建议整段重发，不要拼接半截结果。