v1

latestOpenAPI 3.1.02026-07-2634132204.7 KB

Chat

对话完成接口

用于创建对话完成的接口，支持多种对话模型，可配置各种参数来控制响应的生成。

post/chat/completions

Request body

modelstring required

对话模型

enable_thinkingboolean

开启推理模式，仅支持切换思考模式的模型支持

streamboolean

是否返回流式响应，默认false

backgroundboolean

是否开启后台任务模式，默认false，注意 stream 和 background 不能同时为 true

enable_searchboolean

是否启用联网搜索，默认false

enable_url_contextboolean

是否启用 URL Context，默认false，仅部分 Gemini 模型生效

temperaturenumber

温度参数，默认为代理模型默认值

max_completion_tokensinteger

最大输出token数,默认设置为当前模型最大支持输出

json_modeboolean

是否设置响应格式为JSON对象，默认false

modalitiesstring[]

输出的多模态类型列表

parallel_tool_callsboolean

是否并发调用工具函数

image_generationboolean

是否强制出图，仅支持对话画图的模型支持

stopstring[]

停止生成的触发词列表

logprobsboolean

是否返回token概率

top_logprobsinteger

每个位置返回的最可能token数

frequency_penaltynumber

频率惩罚系数

presence_penaltynumber

存在惩罚系数

top_pnumber

核采样阈值

top_kinteger

最高概率采样数

seedinteger

随机数种子

ninteger

生成结果数量

metadataobject

自定义元数据

sess_idstring uuid

第三方应用自行实现的会话ID

retriesinteger

自动重试次数，默认0

Example request

{
  "messages": [
    {
      "content": "你是一个助手",
      "role": "system"
    },
    {
      "content": "你好",
      "role": "user"
    }
  ],
  "max_completion_tokens": 4096,
  "top_logprobs": 2
}

Response

成功响应

idstring

请求ID

status'pending' | 'running' | 'succeed'

请求状态，只有后台模式才会返回

createdinteger

请求创建Unix时间戳

modelstring

对话使用的模型

objectstring

响应对象类型

citationsstring[]

引用的文献/链接列表

system_fingerprintstring

系统指纹