API 参考总览

Bitdeer AI 推理 API 的完整参考 — 端点、参数与响应结构。

基础 URL

所有请求应发往:

https://api-inference.bitdeer.ai/v1

鉴权

请求须在 Authorization 头中携带 Bearer Token:

Authorization: Bearer {API_KEY}

在 Bitdeer AI 控制台 → API Keys 获取密钥。详见 鉴权,其中也介绍了 Anthropic 风格的 x-api-key 请求头。

API 分组

基础 API

文档说明
鉴权API Key 管理与使用
错误码统一错误响应与重试建议

推理 API

兼容 OpenAI 与 Anthropic 的 HTTP 端点。每个请求的 model 字段取自 列出模型 或 模型目录 中的模型编码。

文本生成

文档方法路径说明
创建对话补全POST/v1/chat/completionsOpenAI 兼容的对话,支持流式、工具与视觉
创建响应POST/v1/responsesOpenAI Responses API(无状态子集)
创建消息POST/v1/messagesAnthropic 兼容的 Messages API,适用于 Anthropic SDK 及相关工具
创建文本补全POST/v1/completionsOpenAI 旧版文本补全

向量与重排序

文档方法路径说明
创建向量POST/v1/embeddings文本转向量
文档重排序POST/v1/rerank按与查询的相关性重排文档

图像与模型

文档方法路径说明
生成图像POST/v1/images/generations根据文本 prompt 生成图像
列出模型GET/v1/models列出已发布的模型

快速开始

1. 获取 API Key

前往 Bitdeer AI 控制台 → API Keys 创建与管理密钥。

2. 发起第一次请求

curl https://api-inference.bitdeer.ai/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

3. 客户端库

  • Python 与 JavaScript/TypeScript:使用社区版 openai 客户端,将 base_url / baseURL 设为 https://api-inference.bitdeer.ai/v1。请求与响应字段与 HTTP API 中的结构一致。
  • Anthropic SDK 及基于其构建的工具:将 base URL 设为 https://api-inference.bitdeer.ai,调用 创建消息。

请求约定

  • 额外参数。 在 OpenAI 或 Anthropic 中没有对应项的模型专有参数,请放在 extra_params 中;它们会在请求到达模型前合并到请求顶层,同名的标准顶层字段优先。除 /v1/responses 外,所有端点都支持 extra_params。未知的顶层字段在对话、文本补全、向量、重排序和图像请求中会转发给模型,在 /v1/messages 和 /v1/responses 中会被忽略。
  • 媒体 URL。 请求中的图像、音频、视频和文件 URL 必须是公网主机上的 http 或 https URL,或 data: URI。每个请求最多 32 个此类 URL。
  • 请求大小。 请求体上限为 32 MiB。超限的请求体会被以 413 拒绝;若未带 Content-Length 发送,则以 400 拒绝。
  • 请求 ID。 每个响应都带有 X-Request-ID 响应头,联系技术支持时请提供该值。你也可以自行发送 X-Request-ID(1–128 个 A-Z a-z 0-9 . _ - 字符),它会被原样返回;其他值会被替换为自动生成的 ID。

常见需求

你想做什么前往
「如何上手?」快速开始 + 鉴权
「401 错误」错误码
「用 LLM 生成文本」创建对话补全
「使用 Anthropic SDK 或工具」创建消息
「用视觉模型理解图像」视觉指南
「搭建 RAG」RAG 示例
「函数调用」函数调用指南
「流式响应」流式输出指南
「查看所有模型」模型目录
「连接 Cursor / LangChain」集成
「Chat 请求如何工作?」LLM 指南

错误处理

错误使用 OpenAI 错误结构,/v1/messages 除外,它使用 Anthropic 错误结构。完整说明见 错误码。

最后更新于

本页目录