接入文档

封算天下兼容 OpenAI 协议。如果你已经在用 OpenAI 官方 SDK，只需替换 api_key 与 base_url，其余代码无需改动。

快速开始

1
注册并登录
使用邮箱完成注册，登录后进入控制台。
去注册 →
2
创建调用令牌
在「令牌管理」中新建令牌。创建后点击「查看令牌」按需读取明文并及时保存，平台不会长期留存。
创建令牌 →
3
替换 base_url 发起调用
把 SDK 的 base_url 指向 https://fsuan.121.199.71.19.nip.io/v1/v1，api_key 填你的令牌即可。

接口地址

所有接口以 https://fsuan.121.199.71.19.nip.io/v1 为前缀， Authorization 头携带令牌。

路径方法

引擎尚未返回可用接口列表，接入渠道后会自动出现。

调用示例

cURLbash

curl https://fsuan.121.199.71.19.nip.io/v1/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $OPEN_TOKEN_KEY" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [{"role": "user", "content": "你好"}],
    "stream": false
  }'

Python（OpenAI SDK）python

from openai import OpenAI

client = OpenAI(
    api_key="你的令牌",
    base_url="https://fsuan.121.199.71.19.nip.io/v1/v1",
)

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

Node.js（OpenAI SDK）javascript

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.OPEN_TOKEN_KEY,
  baseURL: "https://fsuan.121.199.71.19.nip.io/v1/v1",
});

const resp = await client.chat.completions.create({
  model: "gpt-4o-mini",
  messages: [{ role: "user", content: "你好" }],
});
console.log(resp.choices[0].message.content);

错误处理

网关在错误响应体中返回 message 字段说明原因，建议在客户端记录该字段以便排查。

401令牌无效或已被禁用，检查 Authorization 头。

429触发限流，降低并发或稍后重试。

402账户余额不足，请先充值。

503上游渠道暂不可用，稍后重试。

安全建议

令牌只放在服务端环境变量里，不要写进前端代码或提交到代码仓库。
为不同项目创建不同令牌，单个令牌泄漏时影响范围可控。
为令牌设置额度上限与模型白名单，避免异常调用造成损失。
发现异常调用时，立即在控制台禁用该令牌。