跳到主要内容

ChatCompletions格式

根据对话历史创建模型响应。支持流式和非流式响应。

兼容 OpenAI Chat Completions API。

Try It

POST/v1/chat/completionshttps://api-platform.ope.ai

认证

使用 Bearer Token 认证。

  • Header:Authorization: Bearer <token>
  • 示例:Authorization: Bearer sk-xxxxxx

请求体(application/json)

以下字段以兼容 OpenAI Chat Completions API 为参考;你可以按 OPEAI Platform 实际支持范围进行删减/扩展。

字段类型必填说明默认值 / 范围
modelstring模型 ID-
messagesarray<object>对话消息列表-
temperaturenumber采样温度默认 1;范围 0~2
top_pnumber核采样参数默认 1;范围 0~1
ninteger生成数量默认 1;范围 >=1
streamboolean是否流式响应默认 false
stream_optionsobject流式参数-
stopstring | array<string>停止序列-
max_tokensinteger最大生成 Token 数-
max_completion_tokensinteger最大补全 Token 数-
presence_penaltynumber话题惩罚默认 0;范围 -2~2
frequency_penaltynumber频率惩罚默认 0;范围 -2~2
logit_biasobjectLogit 偏置-
userstring终端用户标识-
toolsarray<object>工具列表-
tool_choicestring | object工具选择策略-
response_formatobject响应格式-
seedinteger随机种子-
reasoning_effort"low" | "medium" | "high"推理强度(用于支持推理的模型)-
modalitiesarray<string>输出模态-
audioobject音频输出配置-

请求示例

下方域名为示例:https://api-platform.ope.ai

curl -X POST "https://api-platform.ope.ai/v1/chat/completions" \
-H "Authorization: Bearer $OPEAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "DeepSeek-V3.2",
"messages": [
{
"role": "user",
"content": "hello"
}
]
}'

响应示例

{
"id": "string",
"object": "chat.completion",
"created": 0,
"model": "string",
"choices": [
{
"index": 0,
"message": {
"role": "system",
"content": "string",
"name": "string",
"tool_calls": [
{
"id": "string",
"type": "function",
"function": { "name": "string", "arguments": "string" }
}
],
"tool_call_id": "string",
"reasoning_content": "string"
},
"finish_reason": "stop"
}
],
"usage": {
"prompt_tokens": 0,
"completion_tokens": 0,
"total_tokens": 0,
"prompt_tokens_details": {
"cached_tokens": 0,
"text_tokens": 0,
"audio_tokens": 0,
"image_tokens": 0
},
"completion_tokens_details": {
"text_tokens": 0,
"audio_tokens": 0,
"reasoning_tokens": 0
}
},
"system_fingerprint": "string"
}