StableAPIStableAPI
登录开始使用

API 文档

集成 StableAPI 所需的一切

简介

StableAPI 是一个统一的 AI 模型 API 网关，将多家供应商的模型整合到一个 OpenAI 兼容端点中，方便开发者按需调用。

我们致力于解决多模型接入中的常见痛点：

  • 多供应商模型统一接入，减少集成工作量
  • 透明的按量计费，用多少付多少
  • 灵活的令牌权限管理，适配团队协作需求
多模型聚合

支持 Claude、GPT、Gemini、DeepSeek、Qwen 等主流模型，通过单一端点按需切换，无需分别对接各供应商。

智能路由与负载均衡

请求自动分配至最优渠道节点，内置健康检测与故障切换，减少因单点故障导致的请求失败。

精细化访问控制

每个 API 令牌可独立配置模型权限、IP 白名单、额度上限和有效期，满足多人协作与权限隔离需求。

OpenAI 兼容格式

遵循 OpenAI API 规范，现有代码只需更换 Base URL 和密钥即可迁移，无需学习新的 SDK 或接口。

典型使用场景

  • 需要在项目中快速对接多个 AI 模型的开发者
  • 希望用统一 API 管理多供应商调用的技术团队
  • 在 IDE 或 CLI 中使用 AI 辅助编程的工程师
  • 需要对 API 用量做精细化管控和成本追踪的组织

快速开始

3 个简单步骤即可开始使用

1

注册账号并获取 API 令牌

在 StableAPI 注册账号，然后进入 仪表盘 → 令牌 创建 API 密钥。

2

设置基础地址

将 OpenAI 兼容客户端指向下方的 StableAPI 端点。

3

发起第一个请求

通过统一 API 使用任何支持的模型，参见下方代码示例。

apiv1.stableapi.dev/v1OpenAI 兼容端点 — 使用此地址作为 Base URL
curl -X POST apiv1.stableapi.dev/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-your-token" \
  -d '{
    "model": "gpt-4o",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

API Key 管理

API 密钥（令牌）用于验证你的请求。你可以在仪表盘中创建和管理它们。

创建令牌

进入 仪表盘 → 令牌 → 创建令牌。每个令牌可以配置：

  • 名称 — 用于你自己识别的标签
  • 额度限制 — 此密钥允许的最大消耗
  • 模型限制 — 限制此密钥可以访问的模型
  • IP 白名单 — 限制为特定 IP 地址使用
  • 过期时间 — 到期后自动禁用

使用令牌

在每个请求的 Authorization 头中包含你的令牌：

http
Authorization: Bearer sk-your-token

充值与套餐

StableAPI 提供灵活的计费方式，适配你的使用习惯。

Token 计费

按百万 token 计费（输入和输出分别定价）。大多数对话和补全模型使用此模式。

按次计费

每次 API 调用固定价格，不计 token 数量。部分特殊模型使用此模式。

图片计费

按生成的图片数量计费。图片生成模型如 DALL-E 和 GPT-Image 使用此模式。

钱包

充值钱包余额，按量付费。所有使用量实时从钱包扣除。

订阅套餐

订阅月度套餐可获得包含的模型访问和优惠价格。请在计费页面查看可用套餐。

CLI 工具配置

配置常用 CLI 工具使用 StableAPI 作为后端。

Claude Code

设置以下环境变量，将 Claude Code 的请求通过 StableAPI 转发：

bash
export ANTHROPIC_BASE_URL="apiv1.stableapi.dev/v1"
export ANTHROPIC_API_KEY="sk-your-token"

将以上内容添加到 shell 配置文件（~/.bashrc, ~/.zshrc）以持久生效。

OpenAI Codex CLI

设置 OpenAI 基础地址和 API 密钥以使用 StableAPI：

bash
export OPENAI_BASE_URL="apiv1.stableapi.dev/v1"
export OPENAI_API_KEY="sk-your-token"

Gemini CLI

配置 Gemini CLI 使用 StableAPI 的 Google 兼容端点：

