跳转到主要内容
POST
/
v1
/
chat
/
completions
curl --request POST \ --url https://api.getinfinityblue.com/v1/chat/completions \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data ' { "model": "gpt-5.4", "messages": [ { "role": "user", "content": "用一句话介绍你自己。" } ] } '
{
  "id": "<string>",
  "object": "<string>",
  "created": 123,
  "model": "<string>",
  "choices": [
    {
      "index": 123,
      "message": {
        "content": "<string>",
        "name": "<string>",
        "tool_calls": [
          {
            "id": "<string>",
            "type": "<string>",
            "function": {
              "name": "<string>",
              "arguments": "<string>"
            }
          }
        ],
        "tool_call_id": "<string>",
        "reasoning_content": "<string>"
      }
    }
  ],
  "usage": {
    "prompt_tokens": 123,
    "completion_tokens": 123,
    "total_tokens": 123,
    "prompt_tokens_details": {
      "cached_tokens": 123,
      "text_tokens": 123,
      "audio_tokens": 123,
      "image_tokens": 123
    },
    "completion_tokens_details": {
      "text_tokens": 123,
      "audio_tokens": 123,
      "reasoning_tokens": 123
    }
  },
  "system_fingerprint": "<string>"
}

​
可填写的模型

在 model 中传入任意对话类模型 ID，例如：
模型 ID说明
gpt-5.4GPT-5 系列旗舰，顶级推理 / 编码 / Agentic，1M 上下文
gpt-5.4-mini轻量均衡版，适合高频调用与兜底
gemini-3.1-pro-previewGemini 旗舰，强多模态，1M 上下文
deepseek-v4-proDeepSeek 高性价比推理模型
完整列表见 GET /v1/models 或 模型价格页。

​
流式输出

设置 stream: true 即可接收 Server-Sent Events（SSE）。 每行格式为 data: {json}，流以 data: [DONE] 结束： 
data: {"id":"chatcmpl-...","choices":[{"delta":{"content":"你"}}]}
data: {"id":"chatcmpl-...","choices":[{"delta":{"content":"好"}}]}
data: [DONE]

​
推理模型

对支持推理的模型，可用 reasoning_effort（low / medium / high）控制推理深度。模型会在响应消息的 reasoning_content 字段返回推理过程，建议在 UI 中默认折叠展示。

​
工具调用

在 tools 中以 JSON Schema 定义函数，模型会返回结构化的 tool_calls，由你的程序执行后把结果回填到下一轮请求中。 用 tool_choice 控制调用策略（auto / none / required 或指定具体函数）。

授权

​
Authorization
string
header
必填

使用 Bearer Token 认证，格式：Authorization: Bearer sk-xxxxxx。 在 控制台 获取 API Key。

请求体

application/json
​
model
string
必填

模型 ID，例如 gpt-5.4。完整列表见 GET /v1/models。

示例:

"gpt-5.4"

​
messages
object[]
必填

到目前为止构成对话的消息列表，按时间顺序排列。

​
temperature
number
默认值:1

采样温度，取值 0–2。较高的值（如 0.8）会让输出更随机， 较低的值（如 0.2）会让输出更聚焦、更确定。建议与 top_p 二选一调整。

必填范围: 0 <= x <= 2
​
top_p
number
默认值:1

核采样（nucleus sampling）。模型只考虑累积概率达到 top_p 的 token，例如 0.1 表示只考虑概率最高的前 10%。建议与 temperature 二选一调整。

必填范围: 0 <= x <= 1
​
n
integer
默认值:1

为每条输入消息生成的补全数量。

必填范围: x >= 1
​
stream
boolean
默认值:false

是否以 Server-Sent Events 流式返回。

​
stream_options
object

流式输出的附加选项，仅在 stream=true 时生效。

​
stop

最多 4 个停止序列。模型生成到其中任一序列时停止。

​
max_tokens
integer

本次补全可生成的最大 token 数（旧字段）。推理类模型请改用 max_completion_tokens。

​
max_completion_tokens
integer

本次补全可生成的最大 token 数（含推理 token）。

​
presence_penalty
number
默认值:0

存在惩罚，取值 -2.0–2.0。正值会根据新 token 是否已在文本中 出现来惩罚它们，从而提高模型谈论新话题的可能性。

必填范围: -2 <= x <= 2
​
frequency_penalty
number
默认值:0

频率惩罚，取值 -2.0–2.0。正值会根据 token 已出现的频率来 惩罚它们，降低逐字重复的可能性。

必填范围: -2 <= x <= 2
​
logit_bias
object

调整指定 token 出现概率的偏置表，键为 token ID，值为 -100–100。

​
user
string

代表终端用户的唯一标识，可用于滥用监测。

​
tools
object[]

模型可调用的工具列表，目前仅支持 function 类型。

​
tool_choice

控制模型是否及如何调用工具。none 表示不调用，auto 由模型 自行决定，required 强制至少调用一个；也可传对象指定具体函数。

可用选项:
none,
auto,
required
​
response_format
object

控制模型输出格式。

​
seed
integer

随机种子。传入相同的 seed 和参数时尽量返回一致的结果。

​
reasoning_effort
enum<string>

推理强度，仅对支持推理的模型生效。

可用选项:
low,
medium,
high
​
modalities
enum<string>[]

期望模型返回的模态类型。

可用选项:
text,
audio
​
audio
object

音频输出参数，当 modalities 包含 audio 时使用。

响应

成功创建响应

​
id
string

本次补全的唯一标识。

​
object
string
示例:

"chat.completion"

​
created
integer

创建时间的 Unix 时间戳（秒）。

​
model
string

实际处理请求的模型。

​
choices
object[]

模型生成的补全列表。

​
usage
object

本次请求的 token 用量统计。

​
system_fingerprint
string