Skip to main content

通用对话接口(默认流式)

统一的对话 API 接口,支持通过 model 参数切换不同文本模型,并兼容 OpenAI Chat Completions 请求格式。
默认情况下,本接口建议使用流式输出;如果你需要一次性返回完整结果,请在请求中显式设置 stream: false,或参考对应的非流式接口页面。

请求方式

POST /v1/chat/completions

认证方式

使用 Bearer Token,在请求头中传入 Authorization: Bearer YOUR_API_KEY

Authorization

所有接口都需要使用 Bearer Token 进行认证。
如果请求直接返回认证错误,请优先检查:
  • API Key 是否正确
  • Key 是否来自正确环境
  • 请求头是否拼写正确
  • 代理层是否改写了请求头

Endpoint

请求参数

必填参数

model

要使用的模型 ID。你可以替换为任意当前支持的文本模型。

messages

对话消息数组。每条消息都需要包含:
  • role:system、user 或 assistant
  • content:消息内容
角色说明:
  • user:用户输入
  • system:系统提示词,用于设置助手行为或角色
  • assistant:历史回复,用于多轮上下文

常用可选参数

请求体示例

基础对话

系统提示词

多轮对话

返回结构

成功响应通常包含以下字段:

成功响应示例

支持的模型列表

OpenAI 系列

  • gpt-5
  • gpt-5-chat-latest
  • gpt-5-mini
  • gpt-5-nano
  • gpt-5-pro

Anthropic 系列

  • claude-haiku-4-5-20251001
  • claude-sonnet-4-5-20250929
  • claude-opus-4-1-20250805
  • claude-opus-4-1-20250805-thinking
  • claude-sonnet-4-5-20250929-thinking

Google 系列

  • gemini-2.5-flash
  • gemini-2.5-pro
  • gemini-2.5-flash-lite
  • gemini-2.5-pro-thinking

DeepSeek 系列

  • deepseek-v3.1-250821
  • deepseek-v3.1-think-250821
  • deepseek-v3-0324

Doubao 系列

  • doubao-seed-1-6-flash-250828
  • doubao-seed-1-6-thinking-250715
  • doubao-seed-1-6-251015
具体可用模型可能随供应商、版本和平台策略变化而调整,接入前建议以最新模型列表和控制台可见范围为准。

使用示例

cURL

流式输出

调用建议

  • 如果你在迁移 OpenAI 客户端,优先从最小请求样例开始验证。
  • 多轮对话时请自行维护历史消息,避免不必要的上下文膨胀。
  • 若结果与官方网页产品不完全一致,通常与系统提示词、工具调用、上下文管理方式有关。
  • 如果遇到无响应或报错,建议先检查模型名、认证头、参数格式和账户状态。