通用对话接口(默认流式)
统一的对话 API 接口,支持通过model 参数切换不同文本模型,并兼容 OpenAI Chat Completions 请求格式。
默认情况下,本接口建议使用流式输出;如果你需要一次性返回完整结果,请在请求中显式设置 stream: false,或参考对应的非流式接口页面。
请求方式
POST /v1/chat/completions认证方式
使用 Bearer Token,在请求头中传入
Authorization: Bearer YOUR_API_KEYAuthorization
所有接口都需要使用 Bearer Token 进行认证。- API Key 是否正确
- Key 是否来自正确环境
- 请求头是否拼写正确
- 代理层是否改写了请求头
Endpoint
请求参数
必填参数
model
要使用的模型 ID。你可以替换为任意当前支持的文本模型。messages
对话消息数组。每条消息都需要包含:role:system、user或assistantcontent:消息内容
user:用户输入system:系统提示词,用于设置助手行为或角色assistant:历史回复,用于多轮上下文
常用可选参数
请求体示例
基础对话
系统提示词
多轮对话
返回结构
成功响应通常包含以下字段:成功响应示例
支持的模型列表
OpenAI 系列
gpt-5gpt-5-chat-latestgpt-5-minigpt-5-nanogpt-5-pro
Anthropic 系列
claude-haiku-4-5-20251001claude-sonnet-4-5-20250929claude-opus-4-1-20250805claude-opus-4-1-20250805-thinkingclaude-sonnet-4-5-20250929-thinking
Google 系列
gemini-2.5-flashgemini-2.5-progemini-2.5-flash-litegemini-2.5-pro-thinking
DeepSeek 系列
deepseek-v3.1-250821deepseek-v3.1-think-250821deepseek-v3-0324
Doubao 系列
doubao-seed-1-6-flash-250828doubao-seed-1-6-thinking-250715doubao-seed-1-6-251015
具体可用模型可能随供应商、版本和平台策略变化而调整,接入前建议以最新模型列表和控制台可见范围为准。
使用示例
cURL
流式输出
调用建议
- 如果你在迁移 OpenAI 客户端,优先从最小请求样例开始验证。
- 多轮对话时请自行维护历史消息,避免不必要的上下文膨胀。
- 若结果与官方网页产品不完全一致,通常与系统提示词、工具调用、上下文管理方式有关。
- 如果遇到无响应或报错,建议先检查模型名、认证头、参数格式和账户状态。