API 接入快速指南

橙枢 AI 提供 OpenAI 兼容接口。大部分客户端只需要填写 Base URL、API Key 和模型名。

准备信息

• Base URL：https://api.cxbl.top/v1
• API Key：在控制台创建并复制令牌。
• 模型名：以控制台当前可见模型为准。

客户端配置

Base URL: https://api.cxbl.top/v1
API Key: sk-你的令牌
Model: 控制台显示的模型名

如果客户端同时支持 Chat、Responses、Claude 或 Gemini 等接口，第一次测试先选择 OpenAI Chat Completions 兼容模式。

PowerShell 测试

$headers = @{
    Authorization = 'Bearer sk-你的令牌'
    'Content-Type' = 'application/json'
}

$body = @{
    model = '你的模型名'
    messages = @(
        @{ role = 'user'; content = '你好，做一个连通性测试' }
    )
} | ConvertTo-Json -Depth 5

Invoke-RestMethod `
    -Uri 'https://api.cxbl.top/v1/chat/completions' `
    -Method Post `
    -Headers $headers `
    -Body $body

成功标准

• 请求返回模型回复。
• 控制台出现对应使用记录。
• 余额产生与请求相符的扣减。

常见错误

错误	优先检查
401	API Key 是否完整，Authorization 是否正确
403	令牌权限和平台规则
429	频率、并发或额度限制
insufficient quota	账户余额和令牌额度
model not found	模型名是否与控制台完全一致
upstream error	稍后重试，或换一个可用模型进行对比测试

正式使用前

先用短消息完成小额测试，再逐步增加上下文、图片、工具调用和并发量。这样更容易定位配置问题，也能避免异常消耗。