API DOCUMENTATION

接入文档

这里展示客户接入平台需要的信息，不展示后台、支付、供应商等内部接口。

准备 API Key

登录客户端后，进入“API Key 管理”创建密钥。请求接口时，把密钥放到 Authorization 请求头里。

选择模型

可在“模型广场”查看当前可用模型。调用时，model 字段填写模型广场里展示的模型名称。

查看用量

调用完成后，可在客户端“调用日志”查看输入 Token、输出 Token、扣费和状态。

ENDPOINT

接口地址

正式上线后，请使用平台提供的正式 API 端点。当前本地测试可参考客户端“API Key 管理”页面里的接入信息。

https://你的域名/api/v1/chat/completions

EXAMPLE

普通对话调用

适合一次性返回完整回答的场景。

curl https://你的域名/api/v1/chat/completions \
  -H "Authorization: Bearer 你的 API Key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "GPT5.5",
    "messages": [
      { "role": "user", "content": "你好" }
    ]
  }'

STREAM

流式输出

需要边生成边返回时，把 stream 设置为 true。

{
  "model": "GPT5.5",
  "stream": true,
  "messages": [
    { "role": "user", "content": "请分段输出一篇文章" }
  ]
}

NOTICE

常见提示

401：API Key 不正确，或账号状态异常。
余额不足：请先充值或更换可用账号。
模型不存在：请确认 model 字段和模型广场展示名称一致。
请求格式错误：请检查 messages、role、content 是否按示例填写。