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
  }'

Gemini 思考等级

Gemini 原生渠道上的 gemini-4-argon 和 gemini-3.8-flash 支持顶层 reasoning_effort：low、medium、high，由网关转换为原生 generationConfig.thinkingConfig.thinkingLevel。Argon 另支持将 reasoning_effort: "minimal" 映射为 low；Flash 3.8 不支持 minimal。不传等级时保留上游默认行为，官方默认等级为 medium。

{
  "model": "gemini-4-argon",
  "messages": [{"role": "user", "content": "Explain your answer briefly."}],
  "reasoning_effort": "high"
}

也可以省略 reasoning_effort，改用以下请求体字段：

{
  "extra_body": {
    "google": {
      "thinking_config": {"thinking_level": "high", "include_thoughts": true}
    }
  }
}

• 显式 thinking_level 仅支持 low、medium、high。未知等级、不支持的 reasoning_effort 返回 HTTP 400。
• reasoning_effort 不能与 thinking_level 或 thinking_budget 同时传入，即使值相同；单独的 include_thoughts 可以与其配合。Argon 也不能同时传 thinking_level 和 thinking_budget。
• Python OpenAI SDK 的 extra_body 参数会合并到请求体。要保留上述 JSON 的外层字段，应传 extra_body={"extra_body": {"google": {"thinking_config": {"thinking_level": "high"}}}}。
• high 请求最高公开推理等级，思考 token 数仍动态变化。max_tokens 同时限制思考和答案，不要用很小的值验证等级。
• 网关保证参数转换和转发；供应商是否执行该等级需按渠道验证。HTTP 200、reasoning token 数和模型自述均不能单独证明等级生效，响应不提供经确认的实际应用等级。

规则依据：Google OpenAI 兼容接口、Gemini 模型思考等级。其他模型及其他协议的支持情况按各自适配器处理。

响应（非流式）

{
  "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	上游不可用，可重试