API 接口聊天接口OpenAI
ChatCompletions 格式
OpenAI 兼容的对话补全接口:端点、鉴权与请求示例
最后更新于:
OpenAI 兼容格式的对话补全接口。
POST /v1/chat/completions
鉴权
Bearer Token:API Key 在控制台「令牌管理」获取,放在请求头 Authorization。
请求
Content-Type: application/json
export AICENTOS_API_KEY="sk-your-aicentos-api-key"
curl -X POST "https://aicentos.com/v1/chat/completions" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $AICENTOS_API_KEY" \
-d '{
"model": "gpt-4o-mini",
"messages": [
{ "role": "user", "content": "用一句话介绍你自己" }
]
}'除 model 与 messages 外,其余参数与 OpenAI 官方一致(temperature、stream、tools 等),原样传入即可。
响应
返回 OpenAI 标准结构,回复取 choices[0].message.content,用量在 usage:
{
"id": "chatcmpl-abc123",
"object": "chat.completion",
"model": "gpt-4o-mini",
"choices": [
{
"index": 0,
"message": { "role": "assistant", "content": "我是 aicentos。" },
"finish_reason": "stop"
}
],
"usage": { "prompt_tokens": 21, "completion_tokens": 9, "total_tokens": 30 }
}鉴权失败时返回 invalid_api_key 错误,排查方法见错误处理:
{
"error": {
"message": "Incorrect API key provided",
"type": "authentication_error",
"code": "invalid_api_key"
}
}