APIMODELSAPIMODELS
API 文档

apimodels.app

API 文档

所有模型的完整 API 参考文档,开始使用我们的统一 API 接口。

快速开始

1

获取 API 密钥

在控制台创建 API 密钥 控制台

2

发起 API 请求

使用 Bearer Token 进行身份验证

3

按量付费

仅对成功请求扣费。余额单位为美元(USD)

基础 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/v1
Anthropic SDK / Claude Code(自己会补 /v1)https://api.apimodels.app

base_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