API 文档
所有模型的完整 API 参考文档,开始使用我们的统一 API 接口。
快速开始
基础 URL
https://api.apimodels.app/v1https://apimodels.app/api/v1两个入口是同一套 API、同一把 Key,随时可互换。推荐上面的直连入口:全部生成端点(图片/视频/音频/LLM)由我们的源服务器直接服务,单次请求体上限 100MB。下面的入口继续完整可用,但单次请求体上限约 4.5MB(超出返回 413),上传大图或 base64 会撞到这个边界。
在 SDK 里怎么填
OpenAI 兼容 SDK(openai-python / openai-node / Codex / Cline 等)
https://api.apimodels.app/v1Anthropic SDK / Claude Code(自己会补 /v1)
https://api.apimodels.appbase_url 只填到根地址,不要把完整端点(例如 …/v1/messages 或 …/v1/images/generations)填进去 —— SDK 会在后面再接一段路径,请求就会打到 /v1/messages/chat/completions 这种不存在的地址上。本页各处示例里的 ENDPOINT 是完整端点,直接 curl 用;base_url 用上面这两个。
身份验证
所有 API 请求需要在 Authorization 头中携带 Bearer Token:
Authorization: Bearer YOUR_API_KEY
HTTP 错误码(同步请求)
200成功
400请求参数错误
401API 密钥无效或缺失
402积分不足
404资源不存在
429请求频率超限
500服务器内部错误
生成失败码(异步任务)
异步任务失败时,查询返回 state="failed" 以及标准化的 failCode、人类可读的 failMsg,和布尔字段 retryable —— 客户端据此决定是「重试 / 切换模型」还是「修改提示词 / 输入 / 充值」。
CONTENT_MODERATION内容 / 版权 / 安全审核拒绝not retryable
INVALID_INPUT参数错误、不支持的取值、格式 / 尺寸 / 时长不合法not retryable
INSUFFICIENT_BALANCE积分不足not retryable
UPSTREAM_BUSY上游繁忙 / 限流 / 临时网络或 5xxretryable
UPSTREAM_FAILED上游生成失败(通用,通常可重试)retryable
TIMEOUT任务超时retryable
INTERNAL_ERROR平台内部错误retryable
OTHER未识别的错误(兜底类别,按可能可重试处理)retryable
API 参考
接入 AI 客户端
在 Cherry Studio、Cursor、ChatBox、LobeChat、NextChat 里用一个 key 调用全部模型
Cherry StudioCursorChatBoxLobeChatNextChat
查看文档
图片生成
使用 AI 模型生成和编辑图片
GPT Image 2.5Nano Banana ProFLUX.2 Klein
查看文档
视频生成
使用动作控制生成视频
Seedance 2.0Veo 3.1MiniMax H3
查看文档
语言模型
Claude、GPT、Gemini 等,按 Token 计费
ClaudeGPT-6Gemini
查看文档
语音模型
ElevenLabs 和 Minimax 文字转语音
ElevenLabs TTSMinimax TTS音色复刻
查看文档
音色与复刻
列出音色、复刻/设计你自己的音色
音色列表音色复刻
查看文档
账户余额
用 API 查询账户可用余额
GET /api/v1/balance
查看文档