文本生成
Chat Completions
使用 Chat Completions 接口,根据消息上下文生成模型回复。该接口兼容 OpenAI Chat Completions 格式。
#
Chat Completions 通过由角色和内容组成的消息列表与模型交互,适用于对话、问答、摘要和文本创作等场景。
请通过控制台创建 AccessKey,并在请求头中携带有效的 API Key。
请求地址 #
POSThttps://{domain}.com/v1/chat/completions
认证方式 #
所有 API 请求均需在 HTTP 请求头中通过 Bearer Token 进行认证。
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
请求参数 #
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
model |
string | 是 | 要调用的模型 ID,例如 gpt-4o-mini。 |
messages |
array | 是 | 构成当前对话的消息列表。 |
temperature |
number | 否 | 采样温度,取值范围为 0 到 2,默认 1。 |
stream |
boolean | 否 | 是否启用流式输出,默认 false。 |
请求示例 #
cURL
curl https://{domain}.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"gpt-4o-mini","messages":[{"role":"user","content":"介绍一下你自己"}],"temperature":0.7}'
响应示例 #
{
"id": "chatcmpl-abc123",
"object": "chat.completion",
"choices": [{ "message": { "role": "assistant", "content": "你好!我是 AI 助手。" } }]
}
错误码 #
| 状态码 | 说明 |
|---|---|
| 401 | API Key 无效或未提供认证信息。 |
| 429 | 请求超出当前账户的速率限制。 |
| 500 | 服务端内部错误,请稍后重试。 |