API 参考总览
Bitdeer AI 推理 API 的完整参考 — 端点、参数与响应结构。
基础 URL
所有请求应发往:
鉴权
请求须在 Authorization 头中携带 Bearer Token:
在 Bitdeer AI 控制台 → API Keys 获取密钥。详见 鉴权,其中也介绍了 Anthropic 风格的 x-api-key 请求头。
API 分组
基础 API
推理 API
兼容 OpenAI 与 Anthropic 的 HTTP 端点。每个请求的 model 字段取自 列出模型 或 模型目录 中的模型编码。
文本生成
| 文档 | 方法 | 路径 | 说明 |
|---|---|---|---|
| 创建对话补全 | POST | /v1/chat/completions | OpenAI 兼容的对话,支持流式、工具与视觉 |
| 创建响应 | POST | /v1/responses | OpenAI Responses API(无状态子集) |
| 创建消息 | POST | /v1/messages | Anthropic 兼容的 Messages API,适用于 Anthropic SDK 及相关工具 |
| 创建文本补全 | POST | /v1/completions | OpenAI 旧版文本补全 |
向量与重排序
图像与模型
快速开始
1. 获取 API Key
前往 Bitdeer AI 控制台 → API Keys 创建与管理密钥。
2. 发起第一次请求
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或httpsURL,或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 错误结构。完整说明见 错误码。
最后更新于