DeepSeek V4 Pro
deepseek-v4-pro- DeepSeek
- 语言
通过兼容 OpenAI 的对话接口进行对话与推理。
概览
- 模型开发者
- DeepSeek
- 支持的协议
openaianthropicopenai-response
调用这个模型
创建 API Key、充值账户余额,并在调用前确认密钥有权访问这个模型。
复制此模型的完整接口文档,包含全部已公布协议,供 AI 助手读取。
/v1/chat/completions请求参数
| 参数 | 必填 | 类型 | 说明 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
model | 必填 | string | 使用此处公布的完整模型 ID。 约束
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
messages | 必填 | object[] | 按顺序发送对话历史。 约束
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
仅在提供 messages 时适用;子字段必填不代表可选的父字段也必填。
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
thinking | 可选 | object | 开启或关闭思考模式。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
仅在提供 thinking 时适用;子字段必填不代表可选的父字段也必填。
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
reasoning_effort | 可选 | string | 选择推理强度;none 会关闭思考。
约束
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
max_tokens | 可选 | integer | 最大生成 token 数;输入与输出总量还需符合模型上下文限制。 约束
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
stream | 可选 | boolean | 接收增量服务器发送事件。
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
stream_options | 可选 | object | 流式选项;需同时设置 stream=true。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
仅在提供 stream_options 时适用;子字段必填不代表可选的父字段也必填。
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
temperature | 可选 | number | 采样随机性;启用思考时会被忽略。
约束
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
top_p | 可选 | number | 思考模式中的采样阈值;非思考模式会忽略此值。
约束
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
stop | 可选 | string | string[] | 遇到任意指定序列时停止生成。 约束
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
response_format | 可选 | object | 选择普通文本或 JSON 对象输出。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
仅在提供 response_format 时适用;子字段必填不代表可选的父字段也必填。
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
tools | 可选 | object[] | 声明模型可请求的函数;函数由你的应用执行。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
仅在提供 tools 时适用;子字段必填不代表可选的父字段也必填。
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
tool_choice | 可选 | string | object | 允许、禁用、要求或指定函数调用。 约束
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
logprobs | 可选 | boolean | 返回生成文本的对数概率。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
top_logprobs | 可选 | integer | 返回候选 token 概率的数量;需设置 logprobs=true。 约束
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
调用注意事项
- 使用 Scenepond Bearer API 密钥和 Scenepond 基础 URL,无需提供方密钥。
- 默认启用思考。temperature 在思考模式中无效,top_p 在非思考模式中无效。
- 省略 max_tokens 时,提供方在非思考模式下默认使用 8192,思考模式下使用 65536,max 推理强度下使用 131072。
- JSON 对象输出还需在提示词中要求生成 JSON。请检查 finish_reason,避免把截断输出当作完整 JSON。
- 使用 required 或指定函数的 tool_choice 时,需关闭思考。执行工具前请校验函数参数。
- 延续思考模式的工具调用时,保留 assistant 的 tool_calls、reasoning_content 及对应工具回复。
- Chat 流式响应以 [DONE] 结束。提供方返回最终 token 用量,网关可能统一用量分片的发送方式。
- stream 为 false 时,网关会移除 stream_options;在支持的渠道上也可能自动请求用量。
- frequency_penalty 和 presence_penalty 已不影响原生 DeepSeek 输出。不要把 seed、n 或 max_completion_tokens 当作已支持的 DeepSeek 控制参数。
- 提供方文档列有 user_id,但当前网关 Chat DTO 不会保留该字段。额外的未文档化字段不保证会传至提供方。
- 助手前缀补全和严格工具模式属于提供方 Beta 功能,此标准 Chat 端点尚未验证其 Beta 路由。
- 此模型参考说明涵盖文本输入。图片输入见 DeepSeek Flash 文档,不应推断 DeepSeek V4 Pro 也支持。
最小调用
1curl --fail-with-body -X POST "https://scenepond-api-production.up.railway.app/v1/chat/completions" \
2 -H "Authorization: Bearer $SCENEPOND_API_KEY" \
3 -H "Content-Type: application/json" \
4 --data-binary @- <<'JSON'
5{
6 "model": "deepseek-v4-pro",
7 "messages": [
8 {
9 "role": "user",
10 "content": "Hello"
11 }
12 ]
13}
14JSON在已安装 cURL 的终端中执行此示例,执行前先设置 SCENEPOND_API_KEY。
响应示例
响应示例仅展示结构;ID、URL 和数值为占位内容。
已完成的聊天响应
1{
2 "id": "chatcmpl_example",
3 "object": "chat.completion",
4 "created": 1790812800,
5 "model": "deepseek-v4-pro",
6 "choices": [
7 {
8 "index": 0,
9 "message": {
10 "role": "assistant",
11 "content": "Hello! How can I help?"
12 },
13 "finish_reason": "stop"
14 }
15 ],
16 "usage": {
17 "prompt_tokens": 8,
18 "completion_tokens": 9,
19 "total_tokens": 17
20 }
21}Chat 流式文本分片
1{
2 "id": "chatcmpl_example",
3 "object": "chat.completion.chunk",
4 "created": 1790812800,
5 "model": "deepseek-v4-pro",
6 "choices": [
7 {
8 "index": 0,
9 "delta": {
10 "content": "Hello"
11 },
12 "finish_reason": null
13 }
14 ]
15}接入你的应用
将已启用的聊天模型接入 Hermes Agent、OpenClaw 或 DeepSeek Harness。工具调用、图片输入与推理能力取决于模型和已配置协议。
Hermes Agent
让 Scenepond 为你的 Hermes 智能体提供模型 API。
智能体运行环境配置指南OpenClaw
通过自定义供应商,为个人助手接入已启用的模型。
个人助手配置指南DeepSeek Harness
将 Scenepond 配置为自定义模型 API,用于编程与代码仓库任务。
编程智能体配置指南模型访问权限和请求限制取决于账户、API Key 与服务配置。