使用 DeepSeek 的 OpenAI 兼容 API 进行文本转文本生成
{
"id": "chatcmpl-abc123",
"object": "chat.completion",
"created": 1699896916,
"model": "deepseek-v3.2",
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "I am DeepSeek-V3.2, a large language model developed by DeepSeek. I'm designed to assist with a wide range of tasks including answering questions, writing content, analyzing documents, and more."
},
"finish_reason": "stop"
}
],
"usage": {
"prompt_tokens": 12,
"completion_tokens": 45,
"total_tokens": 57
}
}| 参数 | 类型 | 必填 | 默认值 | 范围 | 描述 |
|---|---|---|---|---|---|
model | string | 是 | - | - | 用于生成响应的模型 ID,例如 deepseek-v3.2。 |
messages | array | 是 | - | - | 包含当前对话的消息列表。根据您使用的模型,支持不同的消息类型(模态),如文本、图像和文件。 |
messages.role | string | 是 | - | system, user, assistant | 消息作者的角色。 |
messages.content | string / array | 是 | - | - | 消息的内容。可以是纯文本字符串,也可以是多模态内容的数组。 |
messages.content.type | string | 是 | - | text, image_url, file | 内容部分的类型。 |
messages.content.text | string | 否 | - | - | 文本内容。 |
messages.content.image_url | object | 否 | - | - | 图像 URL 内容。 |
messages.content.image_url.url | string | 否 | - | - | 图像的 URL。 |
messages.content.file | object | 否 | - | - | 用于文档分析的文件内容。 |
messages.content.file.filename | string | 否 | - | - | 文件名称。 |
messages.content.file.file_data | string | 否 | - | - | 文件的 URL。 |
| 参数 | 类型 | 必填 | 默认值 | 范围 | 描述 |
|---|---|---|---|---|---|
max_tokens | integer | 否 | - | - | 响应中生成的最大 token 数量。 |
temperature | number | 否 | 0.95 | 0.0 - 1.0 | 控制随机性。较低的值使模型更加专注和确定。 |
top_p | number | 否 | 0.7 | 0.0 - 1.0 | 核采样参数。模型考虑 top_p 概率质量的 token 结果。 |
stream | boolean | 否 | false | true, false | 是否使 用服务器发送事件逐步流式返回响应。 |
tools | array | 否 | - | - | 模型可能调用的工具列表。用于启用网络搜索或函数调用功能。 |
stop | array | 否 | - | - | 最多 4 个序列,API 将在这些序列处停止生成更多 token。 |
| 错误码 | 错误名称 | 描述 |
|---|---|---|
| 401 | Unauthorized | API key 缺失或无效 |
| 403 | Forbidden | 您的 API key 没有权限访问此资源,或请求操作的余额不足 |
| 429 | Too Many Requests | 您已超出速率限制 |
| 500 | Internal server error | 发生内部服务器错误 |
| 503 | Content policy violation | 由于安全顾虑内容被阻止(实际状态码为 400) |