接入文档
兼容 OpenAI 协议,5 分钟接入。
快速开始
| Base URL | https://www.881557.xyz/v1 |
|---|---|
| 认证 | Authorization: Bearer sk-你的密钥 |
| 协议 | OpenAI Chat Completions / Responses / Embeddings / Images,另支持 Claude Messages |
- 注册账号:/console/sign-up
- 登录后进「API 密钥」页,点「新建」,复制
sk-开头的密钥 - 把代码里的
base_url换成上面的地址,模型名按 价格页 填
认证方式
所有请求都要带 Header:
Authorization: Bearer sk-xxxxxxxxxxxxxxxx
密钥只在创建时显示一次,丢了就重建一个。不要把密钥写进前端代码或公开仓库。
调用示例
curl
curl https://www.881557.xyz/v1/chat/completions \
-H "Authorization: Bearer sk-你的密钥" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-6.1-sol",
"messages": [{"role": "user", "content": "你好"}],
"stream": false
}'
Python(openai 官方 SDK)
from openai import OpenAI
client = OpenAI(
api_key="sk-你的密钥",
base_url="https://www.881557.xyz/v1",
)
resp = client.chat.completions.create(
model="claude-sonnet-5",
messages=[{"role": "user", "content": "写一个快速排序"}],
)
print(resp.choices[0].message.content)
Node.js(openai 官方 SDK)
import OpenAI from "openai";
const client = new OpenAI({
apiKey: "sk-你的密钥",
baseURL: "https://www.881557.xyz/v1",
});
const r = await client.chat.completions.create({
model: "deepseek-v4.1-flash",
messages: [{ role: "user", content: "你好" }],
});
console.log(r.choices[0].message.content);
流式输出
传 "stream": true 即可,返回标准 SSE,SDK 会自动处理。
Claude 原生格式
如果你的代码用的是 Anthropic SDK,可以走 /v1/messages:
curl https://www.881557.xyz/v1/messages \
-H "x-api-key: sk-你的密钥" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{"model":"claude-sonnet-5","max_tokens":1024,"messages":[{"role":"user","content":"你好"}]}'
客户端配置
| 客户端 | 填法 |
|---|---|
| Cherry Studio | 设置 → 模型服务 → OpenAI → API 地址填 https://www.881557.xyz/v1,密钥填 sk-xxx,手动添加模型名 |
| NextChat | 设置 → 自定义接口 → 接口地址 https://www.881557.xyz,密钥 sk-xxx |
| Cline / Roo | API Provider 选 OpenAI Compatible,Base URL 填 https://www.881557.xyz/v1 |
| Continue | models[].provider: openai,apiBase: https://www.881557.xyz/v1 |
| LangChain | base_url="https://www.881557.xyz/v1" |
模型与分组
同一个模型可能出现在多个「分组」里,价格不同(分组倍率不同)。价格页可以按分组筛选:
- 请求时不用指定分组 —— 系统按你的账户默认分组自动路由
- 模型名以价格页显示为准,例如
gpt-6.1-sol、claude-opus-5、glm-5.3 - 查看全部模型:模型价格
计费规则
- 1 元 = 1 美元额度,充值后直接进余额(
quota) - 按 token 计费:
费用 = 输入 tokens × 输入单价 + 输出 tokens × 输出单价 - 价格页展示的是「元 / 100 万 tokens」,已包含分组折扣
- 图片类模型按张计费,价格页标注「按次」
- 余额不足会返回 403,充值后立即可用
- 首充赠送 ¥0.5,自动到账
错误码
| 状态码 | 含义 | 处理 |
|---|---|---|
| 401 | 密钥无效或已删除 | 重新创建密钥 |
| 403 | 余额不足 / 无该模型权限 | 充值或换分组模型 |
| 404 | 模型名不存在 | 按价格页模型名填写 |
| 429 | 请求过于频繁 | 降低并发,默认 300 次/分钟 |
| 5xx | 上游临时故障 | 稍后重试,我们有多线路自动切换 |
常见问题
返回 model not found?
模型名要和价格页完全一致,注意不要带 openai/ 之类前缀。
要不要开代理?
不需要,国内直连即可。
能开发票吗?
暂时不支持,需要的话联系站长。
余额能退吗?
虚拟商品不支持退款,建议先充 1 元试用。
还有问题?联系站长 QQ 3260859254, 或加群 1057525906。
灵渠