快速开始

本页用最短路径跑通第一个请求：创建 API Key → 选择协议 → 发起调用。

创建 API Key

登录 Fenno API 控制台。
打开控制台的 API Key／密钥管理区域，按实际界面创建密钥。
按界面提示妥善保存，不要假设之后仍能查看完整值。

不要把 Key 提交到仓库或写进前端代码。服务端使用时请通过环境变量注入，例如 FENNO_API_KEY。

在运行下方示例的 Shell 中导出 Key 和实际可用的 Chat Completions 模型 ID。替换两个占位值；精确模型 ID 可从控制台或模型查询获取。


export FENNO_API_KEY="<your-api-key>"
export FENNO_MODEL="<your-model-id>"

配置 Base URL

协议	Base URL
OpenAI 兼容	`https://api.fenno.ai/v1`
Anthropic 原生	`https://api.fenno.ai`
Gemini 原生	`https://api.fenno.ai`

发起第一个请求

cURL


curl https://api.fenno.ai/v1/chat/completions \
  -H "Authorization: Bearer $FENNO_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<JSON
  {
    "model": "$FENNO_MODEL",
    "messages": [{"role": "user", "content": "用一句话解释什么是统一 API 网关"}]
  }
JSON

Python (OpenAI SDK)


import os
from openai import OpenAI
 
client = OpenAI(
    base_url="https://api.fenno.ai/v1",
    api_key=os.environ["FENNO_API_KEY"],
)
 
resp = client.chat.completions.create(
    model=os.environ["FENNO_MODEL"],
    messages=[{"role": "user", "content": "用一句话解释什么是统一 API 网关"}],
)
print(resp.choices[0].message.content)

Node.js (OpenAI SDK)


import OpenAI from 'openai'
 
const client = new OpenAI({
  baseURL: 'https://api.fenno.ai/v1',
  apiKey: process.env.FENNO_API_KEY
})
 
const resp = await client.chat.completions.create({
  model: process.env.FENNO_MODEL!,
  messages: [{ role: 'user', content: '用一句话解释什么是统一 API 网关' }]
})
console.log(resp.choices[0].message.content)

接入编码工具


# Claude Code
export ANTHROPIC_BASE_URL="https://api.fenno.ai"
export ANTHROPIC_AUTH_TOKEN="$FENNO_API_KEY"


# Codex / OpenAI 兼容工具
export OPENAI_BASE_URL="https://api.fenno.ai/v1"
export OPENAI_API_KEY="$FENNO_API_KEY"

更多工具的完整配置见工具接入。

常见问题

现象	排查方向
`401 Unauthorized`	Key 是否完整、是否被删除或禁用
`404 Not Found`	Base URL 是否多了或少了 `/v1`
`429 Too Many Requests`	触发速率限制，见错误与重试
模型不存在	确认模型标识拼写，以及账号是否有该模型权限