Skip to main content
POST
/
v1
/
chat
/
completions
curl -X POST https://gogogotoken.ai/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "messages": [
      { "role": "system", "content": "你是一个简洁的技术助手。" },
      { "role": "user", "content": "用三点说明 API 网关的作用。" }
    ],
    "stream": false
  }'

{
  "id": "chatcmpl_abc123",
  "object": "chat.completion",
  "created": 1730000000,
  "model": "gpt-4o",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "API 网关可以统一鉴权、转发请求，并集中记录用量。"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 32,
    "completion_tokens": 18,
    "total_tokens": 50
  }
}
使用 OpenAI Chat Completions 兼容格式发起对话请求，可统一调用 GPT、Claude、Gemini 等文本与多模态模型。 
curl -X POST https://gogogotoken.ai/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "messages": [
      { "role": "system", "content": "你是一个简洁的技术助手。" },
      { "role": "user", "content": "用三点说明 API 网关的作用。" }
    ],
    "stream": false
  }'

{
  "id": "chatcmpl_abc123",
  "object": "chat.completion",
  "created": 1730000000,
  "model": "gpt-4o",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "API 网关可以统一鉴权、转发请求，并集中记录用量。"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 32,
    "completion_tokens": 18,
    "total_tokens": 50
  }
}

​
接口说明

该接口用于以统一对话格式调用 OpenAI、Claude、Gemini 等上游模型。默认返回完整 JSON；如需边生成边展示，请在请求体中传入 "stream": true。
模型可用范围取决于 API Key 的分组权限。完整模型清单以 GET /v1/models 返回为准。

​
请求头

​
Authorization
string
required
API Key 鉴权信息，格式为 Bearer YOUR_API_KEY。
​
Content-Type
string
required
固定为 application/json。

​
请求体

​
model
string
default:"gpt-4o"
required
模型 ID，例如 gpt-4o、claude-sonnet-4-20250514、gemini-2.5-pro。可通过 GET /v1/models 查询当前 API Key 可用模型。
​
messages
object[]
required
对话消息数组，按顺序传入上下文。
​
role
string
required
消息角色，常用值为 system、user、assistant。
​
content
string
required
消息内容。文本对话可传字符串；视觉模型可传 OpenAI 兼容的多模态数组。
​
stream
boolean
default:false
是否使用 SSE 流式返回，默认 false。
​
stream_options.include_usage
boolean
流式模式下是否在结束前返回 token 用量信息。
​
temperature
number
采样温度，常用范围为 0 到 2。数值越高，输出越发散。
​
max_tokens
integer
最大输出 token 数。

​
响应体

​
id
string
本次请求的唯一 ID。
​
object
string
对象类型。非流式响应通常为 chat.completion，流式片段通常为 chat.completion.chunk。
​
model
string
实际参与生成的模型 ID。
​
choices
object[]
模型输出结果数组。非流式响应中可读取 choices[0].message.content；流式响应中可逐段读取 choices[0].delta.content。
​
usage
object
token 用量统计，通常包含 prompt_tokens、completion_tokens 与 total_tokens。

​
多模态输入

Vision 模型支持 OpenAI 兼容的图片输入格式： 
{
  "model": "gpt-4o",
  "messages": [{
    "role": "user",
    "content": [
      { "type": "text", "text": "图中是什么？" },
      { "type": "image_url", "image_url": { "url": "https://example.com/cat.png" } }
    ]
  }]
}

​
错误码

状态码含义处理建议
401API Key 无效或未传检查 Authorization 请求头
403无权限访问该模型确认 API Key 分组是否包含目标模型
402余额不足充值或调整调用配额
429触发限速降低请求频率或联系管理员
5xx上游或网关异常稍后重试，并查看控制台日志