API 端点
基础信息
| 项目 | 值 |
| Base URL | https://console.bloomai.vip |
| 认证方式 | Authorization: Bearer sk-xxx / x-api-key: sk-xxx(Anthropic)/ x-goog-api-key: sk-xxx(Gemini) |
| 传输协议 | HTTPS |
| 内容类型 | application/json |
协议与 Base URL
| 协议 | Base URL | 认证头 |
| OpenAI 兼容 | https://console.bloomai.vip/v1 | Authorization: Bearer sk-xxx |
| Anthropic | https://console.bloomai.vip | x-api-key: sk-xxx(另需 anthropic-version: 2023-06-01) |
| Gemini 原生 | https://console.bloomai.vip/v1beta | x-goog-api-key: sk-xxx |
端点总览
| 协议 / 能力 | 方法与路径 | 说明 |
| OpenAI Chat | POST /v1/chat/completions | 对话与流式输出 |
| OpenAI Responses | POST /v1/responses | Codex、工具调用、Responses 工作流 |
| Anthropic Messages | POST /v1/messages | Claude 原生 Messages API |
| Anthropic Token 计数 | POST /v1/messages/count_tokens | 发送前估算输入 Token |
| OpenAI 图片生成 | POST /v1/images/generations | 文生图,支持流式 SSE |
| OpenAI 图片编辑 | POST /v1/images/edits | multipart/form-data 上传源图 |
| 模型列表 | GET /v1/models | OpenAI 兼容模型列表 |
| Gemini 生成 | POST /v1beta/models/{model}:generateContent | Gemini 非流式 |
| Gemini 流式 | POST /v1beta/models/{model}:streamGenerateContent | Gemini SSE 流式 |
| 视频生成(异步) | POST /api/v3/contents/generations/tasks | 提交多模态视频任务 |
| 视频任务查询 | GET /api/v3/contents/generations/tasks/{task_id} | 查询任务状态与结果 |
异步视频任务:提交后返回任务 ID,需要轮询查询接口拿结果;输出视频是带签名的临时地址,请及时转存。
Chat Completions 参数
| 参数 | 类型 | 必填 | 说明 |
model | string | 是 | 模型广场中的完整模型 ID |
messages | array | 是 | 消息数组(role / content) |
stream | boolean | 否 | 流式输出,默认 false |
temperature | number | 否 | 采样温度 0-2 |
top_p | number | 否 | 核采样 |
max_tokens | number | 否 | 最大输出 token 数 |
tools | array | 否 | 函数工具定义 |
tool_choice | string/object | 否 | auto / required / none / 指定工具 |
Messages 参数(Anthropic)
| 参数 | 类型 | 必填 | 说明 |
model | string | 是 | 模型 ID |
messages | array | 是 | 消息数组 |
max_tokens | number | 是 | 最大输出 token 数 |
stream | boolean | 否 | 流式输出 |
system | string | 否 | 系统提示词 |
代码示例
cURL
curl https://console.bloomai.vip/v1/chat/completions \
-H "Authorization: Bearer sk-your-key" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-4-6",
"messages": [{"role": "user", "content": "Hello!"}]
}'
Python(OpenAI SDK)
from openai import OpenAI
client = OpenAI(
base_url="https://console.bloomai.vip/v1",
api_key="sk-your-key",
)
resp = client.chat.completions.create(
model="claude-sonnet-4-6",
messages=[{"role": "user", "content": "Hello!"}],
stream=True,
)
for chunk in resp:
print(chunk.choices[0].delta.content or "", end="")
Python(Anthropic SDK)
from anthropic import Anthropic
client = Anthropic(
base_url="https://console.bloomai.vip",
api_key="sk-your-key",
)
msg = client.messages.create(
model="claude-sonnet-4-6",
max_tokens=1024,
messages=[{"role": "user", "content": "Hello!"}],
)
print(msg.content[0].text)
Node.js(OpenAI SDK)
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://console.bloomai.vip/v1",
apiKey: "sk-your-key",
});
const stream = await client.chat.completions.create({
model: "claude-sonnet-4-6",
messages: [{ role: "user", content: "Hello!" }],
stream: true,
});
for await (const chunk of stream) {
process.stdout.write(chunk.choices[0]?.delta?.content || "");
}
图片生成
curl https://console.bloomai.vip/v1/images/generations \
-H "Authorization: Bearer sk-your-key" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2",
"prompt": "A cute cat wearing sunglasses on a beach",
"stream": true,
"size": "1024x1024",
"quality": "high"
}'
图片生成通常需要 30–120 秒,推荐开启 stream,可避免网关超时并实时看到进度。
Responses API 与 Chat Completions 差异
| chat/completions | responses |
| 请求字段 | messages | input |
| 图片类型 | image_url | input_image |
| 图片 URL 格式 | {url: "..."} | 直接传字符串 |
| 图片生成 | — | image_generation 工具 |
| 响应结构 | choices[].message | output[] |
| 多轮对话 | — | previous_response_id |