RequestBeam

文档目录

RequestBeam 文档

模型目录

查询当前 API Key 可调用的模型,并查看各模型支持的公开协议。

GEThttps://api.requestbeam.com/v1/models

GET https://api.requestbeam.com/v1/models 返回当前 API Key 可以调用的模型。模型可用范围会随模型配置、 服务状态和 API Key 权限变化,因此实时接口返回值是最终依据。

text
GET https://api.requestbeam.com/v1/models

验证

所有请求都需要使用 Bearer Token。

http
Authorization: Bearer YOUR_API_KEY

请求示例

bash
curl --request GET \
  --url https://api.requestbeam.com/v1/models \
  --header 'Authorization: Bearer YOUR_API_KEY'

Response

uidstring

对外使用的模型标识符。接口接受 model 时,将该值填入请求体的 model 字段。

namestring

模型显示名称。

versionstring | null

版本字段。当前条目通常返回 null。

typestring

模型类型,当前主要为 text、image 或 video。

pricingobject | null

当前模型的平台价格配置。具体价格以接口和控制台实时展示为准。

成功响应示例

json
{
  "success": true,
  "data": [
    {
      "uid": "gpt-5.6-sol",
      "name": "ChatGPT-5.6 Sol",
      "version": null,
      "type": "text",
      "pricing": {
        "unit": "credits",
        "tokenTierBasis": "input_tokens",
        "tiers": []
      }
    },
    {
      "uid": "seedance-2.5",
      "name": "Seedance 2.5",
      "version": null,
      "type": "video",
      "pricing": {
        "unit": "credits",
        "tiers": []
      }
    }
  ],
  "requestId": "req_..."
}

当前文本模型

下面汇总当前文档列出的文本模型。调用时仍应以你的 GET https://api.requestbeam.com/v1/models 返回结果 为准。

模型族模型 IDChat CompletionsResponsesClaude Messages
OpenAIgpt-5.4支持支持-
OpenAIgpt-5.5支持支持-
OpenAIgpt-5.6-sol支持支持-
OpenAIgpt-5.6-terra支持支持-
OpenAIgpt-6-astra支持支持-
Anthropicclaude-fable-5支持-支持
Anthropicclaude-fable-5-1支持-支持
Anthropicclaude-haiku-4-5支持-支持
Anthropicclaude-opus-4-5支持-支持
Anthropicclaude-opus-4-6支持-支持
Anthropicclaude-opus-4-7支持-支持
Anthropicclaude-opus-4-8支持-支持
Anthropicclaude-opus-5支持-支持
Anthropicclaude-opus-5-5支持-支持
Anthropicclaude-sonnet-4-5支持-支持
Anthropicclaude-sonnet-4-6支持-支持
Anthropicclaude-sonnet-5支持-支持
DeepSeekdeepseek-v4-flash支持--
DeepSeekdeepseek-v4-pro支持--
DeepSeekdeepseek-v4.1-flash部署启用后可用--
Geminigemini-3.6-flash支持--
Geminigemini-3.7-flash支持--
Geminigemini-3.8-flash支持--
Geminigemini-3.5-flash-lite支持--
Kimikimi-k3支持--
MiniMaxminimax-m3支持--

Claude 的输出预算包含 thinking 和最终正文。较小的 max_tokens(如 128)可能在 产生正文之前耗尽;请求应使用正整数预算,并为 thinking 和正文留出空间,详见 Claude Messages。

模型族文档

  • DeepSeek 模型:deepseek-v4-flash、deepseek-v4-pro、deepseek-v4.1-flash(独立 ID,部署启用后才可用,以 GET https://api.requestbeam.com/v1/models 为准)
  • Gemini 模型:gemini-3.6-flash、gemini-3.7-flash、gemini-3.8-flash、gemini-3.5-flash-lite
  • Kimi 模型:kimi-k3
  • MiniMax 模型:minimax-m3

这些页面记录各模型族的选择建议、请求示例、输出预算注意事项和当前公开协议 边界。实时可用范围仍以本接口返回值为准。

当前图片和视频模型

模型族模型 ID类型公开接口
OpenAIgpt-image-2图片POST https://api.requestbeam.com/openai/v1/images/generations
OpenAIgpt-image-2.5-flare图片POST https://api.requestbeam.com/openai/v1/images/generations
OpenAIgpt-image-2.5-sunburst图片POST https://api.requestbeam.com/openai/v1/images/generations
BytePlusseedance-2.0视频POST https://api.requestbeam.com/v1/video/seedance
BytePlusseedance-2.5视频POST https://api.requestbeam.com/v1/video/seedance

其他 API 条目

twitterapi 代表 Twitter 数据接口,不是 Chat 模型。调用 Twitter 能力时使用 /v1/twitter/* 接口,不要把 twitterapi 传给 Chat Completions。

模型 ID 使用规则

  • Chat Completions、Responses、Claude Messages、图片和 Seedance 视频接口都使用

model 字段。

  • Seedance 视频接口的合法 model 值仅为 seedance-2.0 和 seedance-2.5。
  • 只使用 GET https://api.requestbeam.com/v1/models 返回的模型 ID。
  • 不可用模型不会出现在 /v1/models,也不应继续用于新请求。
  • API Key 配置了模型权限时,返回列表可能是上述文档模型的子集。

失败响应

完整错误码、协议差异和排查步骤见错误码与错误处理。

json
{
  "success": false,
  "error": {
    "code": 20000,
    "message": "Invalid or missing API key"
  },
  "requestId": "req_..."
}