Base URL 地址

https://zerofa.ai

按接口格式配置

SDK 的 Base URL 与 curl 中的完整请求地址不是同一个概念。OpenAI SDK 通常把 /v1 放在 base_url 中；Anthropic、Gemini 和原生透传则保留站点根地址。

鉴权

在 API Keys 创建 key（sk-zerofa-*）。根据接口格式放入对应鉴权头，key 本身保持一致；使用官方 SDK 时，将 api_key 设为 sk-zerofa-* 即可，SDK 会自动携带对应请求头。

# OpenAI 兼容
Authorization: Bearer sk-zerofa-xxx

# Anthropic 原生
x-api-key: sk-zerofa-xxx

# Gemini 原生
x-goog-api-key: sk-zerofa-xxx

推荐的客户端配置

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://zerofa.ai/v1",
    api_key=os.environ["FORNAI_API_KEY"],
)

• 只在服务端环境变量中保存 API Key，不要写进前端代码、仓库或日志。
• 统一去掉 Base URL 末尾的 /，避免和 SDK 自动添加的路径拼出双斜杠。
• 记录失败响应中的 X-Request-ID；排查上游错误、限流和计费问题时优先提供该值。