文档

OpenAI 兼容 API · 最后更新 2026 年 3 月

蓝天目前处于邀请制测试阶段，API Key 需向我们申请： hello@bluesky26.xyz。以下接口与 OpenAI 的请求/响应格式保持兼容，已有客户端通常只需替换 base_url 与 api_key。

基础信息

项目	值
API Base URL	`https://ai.bluesky26.xyz/v1`
协议	HTTPS（HTTP/2 / HTTP/3）
兼容性	OpenAI Chat Completions / Completions 风格
数据格式	JSON；流式为 `text/event-stream`（SSE）

鉴权

所有请求需在 HTTP 头中携带 API Key：

Authorization: Bearer YOUR_API_KEY

Key 与账户一一对应，请妥善保管，不要写入前端代码或公开仓库。如怀疑泄露，请来信申请轮换。

可用模型

实验阶段提供少量常见开源权重模型，列表可能随容量调整：

模型 ID	说明	上下文
`qwen2.5-7b-instruct`	通用对话与指令	32k
`llama-3.1-8b-instruct`	通用对话，英文较强	128k
`mixtral-8x7b-instruct`	MoE，偏长文本与多语言	32k

可用模型以你账户实际开通为准。需要其它开源模型可来信沟通。

调用示例

使用官方 openai 客户端，无需安装任何专有 SDK：

from openai import OpenAI

client = OpenAI(
    base_url="https://ai.bluesky26.xyz/v1",
    api_key="YOUR_API_KEY",
)

resp = client.chat.completions.create(
    model="qwen2.5-7b-instruct",
    messages=[{"role": "user", "content": "你好"}],
    stream=True,
)
for chunk in resp:
    print(chunk.choices[0].delta.content or "", end="")

等价的 cURL：

curl https://ai.bluesky26.xyz/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"qwen2.5-7b-instruct","messages":[{"role":"user","content":"你好"}]}'

错误码

HTTP	含义	常见原因
`400`	请求无效	参数缺失或格式错误
`401`	未授权	缺少或错误的 API Key
`404`	资源不存在	模型 ID 未开通或拼写错误
`429`	触发限流	超过速率上限，请退避重试
`500 / 503`	服务端错误	临时故障，请稍后重试

错误响应为 JSON，形如：

{
  "error": {
    "type": "rate_limit_error",
    "message": "Too many requests, please retry later."
  }
}

限流

测试阶段对每个账户设有保守的速率与并发上限，用以保证整体稳定。触发限流会返回 429，响应头包含 Retry-After（秒）。建议客户端实现指数退避。如需更高额度，请来信说明用量。

需要帮助？

接入问题请联系 hello@bluesky26.xyz；服务条款见服务条款，数据处理见隐私政策。