Skip to main content

请求体

string
必填
要使用的模型 ID。可用选项见 Models
array
必填
组成对话的消息列表。每个消息对象包含:
  • role (字符串): systemuserassistant
  • content (string | array): 消息内容
content 是数组时,AI Sonar 为兼容模型支持结构化多模态块:
  • text: { "type": "text", "text": "..." }
  • 图片: { "type": "image_url", "image_url": { "url": "https://..." } }
  • 视频: { "type": "video_url", "video_url": { "url": "https://..." } }
  • 音频: { "type": "audio_url", "audio_url": { "url": "https://..." } }
对于多模态生产流量,优先使用公开的 https URL。AI Sonar 会将这些媒体块转换为所选模型所需的供应商特定请求形态。
number
默认值:"1"
采样温度,范围在 0 到 2 之间。较高的值会使输出更随机。
integer
要生成的最大 token 数。
boolean
默认值:"false"
如果为 true,则部分消息增量将作为 SSE events 发送。
object
流式传输选项。设置 include_usage: true 以在流分片中接收 token 使用情况。
number
默认值:"1"
Nucleus 采样参数。建议更改此参数或 temperature,而不是同时更改两者。
number
默认值:"0"
值在 -2.0 到 2.0 之间。正值会惩罚重复出现的 token。
number
默认值:"0"
值在 -2.0 到 2.0 之间。正值会惩罚已出现在文本中的 token。
string | array
最多 4 个序列,API 在遇到这些序列时会停止生成 token。
array
模型可能调用的工具列表(函数调用)。
string | object
控制模型如何使用工具。选项:auto, none, required, 或特定工具对象。
boolean
默认值:"true"
是否启用并行函数调用。设置为 false 则按顺序调用函数。
integer
补全的最大 token 数。作为 max_tokens 的替代,对于启用推理的新模型系列更有用。
string
启用推理的模型的推理强度。选项:low, medium, high
integer
用于确定性采样的随机种子。
integer
默认值:"1"
要生成的补全数量(1-128)。
boolean
是否返回对数概率(log probabilities)。
integer
要返回的顶级对数概率数量(0-20)。需要 logprobs: true
integer
Top-K 采样参数(用于 Anthropic/Gemini 模型)。
object
响应格式规范。使用 {"type": "json_object"} 进入 JSON 模式。将 {"type": "json_schema", "json_schema": {...}} 视为一条基于所选模型和路由行为的尽力支持路径。
object
修改指定 token 出现的可能性。将 token ID(以字符串形式)映射到 -100 到 100 的偏差值。
string
表示您最终用户的唯一标识符,用于滥用监控。

响应

string
补全的唯一标识符。
string
始终为 chat.completion
integer
补全创建时的 Unix 时间戳。
string
用于补全的模型。
array
补全选项列表。每个选项包含:
  • index (integer): 选项的索引
  • message (object): 生成的消息
  • finish_reason (string): 模型停止的原因(stop, length, tool_calls
object
token 使用统计。
  • prompt_tokens (integer): 提示中的 token 数
  • completion_tokens (integer): 补全中的 token 数
  • total_tokens (integer): 使用的总 token 数

多模态示例