API 快速开始

我想要AI 提供 OpenAI 兼容接口。把 base_url 换成 https://api.531ai.vip/v1，带上你的 KEY，即可调用所有模型。

1. 获取 API Key

注册并登录控制台 → 「我的 API Key」→ 点击「生成 Key」→ 复制保存（仅显示一次）。

2. 调用接口

curlPythonJavaScript

curl https://api.531ai.vip/v1/chat/completions \ -H "Authorization: Bearer sk-你的KEY" \ -H "Content-Type: application/json" \ -d "{ \"model\": \"gpt-6-astra\", \"messages\": [{\"role\": \"user\", \"content\": \"你好\"}] }"

3. 鉴权

所有请求需携带 Authorization: Bearer YOUR_KEY 请求头。KEY 在控制台生成，支持随时启停。

4. 计量方式（行业标准单位）

价格按 元 / 百万 tokens 展示（各模型单价见模型广场标注，输入 / 输出分开计价）。每次调用按响应 usage 的四项分别计量：

计量项	说明	计价方式
输入	prompt_tokens	× 该模型输入价
输出	completion_tokens	× 该模型输出价
缓存命中	cached_tokens	× 该模型缓存单价（标 FREE 不计费）
缓存写入	cache_creation_tokens	× 该模型缓存写入单价（标 FREE 不计费）

5. 扣费公式

扣费（元） = 全价输入 tokens × 输入价/1M + 输出 tokens × 输出价/1M + 缓存命中 tokens × 缓存命中价/1M + 缓存写入 tokens × 缓存写入价/1M

其中：全价输入 = prompt_tokens − 缓存命中 tokens（缓存命中已包含在 prompt_tokens 内，命中部分只按缓存价计、不再重复按输入价计费）。缓存命中 / 缓存写入按各模型公布的缓存价计费（单位元/百万 tokens），定价表标注 FREE 的项该模型免费、我方不计费。余额按元扣减，充值多少余额即多少（¥N = ¥N 余额）。明细在控制台「用量明细」逐条可查，对账透明。

举例：gpt-6-astra（输入 ¥84.24 · 输出 ¥421.2 · 缓存命中 ¥8.424 · 缓存写入 ¥105.3 每百万 tokens）。一次调用 prompt 2,000 tokens（其中缓存命中 800）、输出 500 tokens、无缓存写入：全价输入 1,200 × 84.24/1M = ¥0.1011，缓存命中 800 × 8.424/1M = ¥0.0067，输出 500 × 421.2/1M = ¥0.2106 → 合计 ¥0.3184。缓存写入为 0（免费）不计费。

6. 模型列表

GET https://api.531ai.vip/v1/models — 返回当前可用模型与实时价格。各模型单价与上下文规格也可直接在模型广场查看。

7. 错误码

状态码	含义
401	KEY 无效或已停用
402	余额不足，请充值
429	请求过于频繁
502	模型服务暂时不可用