Skip to Content
goldflow.cc 文档
聊天系列OpenAI 兼容

ChatCompletions 格式

POST
/v1/chat/completions

OpenAI Chat Completions 兼容接口。支持文本、多模态输入、工具调用和流式响应。

Authorization

bearerAuth
headerAuthorizationBearer <API key>

使用 Authorization Bearer API Key 进行鉴权。

Request Body

application/json
  1. body
model*string

要调用的模型 ID。

messages*array<>

按顺序排列的对话消息列表。

Items1 <= items
temperature?number

采样温度,数值越高输出越随机。

Range0 <= value <= 2
Default0.7
top_p?number

核采样参数,用于控制候选 token 的累计概率范围。

max_tokens?integer

生成回复时允许输出的最大 token 数。

Range1 <= value
stream?boolean

是否以流式方式返回响应。

tools?array<>

可供模型调用的工具定义列表。

tool_choice?|

工具调用策略,可以指定自动选择或强制调用某个工具。

response_format?

响应格式约束,例如 JSON Object 或 JSON Schema。

asr_options?

MiMo-V2.5-ASR 语音识别参数。

audio?

MiMo-V2.5-TTS 系列的音频生成参数。

Response Body

Chat Completions 响应。

application/json
  1. response
id*string

Chat Completions 响应 ID。

object*string

对象类型。

created?integer

响应创建时间,Unix 秒级时间戳。

model*string

实际响应使用的模型 ID。

choices*array<>

模型生成的候选回复列表。

usage?
curl -X POST 'https://goldflow.cc/v1/chat/completions' \  -H 'Content-Type: application/json' \  -d '{  "model": "gpt-5.4-nano",  "messages": [    {      "role": "user",      "content": "Write a concise launch note."    }  ]}'
Example Response
{  "id": "string",  "object": "string",  "created": 0,  "model": "string",  "choices": [    {      "index": 0,      "message": {        "role": "system",        "content": "string",        "name": "string",        "tool_call_id": "string",        "tool_calls": [          {}        ],        "audio": {          "id": "string",          "data": "string",          "expires_at": 0,          "transcript": "string"        },        "final_text_preview": "string"      },      "delta": {},      "finish_reason": "string"    }  ],  "usage": {    "prompt_tokens": 0,    "completion_tokens": 0,    "total_tokens": 0,    "input_tokens": 0,    "output_tokens": 0  }}