对话补全(Chat Completions)

创建对话补全

POST
/v1/chat/completions

根据对话历史创建模型响应,兼容 OpenAI Chat Completions。支持流式(stream: true,SSE)、函数调用(tools)和图片输入。

线上实测:deepseek-v3.2 支持对话、流式和函数调用;qwen3.7-flash 支持图片理解(示例里请加 enable_thinking: false)。可用模型以 GET /v1/models 为准。

鉴权

BearerAuth
header鉴权Bearer <令牌>

使用令牌(API Key)认证。 格式:Authorization: Bearer sk-xxxxxx。令牌在控制台「API 密钥」页创建。

请求体

application/json
  1. body
model*string

模型 ID

messages*array<>

对话消息列表

temperature?number

采样温度

范围0 <= value <= 2
默认值1
top_p?number

核采样参数

范围0 <= value <= 1
默认值1
n?integer

生成数量

范围1 <= value
默认值1
stream?boolean

是否流式响应

默认值false
stream_options?
stop?|array<string>

停止序列

max_tokens?integer

最大生成 Token 数

max_completion_tokens?integer

最大补全 Token 数

presence_penalty?number
范围-2 <= value <= 2
默认值0
frequency_penalty?number
范围-2 <= value <= 2
默认值0
logit_bias?
user?string
tools?array<>
tool_choice?|
response_format?
seed?integer
reasoning_effort?string

推理强度 (用于支持推理的模型)

可选值"low""medium""high"
modalities?array<>
audio?

响应体

成功创建响应

application/json
  1. response
id?string
object?string
created?integer
model?string
choices?array<>
usage?
system_fingerprint?string
curl -X POST "https://ai.athandra.com/v1/chat/completions" \  -H "Content-Type: application/json" \  -d '{    "model": "deepseek-v3.2",    "messages": [      {        "role": "user",        "content": "用一句话介绍你自己"      }    ]  }'
{  "id": "chatcmpl-2dae0f9d-c174-9590-aebc-de8398e9a09a",  "object": "chat.completion",  "created": 1791367078,  "model": "deepseek-v3.2",  "choices": [    {      "index": 0,      "message": {        "role": "assistant",        "content": "你好!我是 DeepSeek,由深度求索公司创造的 AI 助手。"      },      "finish_reason": "stop"    }  ],  "usage": {    "prompt_tokens": 8,    "completion_tokens": 19,    "total_tokens": 27  }}