把 AI 能力，
接入你的产品。
modbapi 将 OpenAI、Claude、Gemini 及更多模型统一到一套稳定、清晰、可扩展的 API。本文档会带你完成 Key 创建、客户端配置和第一次成功调用。
创建 Key、复制端点，用最小请求验证链路。
Cursor、Claude Code、Cherry Studio 等。
按状态码与 Request ID 快速定位。
快速开始
只需三分钟，完成从账户到第一条 API 请求。下面的配置适用于大多数 OpenAI 兼容客户端。
登录 modbapi 控制台，在「API Keys」页面创建令牌。建议为不同项目使用独立 Key。
在客户端的 Base URL、API Host 或 Endpoint 字段中填写下方地址。
https://api.modbapi.com/v1模型名称以「模型列表」返回结果为准。先用文本模型验证，再接入图片或长上下文任务。
Base URL：https://api.modbapi.com/v1 · API Key：sk-你的令牌
接口地址与密钥
最容易出错的是地址层级。绝大多数工具只需要填写 Base URL，客户端会自动拼接具体路径。
| 用途 | 请求方式 | 地址 / 示例 |
|---|---|---|
| 模型列表 | GET | /v1/models |
| 文本对话 | POST | /v1/chat/completions |
| Responses API | POST | /v1/responses |
| 图像生成 | POST | /v1/images/generations |
| Claude Messages | POST | /v1/messages |
如果日志中出现 /v1/v1/chat/completions，说明客户端已经自动补全，请将 Base URL 改为 https://api.modbapi.com。
主流工具配置
统一使用 OpenAI Compatible 协议，下面给出常用客户端的准确字段对应关系。
Anthropic-compatible · Base URL 填 https://api.modbapi.com
Settings → Models → Override OpenAI Base URL
供应商选择 OpenAI Compatible
把 baseURL 改为 modbapi 地址即可
通用字段对照
sk-你的令牌https://api.modbapi.com/v1从 /v1/models 选择完整模型名流式与长任务
图片生成、长上下文和 Responses 流式响应耗时更久。请把客户端超时调到 180–300 秒，并保留稳定的连接。
- 文本对话：优先开启
stream: true - 长任务：客户端 timeout 建议 ≥ 180 秒
- 排错时：关闭 stream 做一次对照测试
POST /v1/chat/completions
Authorization: Bearer sk-你的令牌
Content-Type: application/json
{"model":"gpt-4.1-mini","stream":true}SDK 代码示例
modbapi 兼容 OpenAI SDK。只需替换 base_url，即可继续使用熟悉的调用方式。
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":"你好"}])图像生成
文生图与图生图使用独立接口。请求体中的 size 使用英文小写 x，例如 1024x1024。
文生图
POST /v1/images/generations图生图 / 改图
POST /v1/images/edits常见错误
401 Unauthorized确认请求头为 Authorization: Bearer sk-...，并检查令牌是否已禁用。
404 Not FoundOpenAI 兼容客户端先试 https://api.modbapi.com/v1，检查是否重复添加 /v1。
model is required从 /v1/models 复制完整模型名，不要使用展示名称或别名。
no available channel换一个模型重试，或联系管理员检查模型权限与账户额度。
FAQ
OpenAI Compatible 客户端的 Base URL 填什么？+
统一填写 https://api.modbapi.com/v1。如果工具提示会自动添加 /v1，则填写 https://api.modbapi.com。
为什么请求一直超时？+
先确认客户端 timeout 大于 180 秒，并关闭本地代理做一次对照。图片和长响应任务本身需要更长时间。
在哪里查看可用模型？+
发送 GET /v1/models，或登录 modbapi 控制台查看模型广场。接口返回的 ID 才是可调用的完整模型名。