API 文档 · v1

接入文档

AUnbound AI 提供 OpenAI 与 Anthropic 双协议兼容接口。任何支持自定义 Base URL 的 SDK 或客户端(Claude Code、Cherry Studio、LobeChat 等)均可直接接入,无需额外依赖。

Base URL: https://api.unboundai.top/v1 鉴权: Bearer Token 流式: 支持

快速开始

获取令牌

在客户门户注册后,于「我的令牌」创建调用 Key。

选择模型

unbound-flash(极速)或 unbound-max(旗舰)。

替换 Base URL

把 SDK 的 base_url 换成 https://api.unboundai.top/v1 即可。

python

from openai import OpenAI

client = OpenAI(
    api_key="你的令牌",
    base_url="https://api.unboundai.top/v1",
)

resp = client.chat.completions.create(
    model="unbound-flash",
    messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)

鉴权

所有请求需携带 Authorization: Bearer 请求头,令牌在客户门户「我的令牌」创建,前缀 sk-au-。

http

Authorization: Bearer sk-au-xxxxxxxx

Anthropic 协议客户端同时支持 x-api-key 头。请妥善保管令牌,泄露后请立即在门户吊销重建。

模型

模型 ID	定位	适用场景
unbound-flash	极速档	日常对话 / 客服 / 高频调用 / 批量处理
unbound-max	旗舰档	多步推理 / 工程级代码 / 长文写作

两档均自动路由至最优算力链路(4 级候选降级,主链失败无感切换),并内置提示词工程优化,无需调参。兼容写法:auto 等价 Flash,auto:powerful 等价 Max。

对话接口

与 OpenAI Chat Completions 完全同构,支持 stream、temperature、tools 等标准参数。

curl

curl https://api.unboundai.top/v1/chat/completions \
  -H "Authorization: Bearer $AUNBOUND_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "unbound-flash",
    "messages": [
      {"role": "system", "content": "你是一个简洁的助手"},
      {"role": "user", "content": "你好"}
    ],
    "stream": true
  }'

response

{
  "id": "chatcmpl-...",
  "choices": [{
    "message": { "role": "assistant", "content": "你好!有什么可以帮你?" },
    "finish_reason": "stop"
  }],
  "usage": { "prompt_tokens": 24, "completion_tokens": 12, "total_tokens": 36 }
}

流式响应

请求体加 "stream": true 即返回 SSE 流,格式与 OpenAI / Anthropic 官方流一致 (data: {...} 行,data: [DONE] 结束)。

python

stream = client.chat.completions.create(
    model="unbound-max",
    messages=[{"role": "user", "content": "写一首短诗"}],
    stream=True,
)
for chunk in stream:
    delta = chunk.choices[0].delta.content
    if delta:
        print(delta, end="", flush=True)

错误码

HTTP	错误类型	含义与处理
400	invalid_request_error	请求参数不合法,检查 model / messages 格式
401	authentication_error	令牌无效或已吊销,请到门户重建
402	insufficient_quota	今日免费额度已用完,次日 0 点(UTC+8)自动恢复
429	rate_limit_error / quota_exceeded	触发限频或令牌限额,按 Retry-After 重试
502	upstream_error	上游瞬时故障,网关已自动重试;偶发可直接重发

错误响应统一为 OpenAI 风格:{ "error": { "message", "type", "code" } };Anthropic 协议端点则返回对应原生错误结构。

额度与限额

每日免费额度

额度按注册邀请码面值发放(如 1 亿 / 2000 万 Token), 每日 0 点(UTC+8)自动重置。用量在门户「今日额度」实时可查。

并发与频率

平台不限速、不限并发;但请勿脚本化满速跑批,以免触发上游限流影响他人。超出额度时返回 402,次日自动恢复。

准备好了?

凭邀请码注册,创建令牌即可开始调用。

前往客户门户返回首页