bash
export GEMINI_API_BASE_URL="apiv1.stableapi.dev/v1"
export GEMINI_API_KEY="sk-your-token"

AI 工具配置

配置桌面应用和 IDE 插件使用 StableAPI。

Cursor

在 Cursor 设置 → Models → OpenAI API Key 中设置：

  1. 1Base URL：设置为你的 StableAPI 端点
  2. 2API Key：粘贴你的 StableAPI 令牌
  3. 3选择你想使用的模型

Cherry Studio

在 Cherry Studio 中，进入 设置 → API 供应商 → 添加自定义供应商：

  1. 1供应商名称：StableAPI
  2. 2API 基础地址：设置为你的 StableAPI 端点
  3. 3API Key：粘贴你的 StableAPI 令牌
  4. 4点击「获取模型」加载可用模型

Windsurf

在 Windsurf 设置 → AI → 供应商配置中：

  1. 1选择 OpenAI-Compatible 作为供应商
  2. 2将 API 端点设置为你的 StableAPI 基础地址
  3. 3输入你的 StableAPI API 密钥

Continue

在 Continue 配置文件（~/.continue/config.json）中添加供应商：

json
{
  "models": [{
    "title": "StableAPI",
    "provider": "openai",
    "model": "gpt-4o",
    "apiBase": "apiv1.stableapi.dev/v1",
    "apiKey": "sk-your-token"
  }]
}

SDK 示例

常见使用场景的代码示例。

对话补全

基本对话补全请求。

curl -X POST apiv1.stableapi.dev/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-your-token" \
  -d '{
    "model": "gpt-4o",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

流式输出

逐 token 流式返回响应，实现实时输出。

curl -X POST apiv1.stableapi.dev/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-your-token" \
  -d '{
    "model": "gpt-4o",
    "stream": true,
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

文本嵌入

生成文本嵌入向量，用于相似度搜索和 RAG。

curl -X POST apiv1.stableapi.dev/v1/embeddings \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-your-token" \
  -d '{
    "model": "text-embedding-3-small",
    "input": "Hello world"
  }'

图片生成

使用 DALL-E 或 GPT-Image 模型生成图片。

curl -X POST apiv1.stableapi.dev/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-your-token" \
  -d '{
    "model": "gpt-image-1",
    "prompt": "A cute cat sitting on a cloud",
    "n": 1,
    "size": "1024x1024"
  }'

API 端点

所有端点遵循 OpenAI API 格式。

方法路径
POST/v1/chat/completions
POST/v1/embeddings
POST/v1/images/generations
POST/v1/audio/transcriptions
GET/v1/models

可用模型

StableAPI 当前可用的模型。定价详情请查看 定价页面.

加载模型中...

常见问题

支持哪些模型？

我们支持 Claude（Opus、Sonnet、Haiku）、GPT（4o、4.1、o3、o4-mini）、Gemini（2.5 Pro、Flash）、DeepSeek、Qwen 等。请查看上方模型列表或定价页面获取完整列表。

API 格式是否兼容 OpenAI？

是的。StableAPI 完全兼容 OpenAI 格式。任何支持 OpenAI API 的工具或 SDK 都可以通过更改 Base URL 和 API Key 接入 StableAPI。

如何计费？

大多数模型按百万 token 计费（输入和输出分别定价）。部分模型使用按次或按图片计费。详见充值与套餐部分。

可以配合 Claude Code / Codex / Cursor 使用吗？

当然可以。请查看上方的 CLI 工具配置和 AI 工具配置部分，获取逐步配置指南。

钱包余额用完会怎样？

请求将返回 402 错误。在计费页面充值钱包即可恢复使用。

有速率限制吗？

速率限制取决于你的套餐和令牌设置。如需更高限额，请联系支持团队。

错误码

API 返回的常见 HTTP 状态码。

状态码含义
400请求错误
401未授权
402余额不足
403禁止访问
429请求过多
500服务器错误

交互式 API 参考

通过 Swagger 文档交互式探索所有接口。

打开 Swagger 文档