跳转到主要内容
POST
对话完成接口
注:你可以在模型广场筛选查看系统支持的所有对话模型列表,对话模型请求/响应参数结构兼容 OpenAI,切换模型时只需修改对应的模型名称即可,若模型请求/响应参数和 OpenAI 不一致,极客智坊底层会自动转换对齐。 除百度文心一言和讯飞星火模型外,其他所有平台支持函数调用(具体支持模型以平台限制为准)。 调用 GPTs 模型 API 时,需要将 gpt-4-gizmo-* 中的 * 替换成对应 GPTs 的 gizmo_id,获取方式:从 GPTs URL 中提取,以 https://chatgpt.com/g/g-bo0FiWLY7-researchgpt 为例, 对应的 gizmo_id 为 g-bo0FiWLY7。
响应数据基础结构和 OpenAI 完全兼容,并在其基础上为适配其他模型新增功能,提供了对搜索引用链接(citations)、搜索计费次数(billed_units)、消息内容支持视频、图片/视频输入tokens、推理模式设置(thinking)的支持,响应结构会根据是否是流式输出而变化,可以参考下面的请求示例进行判断。 关于对话模型 API 调用示例,可以参考这里:文本对话

请求/响应参数明细

授权

Authorization
string
header
必填

API认证token

请求体

application/json
model
string
默认值:gpt-5-mini
必填

对话模型

messages
object[]
必填

消息列表

示例:
enable_thinking
boolean
默认值:false

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

thinking
object

推理模式细节配置

stream
boolean
默认值:false

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

background
boolean
默认值:false

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

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

search_config
object

联网搜索配置明细,仅智谱清言和不支持内置搜索工具的模型适用

enable_url_context
boolean
默认值:false

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

temperature
number

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

max_completion_tokens
integer

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

示例:

4096

json_mode
boolean
默认值:false

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

response_format
Text · object

指定响应输出格式,默认不指定为文本输出,如果设置该配置项会覆盖json_mode设置

modalities
enum<string>[]

输出的多模态类型列表

可用选项:
text,
image,
audio,
video
audio
object

音频输出配置

image
object

图像生成配置,仅 Gemini 3 Pro Image 适用

tools
array

可调用的工具函数列表

tool_choice

模型在生成响应时应如何选择使用哪个工具(或多个工具)

可用选项:
none,
auto,
required
tool_config
object

工具函数调用配置(兼容gemini)

parallel_tool_calls
boolean
默认值:true

是否并发调用工具函数

image_generation
boolean
默认值:false

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

stop
string[]

停止生成的触发词列表

logprobs
boolean
默认值:false

是否返回token概率

top_logprobs
integer

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

示例:

2

frequency_penalty
number
默认值:0

频率惩罚系数

presence_penalty
number
默认值:0

存在惩罚系数

top_p
number
默认值:1

核采样阈值

top_k
integer
默认值:1

最高概率采样数

seed
integer

随机数种子

n
integer
默认值:1

生成结果数量

metadata
object

自定义元数据

sess_id
string<uuid>

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

retries
integer
默认值:0

自动重试次数,默认0

响应

成功响应

id
string

请求ID

status
enum<string>

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

可用选项:
pending,
running,
succeed
created
integer

请求创建Unix时间戳

model
string

对话使用的模型

object
string

响应对象类型

choices
object[]

生成的对话列表

usage
object

tokens消耗统计

citations
string[]

引用的文献/链接列表

system_fingerprint
string

系统指纹