mmodbapiHELP CENTER
服务状态打开控制台 ↗
UNIFIED AI API GATEWAY v1.0

把 AI 能力，
接入你的产品。

modbapi 将 OpenAI、Claude、Gemini 及更多模型统一到一套稳定、清晰、可扩展的 API。本文档会带你完成 Key 创建、客户端配置和第一次成功调用。

开始接入 ↓查看 API 参考 →
40+模型提供商
99.9%API 可用性
1 个统一接口
01
先跑通一次调用

创建 Key、复制端点，用最小请求验证链路。

↗02
配置你的工具

Cursor、Claude Code、Cherry Studio 等。

↗03
遇到问题？

查看 Claude Code、Codex、Gemini 等工具的排错答案。

↗04
开始推广

复制推广链接，查询佣金并了解提现条件。

↗
01 / QUICK START

快速开始

只需三分钟，完成从账户到第一条 API 请求。下面的配置适用于大多数 OpenAI 兼容客户端。

01
创建 API Key

登录 modbapi 控制台，在「API Keys」页面创建令牌。建议为不同项目使用独立 Key。

02
设置 Base URL

在客户端的 Base URL、API Host 或 Endpoint 字段中填写下方地址。

https://api.modbapi.com/v1
03
选择模型并发送请求

模型名称以「模型列表」返回结果为准。先用文本模型验证，再接入图片或长上下文任务。

✓
推荐的最小配置

Base URL：https://api.modbapi.com/v1　·　API Key：sk-你的令牌

02 / API BASICS

接口地址与密钥

最容易出错的是地址层级。绝大多数工具只需要填写 Base URL，客户端会自动拼接具体路径。

用途请求方式地址 / 示例
模型列表GET/v1/models
文本对话POST/v1/chat/completions
Responses APIPOST/v1/responses
图像生成POST/v1/images/generations
Claude MessagesPOST/v1/messages
!
不要重复拼接 /v1

如果日志中出现 /v1/v1/chat/completions，说明客户端已经自动补全，请将 Base URL 改为 https://api.modbapi.com。

03 / TOOLING

主流工具配置

统一使用 OpenAI Compatible 协议，下面给出常用客户端的准确字段对应关系。

✦
Claude Code

Anthropic-compatible · Base URL 填 https://api.modbapi.com

→⌁
Cursor

Settings → Models → Override OpenAI Base URL

→◆
Cherry Studio

供应商选择 OpenAI Compatible

→{ }
SDK / curl

把 baseURL 改为 modbapi 地址即可

→

通用字段对照

API Key / Tokensk-你的令牌
Base URL / API Hosthttps://api.modbapi.com/v1
Model / Model ID从 /v1/models 选择完整模型名
04 / RELIABILITY

流式与长任务

图片生成、长上下文和 Responses 流式响应耗时更久。请把客户端超时调到 180–300 秒，并保留稳定的连接。

  • 文本对话：优先开启 stream: true
  • 长任务：客户端 timeout 建议 ≥ 180 秒
  • 排错时：关闭 stream 做一次对照测试
curl
POST /v1/chat/completions
Authorization: Bearer sk-你的令牌
Content-Type: application/json

{"model":"gpt-4.1-mini","stream":true}
05 / SDK EXAMPLES

SDK 代码示例

modbapi 兼容 OpenAI SDK。只需替换 base_url，即可继续使用熟悉的调用方式。

python
from openai import OpenAI\n\nclient = OpenAI(api_key="sk-你的令牌", base_url="https://api.modbapi.com/v1")\nresponse = client.chat.completions.create(model="gpt-4.1-mini", messages=[{"role":"user","content":"你好"}])
06 / IMAGE API

图像生成

文生图与图生图使用独立接口。请求体中的 size 使用英文小写 x，例如 1024x1024。生图请求尽量直连 API 域名，减少控制台域名转发带来的额外延迟。

✓
查看当前后端 API 域名

点击下方按钮读取后端配置的线路和 API 地址；列表中的地址可直接打开。

TEXT TO IMAGE

文生图

POST /v1/images/generations
IMAGE TO IMAGE

图生图 / 改图

POST /v1/images/edits
curl · gpt-image-2
curl --location 'https://api.aqqq.shop/v1/images/generations' \\
  --header 'Authorization: Bearer YOUR_IMAGE_GROUP_API_KEY' \\
  --header 'Content-Type: application/json' \\
  --data '{
    "prompt": "一位气质优雅的年轻女性",
    "model": "gpt-image-2",
    "size": "1024x1024",
    "response_format": "url"
  }'
response_format: url
{
  "data": [{"url": "https://demo.com/37b22c83-8db1-46bf-b70a-97bb59977660.png"}],
  "created": 1788234879,
  "size": "1024x1024",
  "usage": {
    "input_tokens": 10,
    "output_tokens": 765,
    "total_tokens": 775,
    "input_tokens_details": {"text_tokens": 10, "image_tokens": 0},
    "output_tokens_details": {"text_tokens": 0, "image_tokens": 765}
  }
}
!
Codex 地址提示

使用 Codex 时，Base URL 需要在域名后加上 /v1，例如 https://api.aqqq.shop/v1 ↗。普通 SDK 若会自动拼接 /v1，则只填写 API 域名。

06 / TROUBLESHOOTING

常见错误

401 Unauthorized
Key 无效或认证头缺失

确认请求头为 Authorization: Bearer sk-...，并检查令牌是否已禁用。

404 Not Found
Base URL 层级不正确

OpenAI 兼容客户端先试 https://api.modbapi.com/v1，检查是否重复添加 /v1。

model is required
请求体缺少模型

从 /v1/models 复制完整模型名，不要使用展示名称或别名。

no available channel
当前没有可用上游

换一个模型重试，或联系管理员检查模型权限与账户额度。

07 / FAQ

FAQ

OpenAI Compatible 客户端的 Base URL 填什么？+

统一填写 https://api.modbapi.com/v1。如果工具提示会自动添加 /v1，则填写 https://api.modbapi.com。

为什么请求一直超时？+

先确认客户端 timeout 大于 180 秒，并关闭本地代理做一次对照。图片和长响应任务本身需要更长时间。

在哪里查看可用模型？+

发送 GET /v1/models，或登录 modbapi 控制台查看模型广场。接口返回的 ID 才是可调用的完整模型名。