AI API 网关使用指南

一个地址、一把密钥，接入 OpenAI、Anthropic、Gemini 三类协议，20 多个免登录免费模型可直接调用，按 token 精确计费。

免费注册 →

这个网关解决什么问题

不同大模型厂商的接口协议、鉴权方式、计费单位都不一样。如果你同时用 OpenAI、Claude、Gemini 或国内的模型，就要维护多套密钥、多套 SDK、多个账单。

AI API 网关把它们的差异收在服务端：你只需要一个 base_url、一把密钥，就能用任意一种熟悉的协议调用任意模型。换模型只改一个字段，不用改代码。

支持的四类协议

同一个域名、同一把密钥，下面四种入站协议都可以直接使用，网关会做双向转换：

协议端点典型客户端
OpenAI Chat Completions/v1/chat/completions绝大多数 SDK、Cherry Studio、ChatBox、LangChain
OpenAI Responses/v1/responses新版 OpenAI SDK、Agent 框架
Anthropic Messages/v1/messagesClaude Code、Anthropic SDK
Gemini/v1beta/models/{model}:generateContentGoogle Generative AI SDK

免费模型怎么用

注册后不需要充值，控制台里创建一把密钥，就能调用免费体验区里的模型。这些模型来自第三方公共免费池，倍率为 0，只做体验用途：

免费池的额度、限流、上下线由上游决定，随时可能变化。需要稳定性和更高并发请使用付费模型。

五分钟接入

curl

curl https://api.forsienna.art/v1/chat/completions \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "combo:recommended-free",
    "messages": [{"role":"user","content":"你好"}]
  }'

Python（OpenAI SDK）

from openai import OpenAI

client = OpenAI(
    base_url="https://api.forsienna.art/v1",
    api_key="sk-你的密钥",
)

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

Node.js

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.forsienna.art/v1",
  apiKey: process.env.RELAY_API_KEY,
});

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

Claude Code

export ANTHROPIC_BASE_URL=https://api.forsienna.art
export ANTHROPIC_AUTH_TOKEN=sk-你的密钥

计费方式

按 token 计费，输入与输出分开计量，费用精确到每一次请求：

项目规则
计价单位美元额度，1 美元 = 500,000 配额单位
充值按公示汇率折算人民币，支持在线支付与兑换码
余额有效期不清零、不过期
失败请求自动返还预扣额度
免费模型倍率 0，不扣余额

常见问题

额度会过期吗？

不会。余额长期有效。兑换码有单独有效期，兑换时页面会提示。

支持哪些客户端？

任何兼容 OpenAI、Anthropic 或 Gemini 协议的客户端与 SDK，包括 Cherry Studio、ChatBox、LangChain、Cursor、Claude Code 等。只要能把 base_url 改成本站地址即可。

请求失败为什么还扣了额度？

失败请求会自动返还预扣额度。如果发现异常，请通过控制台工单联系，核实后补回。

和直接调用官方 API 有什么区别？

本站不改变模型能力，只在协议与计费层面做聚合：省去多平台多密钥的管理成本，并提供统一的用量统计与对账。模型本身的输出质量与官方一致。

可以开票吗？

可以。企业用户请通过控制台工单提交抬头与税号。

实时可用性

每个免费模型是否可用、来源（Kilo / OpenCode）、当前延迟，每 10 分钟自动检测：免费模型实时状态 →

延伸阅读