OpenAI 对话格式(Chat Completions)
OpenAI 对话格式(Chat Completions)
OpenAI Chat
📝 简介
💡 请求示例
基础文本对话 ✅
{
"id": "chatcmpl-B9MBs8CjcvOU2jLn4n570S5qMJKcT",
"object": "chat.completion",
"created": 1741569952,
"model": "gpt-4.1-2025-04-14",
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "你好!我能为你提供什么帮助?",
"refusal": null,
"annotations": []
},
"logprobs": null,
"finish_reason": "stop"
}
],
"usage": {
"prompt_tokens": 19,
"completion_tokens": 10,
"total_tokens": 29,
"prompt_tokens_details": {
"cached_tokens": 0,
"audio_tokens": 0
},
"completion_tokens_details": {
"reasoning_tokens": 0,
"audio_tokens": 0,
"accepted_prediction_tokens": 0,
"rejected_prediction_tokens": 0
}
},
"service_tier": "default"
}
图像分析对话 ✅
{
"id": "chatcmpl-B9MHDbslfkBeAs8l4bebGdFOJ6PeG",
"object": "chat.completion",
"created": 1741570283,
"model": "gpt-4.1-2025-04-14",
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "图片展示了一条穿过茂密绿色草地或草甸的木制栈道。天空湛蓝,点缀着几朵散落的云彩,给整个场景营造出宁静祥和的氛围。背景中可以看到树木和灌木丛。",
"refusal": null,
"annotations": []
},
"logprobs": null,
"finish_reason": "stop"
}
],
"usage": {
"prompt_tokens": 1117,
"completion_tokens": 46,
"total_tokens": 1163,
"prompt_tokens_details": {
"cached_tokens": 0,
"audio_tokens": 0
},
"completion_tokens_details": {
"reasoning_tokens": 0,
"audio_tokens": 0,
"accepted_prediction_tokens": 0,
"rejected_prediction_tokens": 0
}
},
"service_tier": "default",
"system_fingerprint": "fp_fc9f1d7035"
}
流式响应 ✅
{"id":"chatcmpl-123","object":"chat.completion.chunk","created":1694268190,"model":"gpt-4o-mini", "system_fingerprint": "fp_44709d6fcb", "choices":[{"index":0,"delta":{"role":"assistant","content":""},"logprobs":null,"finish_reason":null}]}
{"id":"chatcmpl-123","object":"chat.completion.chunk","created":1694268190,"model":"gpt-4o-mini", "system_fingerprint": "fp_44709d6fcb", "choices":[{"index":0,"delta":{"content":"你好"},"logprobs":null,"finish_reason":null}]}
// ... 更多数据块 ...
{"id":"chatcmpl-123","object":"chat.completion.chunk","created":1694268190,"model":"gpt-4o-mini", "system_fingerprint": "fp_44709d6fcb", "choices":[{"index":0,"delta":{},"logprobs":null,"finish_reason":"stop"}]}
函数调用 ✅
{
"id": "chatcmpl-abc123",
"object": "chat.completion",
"created": 1699896916,
"model": "gpt-4o-mini",
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": null,
"tool_calls": [
{
"id": "call_abc123",
"type": "function",
"function": {
"name": "get_current_weather",
"arguments": "{\n\"location\": \"Boston, MA\"\n}"
}
}
]
},
"logprobs": null,
"finish_reason": "tool_calls"
}
],
"usage": {
"prompt_tokens": 82,
"completion_tokens": 17,
"total_tokens": 99,
"completion_tokens_details": {
"reasoning_tokens": 0,
"accepted_prediction_tokens": 0,
"rejected_prediction_tokens": 0
}
}
}
Logprobs 请求 ✅
{
"id": "chatcmpl-123",
"object": "chat.completion",
"created": 1702685778,
"model": "gpt-4o-mini",
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "你好!我能为你提供什么帮助?"
},
"logprobs": {
"content": [
{
"token": "Hello",
"logprob": -0.31725305,
"bytes": [72, 101, 108, 108, 111],
"top_logprobs": [
{
"token": "Hello",
"logprob": -0.31725305,
"bytes": [72, 101, 108, 108, 111]
},
{
"token": "Hi",
"logprob": -1.3190403,
"bytes": [72, 105]
}
]
},
{
"token": "!",
"logprob": -0.02380986,
"bytes": [
33
],
"top_logprobs": [
{
"token": "!",
"logprob": -0.02380986,
"bytes": [33]
},
{
"token": " there",
"logprob": -3.787621,
"bytes": [32, 116, 104, 101, 114, 101]
}
]
},
{
"token": " How",
"logprob": -0.000054669687,
"bytes": [32, 72, 111, 119],
"top_logprobs": [
{
"token": " How",
"logprob": -0.000054669687,
"bytes": [32, 72, 111, 119]
},
{
"token": "<|end|>",
"logprob": -10.953937,
"bytes": null
}
]
},
{
"token": " can",
"logprob": -0.015801601,
"bytes": [32, 99, 97, 110],
"top_logprobs": [
{
"token": " can",
"logprob": -0.015801601,
"bytes": [32, 99, 97, 110]
},
{
"token": " may",
"logprob": -4.161023,
"bytes": [32, 109, 97, 121]
}
]
},
{
"token": " I",
"logprob": -3.7697225e-6,
"bytes": [
32,
73
],
"top_logprobs": [
{
"token": " I",
"logprob": -3.7697225e-6,
"bytes": [32, 73]
},
{
"token": " assist",
"logprob": -13.596657,
"bytes": [32, 97, 115, 115, 105, 115, 116]
}
]
},
{
"token": " assist",
"logprob": -0.04571125,
"bytes": [32, 97, 115, 115, 105, 115, 116],
"top_logprobs": [
{
"token": " assist",
"logprob": -0.04571125,
"bytes": [32, 97, 115, 115, 105, 115, 116]
},
{
"token": " help",
"logprob": -3.1089056,
"bytes": [32, 104, 101, 108, 112]
}
]
},
{
"token": " you",
"logprob": -5.4385737e-6,
"bytes": [32, 121, 111, 117],
"top_logprobs": [
{
"token": " you",
"logprob": -5.4385737e-6,
"bytes": [32, 121, 111, 117]
},
{
"token": " today",
"logprob": -12.807695,
"bytes": [32, 116, 111, 100, 97, 121]
}
]
},
{
"token": " today",
"logprob": -0.0040071653,
"bytes": [32, 116, 111, 100, 97, 121],
"top_logprobs": [
{
"token": " today",
"logprob": -0.0040071653,
"bytes": [32, 116, 111, 100, 97, 121]
},
{
"token": "?",
"logprob": -5.5247097,
"bytes": [63]
}
]
},
{
"token": "?",
"logprob": -0.0008108172,
"bytes": [63],
"top_logprobs": [
{
"token": "?",
"logprob": -0.0008108172,
"bytes": [63]
},
{
"token": "?\n",
"logprob": -7.184561,
"bytes": [63, 10]
}
]
}
]
},
"finish_reason": "stop"
}
],
"usage": {
"prompt_tokens": 9,
"completion_tokens": 9,
"total_tokens": 18,
"completion_tokens_details": {
"reasoning_tokens": 0,
"accepted_prediction_tokens": 0,
"rejected_prediction_tokens": 0
}
},
"system_fingerprint": null
}
📮 请求
端点
POST /v1/chat/completions
鉴权方法
Authorization: Bearer $NEWAPI_API_KEY
$NEWAPI_API_KEY
是您的 API 密钥。您可以在 OpenAI 平台的 API 密钥页面中找到或生成 API 密钥。请求体参数
messages
消息类型 | 描述 |
---|---|
Developer message | 开发者提供的指令,模型应遵循这些指令,无论用户发送什么消息。在 o1 模型及更新版本中,开发者消息取代了之前的系统消息。 |
System message | 开发者提供的指令,模型应遵循这些指令,无论用户发送什么消息。在 o1 模型及更新版本中,请使用开发者消息代替。 |
User message | 由终端用户发送的消息,包含提示或额外的上下文信息。 |
Assistant message | 模型响应用户消息发送的消息。 |
Tool message | 工具消息的内容。 |
Function message | 已弃用。 |
属性 | 类型 | 必需 | 描述 |
---|---|---|---|
role | 字符串 | 是 | 消息作者的角色,此处为 developer 。 |
content | 字符串或数组 | 是 | 开发者消息的内容。可以是文本内容(字符串)或内容部分数组。 |
name | 字符串 | 否 | 参与者的可选名称。为模型提供信息以区分相同角色的参与者。 |
属性 | 类型 | 必需 | 描述 |
---|---|---|---|
role | 字符串 | 是 | 消息作者的角色,此处为 system 。 |
content | 字符串或数组 | 是 | 系统消息的内容。可以是文本内容(字符串)或内容部分数组。 |
name | 字符串 | 否 | 参与者的可选名称。为模型提供信息以区分相同角色的参与者。 |
属性 | 类型 | 必需 | 描述 |
---|---|---|---|
role | 字符串 | 是 | 消息作者的角色,此处为 user 。 |
content | 字符串或数组 | 是 | 用户消息的内容。可以是文本内容(字符串)或内容 部分数组。 |
name | 字符串 | 否 | 参与者的可选名称。为模型提供信息以区分相同角色的参与者。 |
内容部分类型 | 描述 | 可用于 |
---|---|---|
文本内容部分 | 文本输入。 | 所有消息类型 |
图像内容部分 | 图像输入。 | 用户消息 |
音频内容部分 | 音频输入。 | 用户消息 |
文件内容部分 | 文件输入,用于文本生成。 | 用户消息 |
拒绝内容部分 | 模型生成的拒绝消息。 | 助手消息 |
属性 | 类型 | 必需 | 描述 |
---|---|---|---|
text | 字符串 | 是 | 文本内容。 |
type | 字符串 | 是 | 内容部分的类型。 |
属性 | 类型 | 必需 | 描述 |
---|---|---|---|
image_url | 对象 | 是 | 包含图像URL或base64编码的图像数据。 |
type | 字符串 | 是 | 内容部分的类型。 |
属性 | 类型 | 必需 | 描述 |
---|---|---|---|
url | 字符串 | 是 | 图像的URL或base64编码的图像数据。 |
detail | 字符串 | 否 | 指定图像的详细级别。默认为 auto 。 |
属性 | 类型 | 必需 | 描述 |
---|---|---|---|
input_audio | 对象 | 是 | 包含音频数据的对象。 |
type | 字符串 | 是 | 内容部分的类型。始终为 input_audio 。 |
属性 | 类型 | 必需 | 描述 |
---|---|---|---|
data | 字符串 | 是 | base64编码的音频数据。 |
format | 字符串 | 是 | 编码音频数据的格式。当前支持 "wav" 和 "mp3"。 |
属性 | 类型 | 必需 | 描述 |
---|---|---|---|
file | 对象 | 是 | 包含文件数据的对象。 |
type | 字符串 | 是 | 内容部分的类型。始终为 file 。 |
属性 | 类型 | 必需 | 描述 |
---|---|---|---|
file_data | 字符串 | 否 | base64编码的文件数据,用于将文件作为字符串传递给模型。 |
file_id | 字符串 | 否 | 已上传文件的ID,用作输入。 |
filename | 字符串 | 否 | 文件名,用于将文件作为字符串传递给模型。 |
属性 | 类型 | 必需 | 描述 |
---|---|---|---|
role | 字符串 | 是 | 消息作者的角色,此处为 assistant 。 |
content | 字符串或数组 | 否 | 助手消息的内容。除非指定了 tool_calls 或 function_call ,否则为必需。 |
name | 字符串 | 否 | 参与者的可选名称。为模型提供信息以区分相同角色的参与者。 |
audio | 对象或null | 否 | 关于模型先前音频响应的数据。 |
function_call | 对象或null | 否 | 已弃用,由 tool_calls 替代。应调用的函数的名称和参数,由模型生成。 |
tool_calls | 数组 | 否 | 模型生成的工具调用,如函数调用。 |
refusal | 字符串或null | 否 | 助手的拒绝消息。 |
属性 | 类型 | 必需 | 描述 |
---|---|---|---|
role | 字符串 | 是 | 消息作者的角色,此处为 tool 。 |
content | 字符串或数组 | 是 | 工具消息的内容。 |
tool_call_id | 字符串 | 是 | 此消息响应的工具调用。 |
属性 | 类型 | 必需 | 描述 |
---|---|---|---|
role | 字符串 | 是 | 消息作者的角色,此处为 function 。 |
content | 字符串或null | 是 | 函数消息的内容。 |
name | 字符串 | 是 | 要调用的函数的名称。 |
model
store
reasoning_effort
low
、medium
和 high
。减少推理工作可以加快响应速度并减少响应中用于推理的标记数。metadata
modalities
["text"]
["text", "audio"]
prediction
类型 | 描述 |
---|---|
静态内容 | 静态预测输出内容,例如正在重新生成的具有微小更改的文本文件内容。 |
属性 | 类型 | 必需 | 描述 |
---|---|---|---|
content | 字符串或数组 | 是 | 生成模型响应时应匹配的内容。如果生成的标记 与此内容匹配,则整个模型响应可以更快地返回。 |
type | 字符串 | 是 | 要提供的预测内容类型。当前类型始终为 content 。 |
1.
2.
属性 | 类型 | 必需 | 描述 |
---|---|---|---|
text | 字符串 | 是 | 文本内容。 |
type | 字符串 | 是 | 内容部分的类型。 |
audio
modalities: ["audio"]
请求音频输出时需要。属性 | 类型 | 必需 | 描述 |
---|---|---|---|
format | 字符串 | 是 | 指定输出音频格式。必须是以下之一:wav、mp3、flac、opus 或 pcm16。 |
voice | 字符串 | 是 | 模型用于响应的声音。支持的声音包括:alloy、ash、ballad、coral、echo、fable、nova、onyx、sage 和 shimmer。 |
temperature
top_p
,但不要同时更改。top_p
temperature
,但不要同时更改。n
n
为 1 可最大限度地降低成本。stop
max_tokens
max_completion_tokens
,并且与 o1
系列模型不兼容。max_completion_tokens
presence_penalty
frequency_penalty
logit_bias
logprobs
message.content
中每个输出标记的对数概率。user
service_tier
stream_options
stream: true
时使用。属性 | 类型 | 必需 | 描述 |
---|---|---|---|
include_usage | 布尔值 | 否 | 如果设置,将在 data: [DONE] 消息之前流式传输一个附加块。该块上的 usage 字段显示整个请求的令牌使用统计信息,choices 字段始终为空数组。所有其他块也将包含 usage 字段,但值为 null。注意:如果流被中断,您可能不会收到包含请求总令牌使用量的最终使用块。 |
response_format
{ "type": "json_schema", "json_schema": {...} }
启用结构化输出,确保模型将匹配您提供的 JSON schema。{ "type": "json_object" }
启用 JSON 模式,确保模型生成的消息是有效的 JSON。类型 | 描述 |
---|---|
text | 默认响应格式。用于生成文本响应。 |
json_schema | JSON Schema 响应格式。用于生成结构化 JSON 响应。了解更多关于结构化输出的信息。 |
json_object | JSON 对象响应格式。一种较老的生成 JSON 响应的方法。对于支持的模型,推荐使用 json_schema。 |
属性 | 类型 | 必需 | 描述 |
---|---|---|---|
type | 字符串 | 是 | 正在定义的响应格式类型。始终为 text 。 |
属性 | 类型 | 必需 | 描述 |
---|---|---|---|
json_schema | 对象 | 是 | 结构化输出配置选项,包括 JSON Schema。 |
type | 字符串 | 是 | 正在定义的响应格式类型。始终为 json_schema 。 |
属性 | 类型 | 必需 | 描述 |
---|---|---|---|
name | 字符串 | 是 | 响应格式的名称。必须是 a-z、A-Z、0-9 或包含下划线和破折号,最大长度为 64。 |
description | 字符串 | 否 | 响应格式的用途描述,模型用它来确定如何以该格式响应。 |
schema | 对象 | 否 | 响应格式的架构,描述为 JSON Schema 对象。 |
strict | 布尔值或 null | 否 | 是否在生成输出时启用严格架构遵守。如果设置为 true,模型将始终遵循 schema 字段中定义的确切架构。strict 为 true 时,仅支持 JSON Schema 的子集。 |
属性 | 类型 | 必需 | 描述 |
---|---|---|---|
type | 字符串 | 是 | 正在定义的响应格式类型。始终为 json_object 。 |
seed
Beta 功能。如果指定,我们的系统将尽最大努力进行确定性采样,使得具有相同 seed 和参数的重复请求应返回相同的结果。不保证确定性,您应参考响应参数的 system_fingerprint 以监控后端的变化。
tools
属性 | 类型 | 必需 | 描述 |
---|---|---|---|
function | 对象 | 是 | 要调用的函数信息 |
type | 字符串 | 是 | 工具的类型。目前,仅支持 function。 |
属性 | 类型 | 必需 | 描述 |
---|---|---|---|
name | 字符串 | 是 | 要调用的函数名称。必须是a-z、A-Z、0-9,或包含下划线和破折号,最大长度为64。 |
description | 字符串 | 否 | 函数功能的描述,模型用它来选择何时以及如何调用函数。 |
parameters | 对象 | 否 | 函数接受的参数,描述为JSON Schema对象。请参阅指南获取示例,以及JSON Schema参考了解格式文档。省略parameters定义一个空参数列表的函数。 |
strict | 布尔值或 null | 否 | 默认值:false。是否在生成函数调用时启用严格架构遵守。如果设置为 true,模型将遵循 parameters 字段中定义的确切架构。strict 为 true 时,仅支持 JSON Schema 的子集。详情请参阅函数调用指南中的结构化输出部分。 |
functions
tools
属性 | 类型 | 必需 | 描述 |
---|---|---|---|
name | 字符串 | 是 | 要调用的函数名称。必须是a-z、A-Z、0-9,或包含下划线和破折号,最大长度为64。 |
description | 字符串 | 否 | 函数功能的描述,模型用它来选择何时以及如何调用函数。 |
parameters | 对象 | 否 | 函数接受的参数,描述为JSON Schema对象。省略parameters定义一个空参数列表的函数。 |
tool_choice
none
:模型不会调用任何工具,而是生成消息auto
:模型可以在生成消息或调用一个或多个工具之间选择required
:模型必须调用一个或多个工具{"type": "function", "function": {"name": "my_function"}}
:强制模型调用特定工具none
,有工具时默认为 auto
。类型 | 描述 |
---|---|
字符串 | none 表示模型不会调用任何工具,而是生成消息。auto 表示模型可以在生成消息或调用一个或多个工具之间选择。required 表示模型必须调用一个或多个工具。 |
对象 | 指定模型应使用的工具。用于强制模型调用特定函数。 |
属性 | 类型 | 必需 | 描述 |
---|---|---|---|
function | 对象 | 是 | 包含函数信息的对象 |
type | 字符串 | 是 | 工具的类型。目前,仅支持 function。 |
属性 | 类型 | 必需 | 描述 |
---|---|---|---|
name | 字符串 | 是 | 要调用的函数名称。 |
function_call
none
,有函数时 为 auto
tool_choice
none
:模型不会调用函数,而是生成消息auto
:模型可以在生成消息或调用函数之间选择{"name": "my_function"}
:强制模型调用特定函数属性 | 类型 | 必需 | 描述 |
---|---|---|---|
name | 字符串 | 是 | 要调用的函数名称。 |
parallel_tool_calls
stream
top_logprobs
logprobs
设置为 true。web_search_options
属性 | 类型 | 必需 | 描述 |
---|---|---|---|
search_context_size | 字符串 | 否 | 默认值:medium。用于搜索的上下文窗口空间量的高级指导。可选值为 low、medium 或 high。medium 是默认值。 |
user_location | 对象或 null | 否 | 搜索的近似位置参数。 |
属性 | 类型 | 必需 | 描述 |
---|---|---|---|
approximate | 对象 | 是 | 搜索的近似位置参数。 |
属性 | 类型 | 必需 | 描述 |
---|---|---|---|
city | 字符串 | 否 | 用户城市 的自由文本输入,例如 San Francisco。 |
country | 字符串 | 否 | 用户的两字母 ISO 国家代码,例如 US。 |
region | 字符串 | 否 | 用户地区的自由文本输入,例如 California。 |
timezone | 字符串 | 否 | 用户的 IANA 时区,例如 America/Los_Angeles。 |
type | 字符串 | 是 | 位置近似类型。始终为 approximate。 |
📥 响应
聊天补全对象
id
object
created
model
system_fingerprint
choices
index
: 选项在选项列表中的索引。message
: 模型生成的聊天补全消息。role
: 消息作者的角色。content
: 消息的内容,可能为 null。refusal
: 模型生成的拒绝消息,可能为 null。annotations
: 消息的注释,在适用时提供,例如使用网络搜索工具时。type
: 注释类型,URL引用时始终为 "url_citation"。url_citation
: 使用网络搜索时的URL引用。start_index
: URL引用在消息中的第一个字符的索引。end_index
: URL引用在消息中的最后一个字符的索引。url
: 网络资源的URL。title
: 网络资源的标题。audio
: 如果请求了音频输出模态,此对象包含来自模型的音频响应的数据。data
: 模型生成的Base64编码音频字节,格式在请求中指定。id
: 此音频响应的唯一标识符。transcript
: 模型生成的音频的转录。expires_at
: 此音频响应在服务器上可用于多轮对话的Unix时间戳(秒)。function_call
: (已弃用)应调用的函数的名称和参数,由模型生成。已被 tool_calls
替代。name
: 要调用的函数的名称。arguments
: 用于调用函数的参数,由模型以JSON格式生成。tool_calls
: 模型生成的工具调用,如函数调用。id
: 工具调用的ID。type
: 工具的类型。目前,仅支持 function。function
: 模型调用的函数。name
: 要调用的函数的名称。arguments
: 用于调用函数的参数,由模型以JSON格式生成。注意,模型并不总是生成有效的JSON,并且可能会产生您函数架构中未定义的参数。在调用函数之前,请在代码中验证参数。logprobs
: 对数概率信息。content
: 带有对数概率信息的消息内容标记列表。token
: 标记。logprob
: 此标记的对数概率,如果它在前20个最可能的标记内。否则,使用-9999.0的值表示此标记非常不可能。bytes
: 表示标记的UTF-8字节表示的整数列表。在字符由多个标记表示且必须组合它们的字节表示以生成正确的文本表示的情况下很有用。如果标记没有字节表示,则可能为null。top_logprobs
: 在此标记位置上最可能的标记及其对数概率的列表。在罕见情况下,返回的top_logprobs数量可能少于请求的数量。refusal
: 带有对数概率信息的消息拒绝标记列表。finish_reason
: 模型停止生成标记的原因。如果模型到达自然停止点或提供的停止序列,则为 "stop";如果达到请求中指定的最大标记数,则为 "length";如果由于内容过滤器标记而省略内容,则为 "content_filter";如果模型调用了工具,则为 "tool_calls";如果模型调用了函数,则为 "function_call"(已弃用)。usage
prompt_tokens
: 提示中的标记数。completion_tokens
: 生成的补全中的标记数。total_tokens
: 请求中使用的标记总数(提示 + 补全)。prompt_tokens_details
: 提示中使用的标记的细分。cached_tokens
: 提示中存在的缓存标记。audio_tokens
: 提示中存在的音频输入标记。completion_tokens_details
: 补全中使用的标记的细分。reasoning_tokens
: 模型生成的推理标记。audio_tokens
: 模型生成的音频标记。accepted_prediction_tokens
: 使用预测输出时,预测中出现在补全中的标记数。rejected_prediction_tokens
: 使用预测输出时,预测中未出现在补全中的标记数。但是,与推理标记一样,这些标记仍计入计费、输出和上下文窗口限制的总补全标记中。service_tier
聊天补全对象响应示例
{
"id": "chatcmpl-B9MHDbslfkBeAs8l4bebGdFOJ6PeG",
"object": "chat.completion",
"created": 1741570283,
"model": "gpt-4o-2024-08-06",
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "图片展示了一条穿过茂密绿色草地或草甸的木制栈道。天空湛蓝,点缀着几朵散落的云彩,给整个场景营造出宁静祥和的氛围。背景中可以看到树木和灌木丛。",
"refusal": null,
"annotations": []
},
"logprobs": null,
"finish_reason": "stop"
}
],
"usage": {
"prompt_tokens": 1117,
"completion_tokens": 46,
"total_tokens": 1163,
"prompt_tokens_details": {
"cached_tokens": 0,
"audio_tokens": 0
},
"completion_tokens_details": {
"reasoning_tokens": 0,
"audio_tokens": 0,
"accepted_prediction_tokens": 0,
"rejected_prediction_tokens": 0
}
},
"service_tier": "default",
"system_fingerprint": "fp_fc9f1d7035"
}
聊天补全列表对象
object
data
first_id
last_id
has_more
聊天补全列表响应示例
{
"object": "list",
"data": [
{
"object": "chat.completion",
"id": "chatcmpl-AyPNinnUqUDYo9SAdA52NobMflmj2",
"model": "gpt-4o-2024-08-06",
"created": 1738960610,
"request_id": "req_ded8ab984ec4bf840f37566c1011c417",
"tool_choice": null,
"usage": {
"total_tokens": 31,
"completion_tokens": 18,
"prompt_tokens": 13
},
"seed": 4944116822809979520,
"top_p": 1.0,
"temperature": 1.0,
"presence_penalty": 0.0,
"frequency_penalty": 0.0,
"system_fingerprint": "fp_50cad350e4",
"input_user": null,
"service_tier": "default",
"tools": null,
"metadata": {},
"choices": [
{
"index": 0,
"message": {
"content": "电路之心低吟,\n在寂静中学习模式—\n未来的宁静火花。",
"role": "assistant",
"tool_calls": null,
"function_call": null
},
"finish_reason": "stop",
"logprobs": null
}
],
"response_format": null
}
],
"first_id": "chatcmpl-AyPNinnUqUDYo9SAdA52NobMflmj2",
"last_id": "chatcmpl-AyPNinnUqUDYo9SAdA52NobMflmj2",
"has_more": false
}
聊天补全消息列表对象
object
data
id
: 聊天消息的标识符role
: 消息作者的角色content
: 消息的内容,可能为 nullname
: 消息发送者的名称,可能为 nullrefusal
: 模型生成的拒绝消息,可能为 nullannotations
: 消息的注释,在适用时提供,例如使用网络搜索工具时type
: 注释类型,URL引用时始终为 "url_citation"url_citation
: 使用网络搜索时的URL引用start_index
: URL引用在消息中的第一个字符的索引end_index
: URL引用在消息中的最后一个字符的索引url
: 网络资源的URLtitle
: 网络资源的标题audio
: 如果请求了音频输出模态,此对象包含来自模型的音频响应的数据data
: 模型生成的Base64编码音频字节,格式在请求中指定id
: 此音频响应的唯一标识符transcript
: 模型生成的音频的转录expires_at
: 此音频响应在服务器上可用于多轮对话的Unix时间戳(秒)function_call
: (已弃用)应调用的函数的名称和参数,由模型生成。已被 tool_calls
替代name
: 要调用的函数的名称arguments
: 用于调用函数的参数,由模型以JSON格式生成tool_calls
: 模型生成的工具调用,如函数调用id
: 工具调用的IDtype
: 工具的类型。目前,仅支持 functionfunction
: 模型调用的函数name
: 要调用的函数的名称arguments
: 用于调用函数的参数,由模型以JSON格式生成first_id
last_id
has_more
聊天补全消息列表响应示例
{
"object": "list",
"data": [
{
"id": "chatcmpl-AyPNinnUqUDYo9SAdA52NobMflmj2-0",
"role": "user",
"content": "写一首关于人工智能的俳句",
"name": null,
"content_parts": null
}
],
"first_id": "chatcmpl-AyPNinnUqUDYo9SAdA52NobMflmj2-0",
"last_id": "chatcmpl-AyPNinnUqUDYo9SAdA52NobMflmj2-0",
"has_more": false
}
修改于 2025-05-30 01:48:51