AI API 聚合网关

StarAPI 开发者文档

StarAPI 提供统一的 AI API 接入入口，支持 OpenAI 兼容调用方式，并可用于 Claude Code、Codex、Gemini CLI 等开发工具场景。

统一入口 一个 Base URL 接入多种模型能力，减少多平台配置成本。

工具友好 适配常见 AI 编程工具和 OpenAI 兼容 SDK。

用量可控 按项目、成员或环境创建密钥，便于统计和管理。

StarAPI 是什么

StarAPI 是面向开发者和团队的 AI API 聚合网关。你可以通过统一接口调用不同模型，并在控制台中管理 API Key、余额、用量和接入配置。

适合需要接入 AI 对话、代码生成、智能体工具、自动化脚本和团队共享模型能力的场景。

快速开始

1. 登录控制台

打开 StarAPI 控制台并创建账号。

控制台地址

https://www.starrai.top/sign-in

2. 创建 API Key

进入 API Key 管理页面，创建用于项目或工具接入的密钥。建议不同项目使用不同密钥。

Claude Code 接入

在 shell 配置文件(~/.bashrc 或 ~/.zshrc)里加上这几行,重开终端生效。注意 Base URL 不带 /v1,Claude Code 自己会补

~/.bashrc · ~/.zshrc

export ANTHROPIC_BASE_URL="https://yapi.click"
export ANTHROPIC_AUTH_TOKEN="sk-your-api-key"
export ANTHROPIC_MODEL="claude-sonnet-4-6"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-4-5-20251001"

不想动全局配置的话,也可以只给某个项目配置

~/.claude/settings.json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://yapi.click",
    "ANTHROPIC_AUTH_TOKEN": "sk-your-api-key",
    "ANTHROPIC_MODEL": "claude-sonnet-4-6"
  }
}

Codex 接入

如果你的 Codex 工具支持 OpenAI 兼容接口，将 API Base URL 设置为 StarAPI 地址，并使用控制台创建的 API Key。

Codex 配置

API Base URL: https://api.starapi.dev/v1
API Key: YOUR_API_KEY
Model: gpt-4.1

Gemini CLI 接入

Gemini CLI 的接入方式取决于你使用的版本。若工具支持自定义接口地址，可填写 StarAPI 的 Base URL 和 API Key。

如果工具只支持官方 Gemini 接口，需要使用支持 OpenAI 兼容协议的适配层。

模型与计费

可用模型会根据账号权限和平台配置显示。不同模型的价格、速度、上下文长度可能不同。

类型	适合场景
通用对话模型	问答、总结、写作、轻量代码任务
代码模型	代码生成、重构、调试、脚本编写
推理模型	复杂分析、规划和多步骤任务
多模态模型	图像理解和图文混合任务

常见错误码

错误码	说明
400	请求格式错误，请检查 JSON、模型名和必填字段。
401	API Key 缺失、错误或已失效。
403	当前账号或密钥没有访问权限。
429	请求过快或触发限流。
500	服务内部错误或上游异常，请稍后重试。

常见问题

Base URL 应该填写什么？

https://api.starapi.dev/v1

为什么返回 401？

通常是 API Key 缺失、错误或已经失效。

可以给团队成员单独分配密钥吗？

建议为不同成员、项目和环境分别创建 API Key，便于统计和限制用量。