DeepSeek V4 - Anthropic 兼容接口
- 使用 Anthropic Messages 协议调用 DeepSeek V4 模型
- 支持
deepseek-v4-flash/deepseek-v4-pro - 请求 / 响应结构与 Anthropic API 对齐
- 纯文本对话(暂不支持图像 / 文档内容类型)
- 系统提示词:通过顶层
system传入 - 思考模式:
thinking对象开关;思考内容通过content[type=thinking]block 返回 - 流式输出:SSE 事件流
- 工具调用:兼容 Anthropic
tool_use/tool_result流程
授权
##所有接口均需要使用 Bearer Token 进行认证## **获取 API Key**: 访问 [API Key 管理页面](https://starmagic.ai/app/api-keys) 获取您的 API Key **使用时在请求头中添加**: ``` Authorization: Bearer YOUR_API_KEY ``` **备注**:虽然 Anthropic 原生 API 使用 `x-api-key` 头,EvoLink 对 `/v1/messages` 统一采用 Bearer Token 鉴权。
Authorization: Bearer YOUR_API_KEY请求体
application/json要调用的模型 - `deepseek-v4-flash`:快速通用 - `deepseek-v4-pro`:深度推理 **提示**:两个模型 **均默认启用 thinking**,响应中始终包含 `type="thinking"` content block;如需关闭请显式 `thinking.type="disabled"`。未指定或不支持的 model 会被自动映射到 `deepseek-v4-flash`。
"deepseek-v4-flash"要生成的最大 token 数(**必填**) **说明**: - V4 系列最大可达 **384,000** - thinking 产生的 token 也计入 max_tokens 上限
1024对话消息列表,按轮次 user / assistant 交替 **说明**: - 至少包含 1 条消息 - 最后一条消息通常为 `role=user` - 暂不支持 `image` / `document` 内容类型
[
{
"role": "user",
"content": null
}
]系统提示词,用于设定 AI 角色与行为 **说明**: - 支持字符串或字符串数组 - 不同于 OpenAI 端点的 `system` 消息,Anthropic 端点使用顶层 `system` 字段
采样温度 **说明**: - 范围 `[0.0, 2.0]` - 默认 1;值越高越发散,越低越确定
1核采样阈值 **说明**: - 范围 `[0, 1]` - 建议不要同时调整 temperature 与 top_p
1自定义停止序列 **说明**: - 模型遇到任一字符串即停止生成 - 最多 4 条(遵循 Anthropic 规范)
[
"string"
]是否以 SSE 流式返回 - `true`:Server-Sent Events 流式返回 - `false`:完整响应后一次性返回(默认)
false思考模式控制(V4) **说明**: - **两个模型均默认启用**(`type=enabled`) - 启用后响应 `content` 数组中会出现 `type="thinking"` 的推理过程 block(按输出 token 计费) - **注意**:该接口会 **忽略** Anthropic 原生的 `budget_tokens` 字段,使用 `output_config.effort` 控制深度 - 多轮对话中把上一轮响应的 thinking block 原样放回 assistant `content` 数组即可(Anthropic 协议风格更宽松,不会因为缺失 thinking 而报错,但保留 signature 有助于上下文一致性)
{
"type": "enabled",
"budget_tokens": 0
}输出配置(V4 扩展) **说明**:Deepseek 仅支持 `effort` 字段
{
"effort": "medium"
}工具定义列表 **说明**: - 遵循 Anthropic tool 定义规范 - `input_schema` 使用 JSON Schema 对象
[
{
"name": "string",
"description": "string",
"input_schema": {}
}
]控制工具调用行为 **可选 type**: - `auto`:模型自动决定(默认,当提供 tools 时) - `any`:必须调用某个工具(不指定哪个) - `tool`:必须调用指定的 `name` - `none`:禁止调用工具
{
"type": "auto",
"name": "string",
"disable_parallel_tool_use": true
}响应
application/json响应体
消息唯一 ID
"string"响应对象类型
"message""assistant"实际使用的模型
"deepseek-v4-pro"响应内容块列表 **可能包含的 block type**: - `thinking`:推理过程(仅启用 thinking 时) - `text`:最终回答文本 - `tool_use`:模型发起的工具调用
[
{
"type": "text",
"text": "string",
"thinking": "string",
"signature": "string",
"id": "string",
"name": "string",
"input": {}
}
]停止原因 - `end_turn`:自然结束 - `max_tokens`:达到 max_tokens 上限 - `stop_sequence`:命中 stop_sequences - `tool_use`:模型触发工具调用
"end_turn"当 stop_reason=`stop_sequence` 时命中的具体序列,否则 null
Token 使用统计(Anthropic 规范)
{
"input_tokens": 10,
"output_tokens": 30,
"cache_creation_input_tokens": 0,
"cache_read_input_tokens": 0,
"service_tier": "standard"
}
