StarMagicStarMagic
繁體中文
简体中文简繁體中文繁EnglishEN日本語日EspañolES한국어KO
整合指南
DeepSeek V4 - OpenAI-Compatible APIDeepSeek V4 - Anthropic-Compatible API
StarMagicStarMagic
繁體中文
简体中文简繁體中文繁EnglishEN日本語日EspañolES한국어KO
文本系列DeepSeekDeepseek.V4

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 流程
<Note> **BaseURL 说明**:默认 BaseURL 为 `https://api.starmagic.ai`,对文本模型支持更好,支持长连接;`https://api.starmagic.ai` 是多模态主力地址,对文本模型作为备用地址使用。 </Note>

授權

Authorizationstringheader必填

##所有接口均需要使用 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
modelenum<deepseek-v4-flash | deepseek-v4-pro>必填

要调用的模型 - `deepseek-v4-flash`:快速通用 - `deepseek-v4-pro`:深度推理 **提示**:两个模型 **均默认启用 thinking**,响应中始终包含 `type="thinking"` content block;如需关闭请显式 `thinking.type="disabled"`。未指定或不支持的 model 会被自动映射到 `deepseek-v4-flash`。

"deepseek-v4-flash"
max_tokensinteger必填

要生成的最大 token 数(**必填**) **说明**: - V4 系列最大可达 **384,000** - thinking 产生的 token 也计入 max_tokens 上限

1024
messagesobject[]必填

对话消息列表,按轮次 user / assistant 交替 **说明**: - 至少包含 1 条消息 - 最后一条消息通常为 `role=user` - 暂不支持 `image` / `document` 内容类型

[
  {
    "role": "user",
    "content": null
  }
]
systemobject

系统提示词,用于设定 AI 角色与行为 **说明**: - 支持字符串或字符串数组 - 不同于 OpenAI 端点的 `system` 消息,Anthropic 端点使用顶层 `system` 字段

temperaturenumber

采样温度 **说明**: - 范围 `[0.0, 2.0]` - 默认 1;值越高越发散,越低越确定

1
top_pnumber

核采样阈值 **说明**: - 范围 `[0, 1]` - 建议不要同时调整 temperature 与 top_p

1
stop_sequencesstring[]

自定义停止序列 **说明**: - 模型遇到任一字符串即停止生成 - 最多 4 条(遵循 Anthropic 规范)

[
  "string"
]
streamboolean

是否以 SSE 流式返回 - `true`:Server-Sent Events 流式返回 - `false`:完整响应后一次性返回(默认)

false
thinkingobject

思考模式控制(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
}
output_configobject

输出配置(V4 扩展) **说明**:Deepseek 仅支持 `effort` 字段

{
  "effort": "medium"
}
toolsobject[]

工具定义列表 **说明**: - 遵循 Anthropic tool 定义规范 - `input_schema` 使用 JSON Schema 对象

[
  {
    "name": "string",
    "description": "string",
    "input_schema": {}
  }
]
tool_choiceobject

控制工具调用行为 **可选 type**: - `auto`:模型自动决定(默认,当提供 tools 时) - `any`:必须调用某个工具(不指定哪个) - `tool`:必须调用指定的 `name` - `none`:禁止调用工具

{
  "type": "auto",
  "name": "string",
  "disable_parallel_tool_use": true
}

回應

application/json
成功

回應體

idstring

消息唯一 ID

"string"
typeenum<message>

响应对象类型

"message"
roleenum<assistant>
"assistant"
modelstring

实际使用的模型

"deepseek-v4-pro"
contentobject[]

响应内容块列表 **可能包含的 block type**: - `thinking`:推理过程(仅启用 thinking 时) - `text`:最终回答文本 - `tool_use`:模型发起的工具调用

[
  {
    "type": "text",
    "text": "string",
    "thinking": "string",
    "signature": "string",
    "id": "string",
    "name": "string",
    "input": {}
  }
]
stop_reasonenum<end_turn | max_tokens | stop_sequence | tool_use>

停止原因 - `end_turn`:自然结束 - `max_tokens`:达到 max_tokens 上限 - `stop_sequence`:命中 stop_sequences - `tool_use`:模型触发工具调用

"end_turn"
stop_sequencestringnull

当 stop_reason=`stop_sequence` 时命中的具体序列,否则 null

usageobject

Token 使用统计(Anthropic 规范)

{
  "input_tokens": 10,
  "output_tokens": 30,
  "cache_creation_input_tokens": 0,
  "cache_read_input_tokens": 0,
  "service_tier": "standard"
}
POST/v1/messages
curl --request POST \
  --url https://api.starmagic.ai/v1/messages \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "deepseek-v4-flash",
  "max_tokens": 1024,
  "messages": [
    {
      "role": "user",
      "content": "Hello, world"
    }
  ]
}'
回應: 成功
{
  "id": "53ee6690-e14a-4e6b-890b-a135100d51c7",
  "type": "message",
  "role": "assistant",
  "model": "deepseek-v4-flash",
  "content": [
    {
      "type": "thinking",
      "thinking": "用户问的是\"日本首都\",这是一个基础地理知识问题,答案就是东京,直接给出即可。",
      "signature": "53ee6690-e14a-4e6b-890b-a135100d51c7"
    },
    {
      "type": "text",
      "text": "日本的首都是**东京**。"
    }
  ],
  "stop_reason": "end_turn",
  "stop_sequence": null,
  "usage": {
    "input_tokens": 7,
    "cache_creation_input_tokens": 0,
    "cache_read_input_tokens": 0,
    "output_tokens": 77,
    "service_tier": "standard"
  }
}