RequestBeam

文档目录

RequestBeam 文档

DeepSeek 模型

DeepSeek V4 Flash、V4 Pro 和 V4.1 Flash 的模型 ID 与 Chat Completions 可用范围。

POSThttps://api.requestbeam.com/v1/chat-completions

DeepSeek 模型通过通用 Chat Completions 接口调用。切换型号时只需 修改请求体中的 model,不需要更换接口或认证方式。

text
POST https://api.requestbeam.com/v1/chat-completions

可用模型

model 值定位非流式SSE 流式
deepseek-v4-flashFlash 型号,适合作为日常对话和批量任务的评估起点支持支持
deepseek-v4-proPro 型号,适合优先评估复杂推理和高质量输出的任务支持支持
deepseek-v4.1-flashDeepSeek V4.1 Flash,独立模型 ID,不是 V4 Flash 的别名部署启用后可用部署启用后可用

V4.1 Flash 仅在路由配置部署并启用后可用。请先确认当前 API Key 的 GET https://api.requestbeam.com/v1/models 返回 deepseek-v4.1-flash,再发起请求。此参考条目不表示 生产环境已上线,也不代表已完成成功的推理实测。原有 V4 Flash 和 V4 Pro ID 保持不变。

上面的定位用于帮助选择首个测试型号,不构成延迟、吞吐量或质量 SLA。正式接入前, 请使用自己的提示词、输出长度和并发量对可用模型做对比。

验证

http
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

非流式请求

接口默认一次性返回完整的 Chat Completions 响应。示例显式写出 stream: false,便于复制后确认行为。

json
{
  "model": "deepseek-v4-flash",
  "messages": [
    {
      "role": "system",
      "content": "你是一名严谨的技术助手。"
    },
    {
      "role": "user",
      "content": "用三点说明事件驱动架构的优点。"
    }
  ],
  "stream": false
}

切换到 Pro 型号时,只需改为:

json
{
  "model": "deepseek-v4-pro"
}

流式请求

需要流式输出时必须显式设置 stream: true,并按 SSE 逐事件读取响应,直到 收到 [DONE]。

json
{
  "model": "deepseek-v4-pro",
  "messages": [
    {
      "role": "user",
      "content": "设计一个可回滚的数据库迁移检查清单。"
    }
  ],
  "stream": true
}

请求字段

modelstring必填

使用 GET https://api.requestbeam.com/v1/models 返回的 deepseek-v4-flash、deepseek-v4-pro 或 deepseek-v4.1-flash。

messagesobject[]必填

OpenAI Chat Completions 风格的消息数组。每条消息包含 role 和 content。

streamboolean默认: false

true 返回 SSE,false 返回完整 JSON。

max_tokensinteger

可选的最大输出 token 数,使用正整数。省略时使用所选模型的上游默认额度。 不同模型的额度可能同时包含推理 token 和最终正文;较小额度可能导致回答 截断,或在生成正文前耗尽。提高额度可能增加费用。

max_completion_tokensinteger

max_tokens 的可选兼容字段,适用相同的额度注意事项。具体支持情况由所选 模型判断;省略这两个字段时使用上游默认额度。

temperature、top_p、frequency_penalty、presence_penalty、stop 和 n 等通用字段见通用对话接口。 字段支持情况和具体语义效果可能因型号而异;此文档不表示 V4.1 Flash 已验证支持所有可选字段。

成功响应

json
{
  "id": "chatcmpl_...",
  "object": "chat.completion",
  "created": 1787200000,
  "model": "deepseek-v4-flash",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "1. 服务之间可以松耦合..."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 31,
    "completion_tokens": 96,
    "total_tokens": 127
  }
}

响应可能包含额外的 usage 明细;客户端应兼容这些字段缺失或随模型变化,不要把 可选明细作为请求成功的唯一判断条件。

使用建议

  • 当前公开合同是 Chat Completions,包括非流式和 SSE 流式。
  • 这些模型当前不通过 OpenAI Responses 或 Claude Messages 提供。
  • 请求体中的 model 使用精确 ID:deepseek-v4-flash、deepseek-v4-pro 或 deepseek-v4.1-flash。
  • 只使用 GET https://api.requestbeam.com/v1/models 返回的模型 ID。
  • 可用范围和实时价格以当前 API Key 的 GET https://api.requestbeam.com/v1/models 返回结果及控制台为准。