跳到主要内容

选择模型

调用 API 前,需要先确定要使用的模型,并复制模型的准确 ID。模型 ID 会填写在请求的 model 参数中,名称不正确或当前 API 密钥无法访问该模型时,请求将会失败。

打开模型广场

打开 Bita API,点击顶部导航栏中的「模型广场」。模型广场会展示当前站点已经启用的模型,以及模型价格、分组、供应商和支持的端点类型。

Bita API 模型广场

页面标题下方会显示当前启用的模型总数。这个数字会随站点模型配置变化,不代表每个 API 密钥都能调用全部模型。

搜索和筛选模型

模型数量较多时,可以使用页面顶部的搜索框和左侧筛选栏缩小范围。

搜索框

搜索框支持按模型名称、供应商、端点或标签查找模型。已经知道模型 ID 的一部分时,直接输入关键词通常最快。

分组

选择与 API 密钥相同的分组,例如 defaultclaude-origingpt-origin。分组名称旁会同时显示对应倍率。

这是选择模型时最重要的筛选条件。即使模型出现在「所有分组」中,也需要确认它在当前 API 密钥所属分组下仍然可用。

供应商

按模型供应商筛选,例如 OpenAI、Anthropic 等。供应商右侧的数字表示当前筛选条件下的模型数量。

供应商用于帮助查找模型,不等同于 API 请求必须使用的接口格式。

模型标签

标签用于按模型特性进一步筛选。可用标签由站点配置,具体以页面展示为准。

定价类型

  • 按量计费:根据输入、输出 Token 或其他实际用量计费。
  • 按次计费:每次成功调用按固定规则计费。

端点类型

端点类型表示模型支持的 API 接口能力,例如:

  • Chat:对话补全接口
  • Response:Responses 接口
  • Anthropic:Anthropic Messages 兼容接口
  • Gemini:Gemini 兼容接口
  • 图片、嵌入、视频等其他专项接口

首次发送文本请求时,可以优先筛选 Chat 类型。

点击筛选栏顶部的「重置」,可以清除已经选择的筛选条件。

调整结果显示

模型列表上方提供以下显示控制:

  • 切换价格展示口径,例如「标准」或「充值」。
  • 将价格单位切换为 /1M/1K,方便按每百万或每千 Token 比较价格。
  • 按模型名称排序。
  • 在卡片和列表视图之间切换。

这些选项主要改变价格和列表的展示方式,不会改变 API 密钥所属分组。

阅读模型卡片

每张模型卡片包含选择模型时需要的主要信息:

卡片位置内容
顶部模型 ID、供应商图标、详情按钮和复制按钮
价格区域输入、输出以及缓存等价格
左下角当前分组和定价类型
右下角支持的端点、上下文长度或其他标签

模型名称过长时,卡片可能只显示部分内容。此时可以点击「详情」查看完整信息,或点击模型名称右侧的复制按钮复制完整模型 ID。

查找模型时,重点确认以下内容:

项目需要确认的内容
模型 IDAPI 请求中 model 参数需要填写的准确名称
模型能力是否支持对话、推理、图片理解、工具调用等所需能力
接口格式使用 OpenAI、Anthropic 还是 Gemini 兼容接口
可用分组当前 API 密钥所属分组能否访问该模型
模型价格输入、输出及其他计费项目的价格

模型 ID

模型 ID 是 API 识别模型的唯一名称。调用接口时,应完整复制页面展示的模型 ID,不要自行缩写、翻译或修改大小写。

例如,请求体中的模型参数格式如下:

{
"model": "模型 ID"
}
不要填写模型的展示名称

页面上的中文说明、供应商名称或模型系列名称不一定是可以调用的模型 ID。应使用模型页面提供的可复制 ID。

模型与 API 密钥分组

API 密钥只能调用其所属分组中可用的模型。因此,选择模型时必须同时核对模型和 API 密钥的分组。

例如,你创建密钥时可以看到 defaultclaude-origingpt-origin 等分组。每个分组可能对应不同的模型渠道、可用模型和计费倍率。

选择顺序建议如下:

  1. 确定准备使用的模型或第三方工具。
  2. 查看该模型支持哪些分组。
  3. 使用对应分组创建 API 密钥。
  4. 复制该分组下展示的准确模型 ID。

如果现有 API 密钥的分组不支持目标模型,建议为目标分组单独创建一枚密钥。分组的详细说明参见创建 API 密钥:分组

选择接口格式

Bita API 可以通过不同的兼容接口访问模型。选择哪种格式,通常取决于模型类型和你使用的客户端或 SDK。

接口格式常见使用场景
OpenAI 兼容格式OpenAI SDK、通用聊天客户端以及大多数支持自定义 Base URL 的工具
Anthropic 兼容格式Claude Code、Anthropic SDK 或明确要求 Anthropic Messages 接口的工具
Gemini 兼容格式Google Gen AI SDK 或明确要求 Gemini 原生接口的应用

第三方工具有明确接入要求时,应优先使用该工具文档指定的接口格式、分组和模型 ID。

模型来源不等于接口格式

模型名称中包含 claudegpt 或其他供应商名称,不代表只能使用同名 SDK。最终应以 Bita API 模型页面和对应接入文档标注的兼容接口为准。

查看模型价格

模型通常会分别显示输入价格和输出价格:

  • 输入价格:发送给模型的文字、上下文或其他输入内容产生的费用。
  • 输出价格:模型生成回复产生的费用。
  • 其他价格:部分模型可能单独计算缓存、图片、音频或按次调用费用。

实际消耗还会受到 API 密钥分组倍率影响。可以用下面的简化关系理解:

实际消耗 = 模型基础消耗 × 分组倍率

比较价格时,应同时查看模型自身价格和当前分组倍率,不能只比较分组倍率。

如何选择第一个模型

首次接入时,建议按以下方式选择:

  1. 在左侧选择与 API 密钥相同的分组。
  2. 在「端点类型」中选择 Chat,筛选支持文本对话的模型。
  3. 使用搜索框或供应商筛选找到准备测试的模型。
  4. 点击「详情」,确认模型支持当前分组和准备使用的接口格式。
  5. 比较输入、输出价格以及分组倍率,选择价格适中的模型完成测试。
  6. 点击复制按钮,保存完整模型 ID,下一步请求时使用。

首次验证接入时,暂时不要从图片、音频或复杂推理接口开始。

首次请求成功后,再根据质量、速度、上下文长度和价格测试其他模型。

选择结果检查

进入下一步前,请确认已经准备好:

  • Bita API 的 Base URL
  • 一枚状态正常的 API 密钥
  • API 密钥所属分组
  • 该分组可用的模型 ID
  • 模型所使用的接口格式

下一步

准备好模型 ID 后,继续阅读发送第一个 API 请求