🌸 Bloom AI · 文档

API 端点

基础信息

项目
Base URLhttps://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/v1Authorization: Bearer sk-xxx
Anthropichttps://console.bloomai.vipx-api-key: sk-xxx(另需 anthropic-version: 2023-06-01
Gemini 原生https://console.bloomai.vip/v1betax-goog-api-key: sk-xxx

端点总览

协议 / 能力方法与路径说明
OpenAI ChatPOST /v1/chat/completions对话与流式输出
OpenAI ResponsesPOST /v1/responsesCodex、工具调用、Responses 工作流
Anthropic MessagesPOST /v1/messagesClaude 原生 Messages API
Anthropic Token 计数POST /v1/messages/count_tokens发送前估算输入 Token
OpenAI 图片生成POST /v1/images/generations文生图,支持流式 SSE
OpenAI 图片编辑POST /v1/images/editsmultipart/form-data 上传源图
模型列表GET /v1/modelsOpenAI 兼容模型列表
Gemini 生成POST /v1beta/models/{model}:generateContentGemini 非流式
Gemini 流式POST /v1beta/models/{model}:streamGenerateContentGemini SSE 流式
视频生成(异步)POST /api/v3/contents/generations/tasks提交多模态视频任务
视频任务查询GET /api/v3/contents/generations/tasks/{task_id}查询任务状态与结果
异步视频任务:提交后返回任务 ID,需要轮询查询接口拿结果;输出视频是带签名的临时地址,请及时转存。

Chat Completions 参数

参数类型必填说明
modelstring模型广场中的完整模型 ID
messagesarray消息数组(role / content)
streamboolean流式输出,默认 false
temperaturenumber采样温度 0-2
top_pnumber核采样
max_tokensnumber最大输出 token 数
toolsarray函数工具定义
tool_choicestring/objectauto / required / none / 指定工具

Messages 参数(Anthropic)

参数类型必填说明
modelstring模型 ID
messagesarray消息数组
max_tokensnumber最大输出 token 数
streamboolean流式输出
systemstring系统提示词

代码示例

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/completionsresponses
请求字段messagesinput
图片类型image_urlinput_image
图片 URL 格式{url: "..."}直接传字符串
图片生成image_generation 工具
响应结构choices[].messageoutput[]
多轮对话previous_response_id