Chat Completions

请求

POST https://apimaster.ai/v1/chat/completions

Headers

Header	必填	说明
Authorization	是	Bearer YOUR_API_KEY
Content-Type	是	application/json

Body（常用字段）

字段	类型	说明
model	string	模型 id，如 claude-sonnet-4-6
messages	array	{role, content} 对话数组
max_tokens	number	最大生成 token
temperature	number	采样温度（可选）
stream	boolean	是否 SSE 流式

示例

curl -s "https://apimaster.ai/v1/chat/completions" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "messages": [
      {"role": "system", "content": "You are helpful."},
      {"role": "user", "content": "Say hi in one word."}
    ],
    "max_tokens": 64
  }'

响应（非流式）

{
  "id": "chatcmpl-...",
  "object": "chat.completion",
  "choices": [
    {
      "index": 0,
      "message": { "role": "assistant", "content": "..." },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 10,
    "completion_tokens": 5,
    "total_tokens": 15
  }
}

流式

设置 "stream": true 后，响应为 text/event-stream，每行 data: {json}，结束行为 data: [DONE]。

错误码

状态码	含义
400	参数错误（模型名、messages 格式等）
401	认证失败
402 / 403	配额或权限（以实现为准）
429	限流
502 / 503	上游不可用，可重试