DeepSeek
左侧为章节切换,右侧为对应内容。
| 字段名 | 类型 | 必填 | 说明 |
|---|---|---|---|
X-AI-App-Id |
string | 是 | 会员中心「我的应用」中展示的应用 ID。 |
X-AI-App-Secret |
string | 是 | 该应用的密钥 secret_key,与会员中心展示一致;服务端会做安全校验。 |
对接 HTTP 接口请使用上表请求头;站内网页另有兼容方式,不在此列出。
非流式与流式使用同一请求体结构;流式请使用 …/v1/chat/stream 路径。
多轮与上下文:网关按当次请求里的 messages 原样交给上游模型,接口不会替你「记住」上一轮正文。续聊须由客户端在 body 中组装完整历史(含此前的 user / assistant 等)。
| 字段名 | 类型 | 必填 | 说明 |
|---|---|---|---|
model_id |
int | 是 | 模型主键;本页文档对应 `model_id=3`。 |
messages |
array | 是 | 消息对象数组(见 messages[])。至少一条;多轮时须在数组内按顺序包含完整历史(user/assistant/system 等)。网关按本次列表调用上游,不自动补全缺省轮次。 |
temperature |
number | 否 | 采样温度,默认 0.7;是否生效取决于具体模型。 |
max_tokens |
int 或 null | 否 | 生成长度上限(token);null 表示使用网关/上游默认。 |
stream |
bool | 否 | 请求体字段,默认 false。**是否流式由 URL 决定**:流式请 POST `/v1/chat/stream`;`/v1/chat` 为非流式。勿仅靠本字段切换 SSE。 |
attachments |
array | 否 | 附件数组,默认 [](见 attachments[])。网关会把附件整理为上游可识别的上下文(如追加 system 说明 URL 列表)。 |
extra |
object | 否 | 任意 JSON 对象,默认 {}。模型专有参数放于此(如数字人 image_url/audio_url/parameters;文生图/视频类 prompt、尺寸等)。服务端可能合并内部保留字段;请勿使用以下划线 `_` 开头的键名作为业务自定义字段。 |
数组顺序即对话顺序;多轮时把历史轮次一并列入本数组即可。
| 字段名 | 类型 | 必填 | 说明 |
|---|---|---|---|
role |
string | 是 | 角色:如 user、assistant、system 等,与上游 Chat Completions 约定一致。 |
content |
string | 是 | 该轮文本内容。多轮时 assistant 一般为上一轮模型输出,由客户端保存后在后续请求的 messages 中写回。 |
images |
array 或 null | 否 | 历史消息中的多模态图片结构,会话回放用;元素为对象,字段因上游而异。 |
audios |
array 或 null | 否 | 历史消息中的音频结构,会话回放用。 |
| 字段名 | 类型 | 必填 | 说明 |
|---|---|---|---|
url |
string | 是 | 附件可访问 URL(须能被上游或网关拉取)。 |
filename |
string 或 null | 否 | 原始文件名,便于展示或日志。 |
mime |
string 或 null | 否 | MIME 类型,如 image/png。 |
extra |
object | 否 | 附件级扩展信息,默认 {}。 |
标准 **OpenAI Chat Completions** 形态:`messages`、`temperature`、`max_tokens`、`stream` 等为网关通用字段。**`extra` 中的键会合并进上游请求 JSON 顶层**(与 `OpenAICompatClient._payload` 一致)。**`enable_thinking`**:若请求体未带该键,`model_3` 默认 **`true`**(思考模式);可在 **`extra.enable_thinking`** 显式传 **false** 关闭。**`reasoning_effort`**:放在 **`extra.reasoning_effort`**,合法归一后为 **`high`** 或 **`max`**;`low`/`medium` 会映射为 `high`,`xhigh` 映射为 `max`,其它值会被丢弃。流式(`stream: true`)时网关会设置 **`stream_options.include_usage: true`** 以便计费取 `usage`。上游 **`model`**(如 `deepseek-v4-pro`)由服务端配置,请求体中的 `model_id` 用于路由即可。
下列说明与下方「调用示例」JSON 对齐,由本站配置维护。
| 字段名 | 类型 | 必填 | 说明 |
|---|---|---|---|
model_id |
int | 是 | 须为 `3`,与本页模型编号一致。 |
messages |
array | 是 | 对话消息数组;与通用 Chat 接口一致。 |
temperature |
number | 否 | 采样温度,默认 0.7。 |
max_tokens |
int 或 null | 否 | 生成长度上限;null 表示上游默认。 |
stream |
bool | 否 | 是否流式;流式请使用 **`POST /v1/chat/stream`**。思考模型流式时增量里可出现 `reasoning_content` 与 `content`(见百炼 DeepSeek 文档)。 |
extra.enable_thinking |
bool | 否 | 是否开启思考模式;未传时网关侧默认 **true**。 |
extra.reasoning_effort |
string | 否 | 推理强度:归一后为 **`high`** 或 **`max`**;`low`/`medium`→`high`,`xhigh`→`max`。 |