快速开始 · OpenAI SDK 改两行接入

ZeroFA 提供 OpenAI 兼容的 REST 接口。现有 OpenAI SDK 代码只需修改 base_url 和 api_key，就能通过一个接口调用 Claude、GPT、Gemini、DeepSeek、Qwen 等全部支持的模型。

1. 获取 API Key

前往 API Keys 创建一个 sk-zerofa-* key 并妥善保存。密钥创建后只显示一次，无法找回。

2. 充值钱包

所有调用都会按当前币种从钱包管理实时扣费；API 钱包与网页 chat 订阅相互独立。

3. 发起调用

将 base_url 指向 ZeroFA，并把 api_key 换成你的 key。选择一种语言开始调用：

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://zerofa.ai/v1",
    api_key=os.environ["FORNAI_API_KEY"],   # 从服务端环境变量读取
)

resp = client.chat.completions.create(
    model="your-chat-model-id",              # 任意 ZeroFA 支持的模型
    messages=[{"role": "user", "content": "hello"}],
)
print(resp.choices[0].message.content)

成功响应

{
  "id": "chatcmpl_...",
  "object": "chat.completion",
  "model": "your-chat-model-id",
  "choices": [{
    "index": 0,
    "message": {"role": "assistant", "content": "Hello!"},
    "finish_reason": "stop"
  }],
  "usage": {"prompt_tokens": 8, "completion_tokens": 3, "total_tokens": 11}
}

确认接入正确

首次请求成功后，先核对三个信号，再开始接入业务逻辑。

响应 model 与请求的站点模型 ID 一致；切换模型只需要修改 model。
响应 usage 有 token 用量，并能在控制台调用日志中找到同一请求。
保存响应头 X-Request-ID。请求失败或账单异常时，它是定位调用的首要信息。

支持的模型

Claude、GPT、Gemini、DeepSeek 等数十个模型只需修改 model 字段即可切换。完整实时列表见模型广场，也可以通过 GET /v1/models 获取。

下一步

了解控制台各项功能：控制台指南
查看计费规则：定价与计费
查看详细字段： Chat Completions
使用厂商原生格式： Anthropic Messages / Gemini generateContent

3. 发起调用

将 base_url 指向 ZeroFA，并把 api_key 换成你的 key。选择一种语言开始调用：

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://zerofa.ai/v1",
    api_key=os.environ["FORNAI_API_KEY"],   # 从服务端环境变量读取
)

resp = client.chat.completions.create(
    model="your-chat-model-id",              # 任意 ZeroFA 支持的模型
    messages=[{"role": "user", "content": "hello"}],
)
print(resp.choices[0].message.content)

成功响应

{
  "id": "chatcmpl_...",
  "object": "chat.completion",
  "model": "your-chat-model-id",
  "choices": [{
    "index": 0,
    "message": {"role": "assistant", "content": "Hello!"},
    "finish_reason": "stop"
  }],
  "usage": {"prompt_tokens": 8, "completion_tokens": 3, "total_tokens": 11}
}

确认接入正确

首次请求成功后，先核对三个信号，再开始接入业务逻辑。

响应 model 与请求的站点模型 ID 一致；切换模型只需要修改 model。

响应 usage 有 token 用量，并能在控制台调用日志中找到同一请求。

保存响应头 X-Request-ID。请求失败或账单异常时，它是定位调用的首要信息。