本文的依据有四类:APIMODELS 自己数据库里 2026 年 9 月 22 日到 10 月 21 日(UTC)30 天的生产记录,10 月 22 日读取;它的官网、文档、条款和公开模型列表,10 月 21 日和 22 日核对;各厂商的官方价格页;以及本系列其他中转站的测评。APIMODELS 是我们自己的产品,和 GenGrades 出自同一团队,GenGrades 自己的内容后台就跑在 hub.apimodels.app 上。正因为如此,本文才能公开它的生产数据,每个数字都写明了是怎么统计的。目前还没有第三方发布过 APIMODELS 的评测或基准测试,下面所有稳定性数字都来自 APIMODELS 自己。
先说结论
APIMODELS 是一家在价格和稳定之间做了取舍的 AI API 中转站:它不追求每个模型都卖得最便宜,而是把一部分利润花在让请求活下来上。它用一个 API Key、一份预付的美元余额,提供约 150 个对话、图片、视频、音频和向量模型,价格自定。本文比较的大多数模型上,它比厂商官方价低 10% 到约 90%;少数模型别家更便宜,也有少数比官方还贵。
这部分利润换来的是冗余。热门模型都接了不止一条上游渠道:请求遇到报错、限流或任务卡住,会自动转到下一条渠道,你的代码什么都不用做;所有渠道都失败的请求,一分钱不收。截至 10 月 21 日的 30 天里,去掉被内容审核拒绝的请求后,802,328 次请求的成功率是 98.62%。语言模型 99.63%,向量模型 99.97%。视频是短板,只有 90.93%;10 月 4 日那一天,全站跌到了 85.90%。
小团队得到的第二样东西是存储。每一个生成的图片、视频、音频文件,以及你上传的每一个文件,都由 APIMODELS 自己的存储提供 30 天。这段时间足够把结果链接直接交给你的应用、客户或社交媒体排期工具,不用自己维护存储桶。
适合:想用一张账单调用多种模型、用银行卡、PayPal、支付宝或 USDT 付款、希望某个上游出问题一小时也不影响业务的团队。不适合:需要有地址和适用法律的签约公司、零数据保留、批量价或公开状态页的团队。
一次请求看懂 APIMODELS
APIMODELS 位于你的代码和运行模型的公司之间。你持有一个 API Key 和一份余额;APIMODELS 持有上游账户,并决定每个请求由哪条渠道处理。所有接口都在同一个 Base URL https://api.apimodels.app/v1 下:
| 你要做什么 | 端点 | 结果怎么返回 |
|---|
| 对话和推理,OpenAI 格式 | POST /v1/chat/completions、POST /v1/responses | 在同一个响应里返回,可流式 |
| 对话,Anthropic 格式 | POST /v1/messages | 在同一个响应里返回;Claude Code 用的就是它 |
| 对话,Gemini 格式 | Gemini generateContent 路径 | 在同一个响应里返回 |
| 向量 | POST /v1/embeddings | 在同一个响应里返回 |
| 图片 | POST /v1/images/generations | 先返回任务 ID,再通过轮询或回调拿到链接;传 OpenAI 风格的 size 且不带回调地址时,一次阻塞调用直接拿图 |
| 视频 | POST /v1/video/generations | 先返回任务 ID,再通过轮询或回调拿到链接 |
| 音频和语音 | POST /v1/audio/generations | 视模型而定,返回任务 ID 或链接 |
| 任意一次调用的花费 | GET /v1/records/{id} | 实际结算的美元金额,免费 |
每个请求走的路径都一样。APIMODELS 先检查余额够不够,并冻结这次请求的价格;然后把请求发给该模型登记的第一条上游渠道。如果这条渠道报错、限流,或者在时限内没有响应,请求就转到下一条渠道。拿到结果后,冻结的金额才真正扣掉;所有渠道都失败时,冻结解除,不扣任何费用。媒体结果会复制到 APIMODELS 自己的存储,所以上游自己的链接过期后,你拿到的链接仍然能用。
你传的模型名决定你用的模型。少数模型另有单独命名的低价线路,标着 Lite、budget 或 Dreamina,每个线路的页面都写明了和标准版的区别:分辨率、速度、审核,还有一条线路是 APIMODELS 会去掉的水印。
价格与稳定:APIMODELS 站在哪里
APIMODELS 的定价走中间路线。它的首页标语写「比官方低最多 95%」;同一页的对比表显示节省 10% 到 63%,本文比较的模型里最大降幅约 90%。下表价格单位为美元,来自它的价格页和各模型页、Anthropic、OpenAI、Google(2026 年 10 月 19 日更新)、DeepSeek,以及 OpenRouter 和 Kie.ai 的测评:
| 模型与计价单位 | APIMODELS | 厂商官方价 | OpenRouter | Kie.ai |
|---|
| Claude Opus 5.5,每百万输入 / 输出 token | 2.40 / 12 | 4 / 20(批量价 2 / 10) | 4 / 20,充值另加 5.5% | 1.60 / 8.00 |
| GPT-6 Astra,每百万输入 / 输出 token | 2.40 / 12 | 10 / 50 | 未比较 | 未比较 |
| Gemini 4 Argon,每百万 token,11 月 30 日前 | 1.10 / 5.50 | 2 / 10,之后 4 / 20 | 2 / 10 | 未比较 |
| DeepSeek V4.1 Flash,每百万 token,高峰时段 | 0.27 / 1.08 | 0.30 / 1.20 | 按服务方 0.024 / 0.375 到 0.60 / 2.40 | 未比较 |
| Veo 3.1,8 秒 1080p 带音频 | 1.00 | 3.20 | 未比较 | 1.275 |
| Veo 3.1 Fast,8 秒 720p | 0.08 | 0.80 | 未比较 | 0.30 |
| Nano Banana Pro,一张 1K 或 2K 图 | 0.068 | 0.134 | 未比较 | 0.09 |
| Nano Banana Pro,一张 4K 图 | 0.13 | 0.24 | 未比较 | 0.12 |
从这张表能看出三件事。第一,节省是真的,但幅度不均:DeepSeek V4.1 Flash 低 10%,Claude Opus 5.5 低 40%,Nano Banana Pro 低约 50%,Veo 低 69% 到 90%。第二,APIMODELS 不是最低价。Kie.ai 的 Claude Opus 5.5 和 4K Nano Banana Pro 更便宜,Replicate 的 Seedance 2.0 720p 每秒 $0.18,APIMODELS 是 $0.197(它的 Seedance 页面)。第三,少数价格高于官方:它的标准版 Seedance 2.0 Mini 在 480p 和 720p 每秒 $0.044 和 $0.095,而它自己 Seedance 页面引用的 BytePlus 官方价是 $0.040 和 $0.080;Claude Sonnet 5.5 的缓存读取每百万 token $0.12,Anthropic 官方是 $0.10,它的 Claude 价格页却还写着官方 $0.20。
对于不着急的任务,厂商自己的批量价也能持平甚至更低:Anthropic 的 Opus 5.5 批量价 $2 / $10,OpenAI 的 GPT-6.1 Sol 批量价 $1 / $5。APIMODELS 没有批量接口。
中间价位换来了什么?对多数用户来说,答案在下一节:备用渠道,以及围绕它做的工程。每个模型只接一条渠道的转售商,可以在这个模型上把价格压得更低;可一旦那条渠道过载,它的用户只能等,或者直接失败。
一个月要花多少钱。 按上表价格算三种用量,并和厂商官方价对比:
| 每月用量 | APIMODELS | 厂商官方价 | 差额 |
|---|
| 基于 Claude Opus 5.5 的编程助手:5,000 万输入 token、500 万输出 token | $180 | $300 | 省 $120 |
| 商品图工具:2 万张 1K 的 Nano Banana Pro | $1,360 | $2,680 | 省 $1,320 |
| 短视频应用:300 条 Veo 3.1,8 秒 1080p | $300 | $960 | 省 $660 |
这里没算提示词缓存(两边都会更便宜),也没算大额充值多送的 2% 到 5%(只会让 APIMODELS 这边更便宜)。
稳定性:30 天生产记录
怎么统计的。 APIMODELS 处理的每一次 API 调用都有一条记录,写着模型、最终状态,失败时还有失败码。这里统计的是 2026 年 9 月 22 日到 10 月 21 日之间,按 UTC 自然日,所有走到最终状态的请求,成功的和失败的都算。被上游内容安全系统拒绝的请求排除在外,因为它们本来就该失败,换成厂商官方也一样会失败;这类请求共 20,723 次。其余失败全部算作失败,包括参数填错的请求,所以这个成功率比一个写对了的请求实际遇到的还要保守。
总体数字。 802,328 次请求,791,269 次成功:98.62%。日成功率的中位数是 98.83%。30 天里有 23 天在 98% 以上,12 天在 99% 以上。最近 7 天是 99.48%,最近 14 天是 99.36%。每日请求量从 9,132 次到 105,015 次不等,平均每天 27,435 次。
| 日期(UTC) | 请求数 | 审核拒绝(已排除) | 失败 | 成功率 |
|---|
| 9 月 22 日 | 9,132 | 588 | 85 | 99.01% |
| 9 月 23 日 | 10,076 | 473 | 143 | 98.51% |
| 9 月 24 日 | 9,399 | 649 | 166 | 98.10% |
| 9 月 25 日 | 10,401 | 1,113 | 421 | 95.47% |
| 9 月 26 日 | 10,150 | 648 | 286 | 96.99% |
| 9 月 27 日 | 15,077 | 706 | 181 | 98.74% |
| 9 月 28 日 | 13,719 | 763 | 180 | 98.61% |
| 9 月 29 日 | 14,181 | 679 | 134 | 99.01% |
| 9 月 30 日 | 18,469 | 813 | 352 | 98.01% |
| 10 月 1 日 | 18,353 | 1,143 | 1,138 | 93.39% |
| 10 月 2 日 | 15,894 | 907 | 481 | 96.79% |
| 10 月 3 日 | 13,696 | 997 | 494 | 96.11% |
| 10 月 4 日 | 18,840 | 643 | 2,566 | 85.90% |
| 10 月 5 日 | 22,272 | 797 | 266 | 98.76% |
| 10 月 6 日 | 45,375 | 936 | 94 | 99.79% |
| 10 月 7 日 | 33,635 | 685 | 658 | 98.00% |
| 10 月 8 日 | 23,883 | 502 | 356 | 98.48% |
| 10 月 9 日 | 20,646 | 773 | 219 | 98.90% |
| 10 月 10 日 | 20,237 | 675 | 211 | 98.92% |
| 10 月 11 日 | 18,054 | 506 | 123 | 99.30% |
| 10 月 12 日 | 22,107 | 674 | 151 | 99.30% |
| 10 月 13 日 | 27,389 | 813 | 126 | 99.53% |
| 10 月 14 日 | 22,606 | 492 | 235 | 98.94% |
| 10 月 15 日 | 55,650 | 887 | 1,193 | 97.82% |
| 10 月 16 日 | 23,204 | 480 | 138 | 99.39% |
| 10 月 17 日 | 71,680 | 422 | 53 | 99.93% |
| 10 月 18 日 | 40,599 | 295 | 60 | 99.85% |
| 10 月 19 日 | 44,911 | 573 | 250 | 99.44% |
| 10 月 20 日 | 105,015 | 565 | 183 | 99.82% |
| 10 月 21 日 | 48,401 | 526 | 116 | 99.76% |
几个差的日子,原因是什么。 每一次下跌,主要都能追到某一个模型的上游:
- 10 月 4 日,85.90%。 当时调用量最大的图片模型之一 GPT Image 2.5 Flare 有 1,567 次返回「繁忙」,GPT Image 2.5 Sunburst 有 230 次;另有 495 次 Flare 请求因参数无效失败。
- 10 月 1 日,93.39%。 Gemini 3.1 Flash Image 预览版的上游有 913 次请求失败。
- 9 月 25 日,95.47%。 Veo 3.1 Fast 1080p 有 312 次返回「繁忙」。
- 10 月 15 日,97.82%。 Qwen3.8 Flash 有 459 次触发上游限流。
对用户来说,结论和总数一致:语言模型和向量模型几乎不受影响,风险集中在新上线或热门、上游容量容易用完的媒体模型上。
按模型类型。 同样的 30 天,两列都不含审核拒绝;出结果的耗时按截至 10 月 22 日 7 天里成功的请求统计:
| 模型类型 | 请求数 | 成功率 | 中位耗时 | 九成请求在多久内完成 |
|---|
| 语言模型 | 446,941 | 99.63% | 1.2 秒 | 23.6 秒 |
| 文生图 | 245,705 | 96.98% | 53.1 秒 | 147.4 秒 |
| 向量 | 78,887 | 99.97% | 0.3 秒 | 0.7 秒 |
| 文生视频 | 16,201 | 90.93% | 169.8 秒 | 337.8 秒 |
| 文本转语音 | 8,636 | 96.27% | 1.7 秒 | 8.6 秒 |
| 图片编辑 | 5,806 | 97.09% | 4.2 秒 | 16.4 秒 |
图片生成被内容审核拒绝的次数最多,30 天里有 19,161 次,所以在图片模型上,用户看到的原始成功率很大程度上取决于提示词。
按模型。 调用量最大的模型,统计口径相同(不含审核拒绝):
| 模型 | 请求数(30 天) | 成功率 | 中位耗时 | 九成请求在多久内完成 |
|---|
| gpt-image-2 | 93,801 | 99.71% | 66.7 秒 | 189.3 秒 |
| text-embedding-3-large | 78,737 | 99.97% | 0.3 秒 | 0.7 秒 |
| gemini-3-flash-preview | 52,380 | 99.99% | 2.5 秒 | 7.8 秒 |
| deepseek-v4-flash | 50,706 | 99.87% | 6.7 秒 | 26.5 秒 |
| gpt-image-2.5-flare | 35,119 | 90.42% | 33.6 秒 | 81.1 秒 |
| gpt-image-2-all | 34,633 | 99.15% | 50.2 秒 | 167.5 秒 |
| deepseek-v4.1-flash | 34,323 | >99.99% | 9.6 秒 | 39.6 秒 |
| gpt-6-luna | 31,846 | 98.78% | 11.2 秒 | 50.2 秒 |
| gpt-5.6-luna | 31,074 | 99.86% | 5.7 秒 | 27.8 秒 |
| gpt-image-2.5-sunburst | 24,163 | 98.25% | 42.5 秒 | 144.4 秒 |
| claude-haiku-4-5-20251001 | 17,107 | 99.85% | 2.2 秒 | 6.5 秒 |
| nano-banana-2-1 | 16,786 | 99.55% | 35.3 秒 | 72.3 秒 |
| qwen3.8-flash | 14,801 | 96.48% | 30.2 秒 | 128.7 秒 |
| claude-sonnet-5 | 10,662 | 99.91% | 10.3 秒 | 61.0 秒 |
| gpt-6-sol | 9,420 | 99.69% | 17.2 秒 | 136.1 秒 |
| claude-haiku-5-5 | 8,493 | 99.88% | 8.5 秒 | 18.8 秒 |
视频和语音模型的调用量小得多,所以成功率每周的波动也更大:
| 模型 | 请求数(30 天) | 成功率 | 中位耗时 | 九成请求在多久内完成 |
|---|
| minimax-h3-lite | 5,018 | 96.71% | 152.8 秒 | 303.1 秒 |
| veo-3.1-fast-fhd | 4,197 | 83.23% | 213.0 秒 | 372.8 秒 |
| eleven-tts-v3 | 2,450 | 99.59% | 0.5 秒 | 0.9 秒 |
| minimax-speech-2.8-hd | 1,591 | 99.25% | 5.2 秒 | 6.5 秒 |
| eleven-tts-multilingual | 1,570 | 98.03% | 1.1 秒 | 2.1 秒 |
| gemini-omni-video | 1,289 | 94.72% | 95.2 秒 | 298.3 秒 |
| seedance-2-5 | 997 | 96.99% | 194.7 秒 | 375.4 秒 |
| gemini-omni-1.1-flash | 750 | 94.13% | 66.4 秒 | 266.1 秒 |
| dreamina-seedance-2-0-mini | 476 | 96.01% | 154.1 秒 | 191.1 秒 |
| wan-3.0-video | 424 | 98.35% | 161.4 秒 | 965.1 秒 |
| veo-3.1-fast-hd | 330 | 96.67% | 116.4 秒 | 189.5 秒 |
可以把这张分模型的表当作上生产时的选型参考。GPT Image 2、Nano Banana 2.1 和 GPT Image 2 All 都在 99% 以上;GPT Image 2.5 Flare 扛下了 10 月 4 日那次过载。视频方面,MiniMax H3 Lite 和 Seedance 2.5 接近 97%,而 Veo 3.1 Fast 1080p 只有 83% 左右,用它的话最好在你自己的代码里准备一个备选模型。
故障切换实际起了多大作用。 每一条失败的渠道都会记下终止它的错误和接手的渠道。截至 10 月 22 日上午(UTC)的 48 小时里,18,736 次成功的图片生成中有 2,770 次,2,473 次成功的语音请求中有 90 次,1,262 次成功的视频中有 13 次,都是第一条渠道失败后由备用渠道完成的。最常触发切换的错误依次是上游 503、「繁忙」响应、429 限流,以及超过当前渠道时限还没完成的任务。如果没有故障切换,这些请求第一次就会以报错的形式返回给调用方。
失败的请求要花多少钱。 一分不花。请求开始时冻结价格,只有成功才扣费。随机抽查 APIMODELS 的扣费流水:60 次成功请求全部有对应的扣费,120 次失败请求一笔都没有,其中包括被审核拒绝的请求。失败记录里会保留它本来要收的价格,但不会从余额里扣钱。
这些数字说明不了什么。 这是 APIMODELS 自己的记录,由运营它的团队读取。没有公开的状态页,也没有第三方核对;本系列里也没有别的中转站以同样的形式公布每日数据,所以没法和 OpenRouter 或 Kie.ai 排名比较。数字也按设计排除了审核拒绝。首页的「98.9% Uptime」其实是成功率,不是可用率,而这 30 天全站的成功率略低于这个数。
按耗时规划你的集成
上面的耗时表就是你的设计依据:
- 对话。 一半的语言模型请求在 1.2 秒内完成,九成在 24 秒内。长回答用流式;GPT-6 Sol 这类推理模型在大提示词上可能超过两分钟。
- 图片。 一半在 53 秒内完成,九成在两分半左右。它的 GPT Image 2 FAQ 建议阻塞式图片调用的客户端超时至少设 180 秒。面向用户的功能,先建任务、马上返回给用户,再通过回调取图。
- 视频。 一半在 3 分钟内完成,九成在 6 分钟内;Wan 3.0 最慢的一成超过 16 分钟。不要为视频一直挂着 HTTP 请求。每 5 到 10 秒轮询一次,或者更好的办法是传
callback_url。
- 回调。 任务完成后,APIMODELS 会把结果 POST 到你的
callback_url,每轮最多尝试 3 次,每次 10 秒超时;没送达的回调在任务完成后 30 分钟内继续退避重试。你的接口宕机更久的话,仍然可以按 ID 查询任务。
- 编程 Agent。 MCP 服务器每次调用最多等 50 秒,然后交回任务 ID,所以 Codex 这类有 60 秒工具时限的客户端不会丢掉耗时长的渲染。
存储:自带 30 天文件托管
APIMODELS 把它生成的文件和你上传的文件存在 Cloudflare R2 上,域名是 r2.apimodels.app,它的隐私政策和文档写明这些文件 30 天后删除。为了把你提供的链接交给模型而临时获取的媒体文件,3 天后删除。10 月 22 日从它的记录里抽取的结果链接印证了这一点:3、8、12、20、26、29 天前生成的文件都能打开,32 天和 40 天前生成的文件返回 404。
对小团队来说,这等于省掉了一块基础设施。生成文件、复制到自己的存储桶、配 CDN、管理删除,这一整套流程,对大多数短期内容都不需要了:
- 直接交给用户。 网页应用可以直接显示结果链接,它由 Cloudflare 提供。
- 交给其他服务。 社交媒体排期工具、CMS、n8n 工作流或聊天机器人,都可以在 30 天内取用链接。
- 发给客户审稿。 代理公司把链接发给客户确认,只保存最终通过的文件。
- 用一个模型的结果喂下一个模型。 生成的图片可以直接作为视频模型的首帧,因为 APIMODELS 能读取自己的链接。
- 输入文件只传一次。
POST /v1/files 返回一个 10 分钟内有效的上传地址,以及一个保留 30 天的公开地址,同一张参考图可以在多次生成里反复使用。
两点提醒。需要保存超过 30 天的东西,比如商品图库、已发布的视频或合规存档,要在期限内复制到你自己控制的存储。另外,这些链接没有访问控制:它们用的是很长的随机 ID,但拿到链接的人都能打开文件,所以不要靠它们存放私密内容。你克隆的音色和保存的 Seedance 角色是另一回事,它们随账户保留。
存储不单独收费,你只为生成付钱。
计费细节
APIMODELS 是预付费。你往一份余额里充美元,所有模型都从这份余额里扣:
- 充值。 最低 $10。$50、$100、$500 和 $1,000 档分别多送 2%、3%、4% 和 5%(它的 fal 对比页),$10 到 $1,000 之间的任意整数金额也可以充,按低一档的比例赠送。
- 付款方式。 Stripe 银行卡、PayPal、支付宝(按当日汇率收人民币)或 USDT。银行卡付款会自动开发票。
- 自动充值。 余额不足时可以自动用已保存的银行卡充值。
- 没有订阅,也没有每月最低消费。
- 试用额度。 新账户一次性送 $0.10,前提是用 Gmail、Outlook 这类个人邮箱的 Google 账户或支付宝注册,而且同一 IP 地址 48 小时内只有一个新账户能拿到。这点额度够跑几张图或一段简短对话来确认接入,不够做规模化评估。
- 每次调用的花费。 语言模型的响应带
x-apimodels-request-id,非流式响应还带 x-apimodels-cost。任何请求 ID 或任务 ID 都可以用 GET /v1/records/{id} 免费查询(计费文档)。
- 退款。 它的服务条款写明已消耗的额度不退,充值的额度「一般不予退款」,重复扣费和计费错误可以发邮件到 support@apimodels.app 核实。条款没写额度会不会过期。
提示词缓存:越用越省
编程 Agent 和对话产品每一轮都会重发同一段很长的前缀:系统提示词、代码库、文档。提示词缓存让这段重复前缀按输入价的一小部分计费,APIMODELS 也支持:Anthropic 格式的请求可以带 cache_control,OpenAI 和 Gemini 模型在上游自动缓存,每次调用命中缓存的部分都会出现在用量里,也能在 GET /v1/records/{id} 里看到。下表是每百万 token 的缓存输入价,来自它的 llms.txt 和各厂商价格页,10 月 22 日核对:
| 模型 | APIMODELS 缓存输入 | 厂商缓存输入 | 差别 |
|---|
| GPT-6 Astra | 0.24 | 1.00 | 低 76% |
| GPT-6 Sol | 0.10 | 0.20 | 低 50% |
| GPT-6.1 Sol | 0.05 | 0.10 | 低 50% |
| Claude Opus 5.5 | 0.12 | 0.20 | 低 40% |
| Claude Fable 5.1 | 0.22 | 0.25 | 低 12% |
| Claude Haiku 5.5 | 0.009 | 0.01 | 低 10% |
| GPT-6 Luna | 0.009 | 0.01 | 低 10% |
| Claude Sonnet 5.5 | 0.12 | 0.10 | 高 20% |
有两个细节比这张表更重要。Anthropic 写入 1 小时缓存比写入 5 分钟缓存贵;APIMODELS 两档按同一个缓存写入价计费,所以选 1 小时缓存不额外花钱(它的大模型文档)。另外,缓存的前缀必须一字不差:提示词开头放了时间戳,或者工具列表换了顺序,都会导致缓存失效,所以会变的内容要放在最后。
拿一轮典型的 Claude Code 请求算一下:5 万输入 token,其中 4 万命中缓存,输出 3,000 token。Claude Opus 5.5 按 Anthropic 官方价每轮约 $0.108,在 APIMODELS 上约 $0.065。一个工作日跑几百轮,这个差价就是备用渠道的成本来源。
在 APIMODELS 上怎么选模型
它的模型库在 2026 年 10 月 22 日有 151 个模型:语言 50 个、视频 43 个、图片 33 个、音频 23 个、向量 2 个。它的公开模型列表在 10 月 21 日返回 158 个 ID,因为别名和渠道变体也算在内。几个习惯能让模型库更好用:
- 默认用标准 ID,除非线路页面另有说明。 Lite、budget 和 Dreamina 线路更便宜,是因为它们走不同的渠道;换之前先看清区别。
- 按稳定性表选,而不只看价格。 生产环境的图片,GPT Image 2 和 Nano Banana 2.1 都在 99.5% 以上;视频方面,MiniMax H3 Lite 和 Seedance 2.5 接近 97%。
- 视频在你自己的代码里准备第二个模型。 APIMODELS 内部的故障切换只在同一个模型的不同渠道之间进行,不会把你的请求换成另一个模型。
- 放量前先看模型页的价格。 媒体模型的价格取决于分辨率、时长和画质,少数线路比官方贵。
接入代码
任何 OpenAI SDK 改一下 Base URL 就能用:
from openai import OpenAI
client = OpenAI(base_url="https://api.apimodels.app/v1", api_key="YOUR_APIMODELS_KEY")
reply = client.chat.completions.create(
model="claude-haiku-5-5",
messages=[{"role": "user", "content": "Summarise this changelog in three bullets: ..."}],
)
print(reply.choices[0].message.content)
带回调的图片任务:
curl -X POST https://api.apimodels.app/v1/images/generations \
-H "Authorization: Bearer $APIMODELS_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "gpt-image-2", "prompt": "Studio photo of a ceramic mug on oak", "aspect_ratio": "1:1",
"callback_url": "https://your-app.example.com/hooks/apimodels"}'
响应是 {"code": 200, "msg": "success", "data": {"taskId": "...", "state": "pending"}};之后回调会把同一个任务连同 state、credits 和 resultUrls 一起 POST 过来。
不用回调的话,就带着任务 ID 轮询同一个端点,直到 state 变成 completed,再读 resultUrls:
curl "https://api.apimodels.app/v1/images/generations?task_id=TASK_ID" \
-H "Authorization: Bearer $APIMODELS_API_KEY"
视频在 /v1/video/generations 上用法相同;Veo 文档演示了用 images 传首帧。错误码就是普通的 HTTP 状态码:Key 错误返回 401,余额不足返回 402,参数无效返回 400。被上游内容安全系统拒绝的请求会返回说明原因的消息,并且不收费。
请求失败了:失败码和处理办法
失败的请求会在 failCode 里返回一个失败码,它的 API 文档写明了哪些值得重试:
| 失败码 | 含义 | 要不要重试 | 怎么处理 |
|---|
| CONTENT_MODERATION | 上游内容安全系统拒绝了提示词或输入图片 | 不要 | 改写提示词或换输入;没有扣费 |
| INVALID_INPUT | 模型不接受的参数、尺寸、格式或时长 | 不要 | 修正请求;模型页列出了可用的取值 |
| INSUFFICIENT_BALANCE | 余额不够这次请求的价格(HTTP 402) | 不要 | 充值,或打开自动充值 |
| UPSTREAM_BUSY | 上游繁忙、限流或短暂无法访问 | 要 | 稍等再试;APIMODELS 已经试过它的备用渠道 |
| UPSTREAM_FAILED | 上游生成失败,通常是暂时的 | 要 | 重试一两次,不行就换模型 |
| TIMEOUT | 任务超过时限 | 要 | 重试;视频可以换更快的模型或缩短时长 |
| INTERNAL_ERROR | APIMODELS 内部出错 | 要 | 重试;反复出现就把任务 ID 发给客服 |
限流规则来自上游服务方,APIMODELS 自己没有公布按 Key 的限流。某条渠道返回 429,和其他渠道错误一样处理:请求会先转到下一条渠道,根本到不了你这里。
内容审核值得单独说,因为它是图片和视频模型上最常见的失败原因。截至 10 月 21 日的 30 天里,上游安全系统拒绝了 19,161 次图片请求,占全部图片请求的 7.2%,以及 1,502 次视频请求,占全部视频请求的 8.5%。这些都没有收费。商品图、风景和插画很少触发审核;真人、未成年人、品牌和任何带暗示的内容经常会被拒,而且每家厂商的规则都不一样。
从 OpenRouter 或官方 API 迁移过来
- 用 OpenAI SDK 的。 把 Base URL 改成
https://api.apimodels.app/v1,换上 Key。模型 ID 用 APIMODELS 自己的,比如 gpt-6.1-sol、claude-opus-5-5 或 gemini-3-flash-preview;完整列表在 GET /v1/models。
- 用 Anthropic SDK 或 Claude Code 的。 Base URL 指向
https://api.apimodels.app,不带路径,因为客户端会自己补上 /v1/messages(它的客户端指南),模型用 claude- 开头的 ID。
- 从 OpenRouter 迁移的。 Base URL 和 Key 照上面改,模型名去掉厂商前缀。OpenRouter 的服务方路由偏好、零数据保留开关和自带 Key 在这里没有对应功能,渠道由 APIMODELS 自己选。
- 从 fal、Replicate 或 Kie.ai 这类媒体平台迁移的。 图片、视频和音频模型都用同一种任务模式:先
POST 创建,再用 task_id 轮询或接收回调。参数名以各模型页为准,所以一个模型一个模型地迁。
- 余额。 各家的额度不能互转,先少量充值,用你自己的真实流量跑几天,再整体切过来。
上线前检查清单
- 每次调用都保存请求 ID 或任务 ID,用
GET /v1/records/{id} 和你自己的用量对账。
- 媒体任务用回调。在回调地址里放一个秘密 token,收到回调后先用你的 Key 查一次任务,确认无误再处理。
- 按耗时表设置客户端超时:对话以秒计,图片以分钟计,视频最多 10 分钟。
- 只对标为可重试的失败码做退避重试;渠道层面的重试已经做过了。
- 每个视频功能都准备第二个模型,关键的图片功能也准备第二个图片模型。
- 需要保存超过 30 天的文件,以及任何私密内容,复制到你自己控制的存储。
- 盯住余额:无人值守的任务打开自动充值,把 402 当成告警而不是崩溃。
- 每个应用或环境用单独的 API Key,这样一个 Key 泄露了可以单独作废,不影响其他服务。
- 长提示词的业务要看缓存命中;缓存 token 突然下降,通常是前缀变了,而不是涨价了。
MCP、Agent Skills 和编程 Agent
- MCP 服务器。 apimodels-mcp(MIT)可以用 npx 在本地运行,也可以用托管版
https://api.apimodels.app/mcp,OAuth 登录后会生成一个专用 Key。9 个工具覆盖余额、模型、对话、图片生成和检查、视频、语音、上传和任务。它已收录进官方 MCP Registry,版本 0.7.0,截至 2026 年 10 月 18 日的 30 天里 npm 下载 1,919 次。API 文档没有提到把 MCP 服务器透传给模型。
- Agent Skills。 apimodels-image skill 用
npx skills add stimQQ/apimodels-skill@apimodels-image 安装;它的目录和文档列出 33 个图片模型,视频和音频 skill 计划中。面向 Claude Code 和 Codex 的 apimodels 插件把 MCP 服务器和一个生成 skill 打包在一起。
- 编程 Agent。 提供 Claude Code(默认 Opus 5.5)、Codex、Gemini CLI、Cursor、OpenClaw、n8n 和 Cherry Studio 的指南。Claude Code 只需要三个环境变量:Base URL、Key 和模型。
- API 格式。 Chat Completions、Responses、带提示词缓存的 Anthropic Messages、Gemini generateContent、向量和媒体异步任务。Claude 的结构化输出返回 400,没有批量接口,也没有自己的 SDK,只有示例代码和一份 llms.txt。
要注意的问题
- 「最高省 95%」。 它自己首页的对比表最高只有 63%;本文比较的模型里,最大降幅约 90%,出现在 Veo 3.1 Fast 上。
- 视频稳定性。 30 天 90.93%,Veo 3.1 Fast 1080p 只有 83%。视频功能要自己做重试,并准备第二个模型。
- 会改动输出的渠道。 它的 Omni Flash(Lite)页面写着这条渠道会在每段视频上打水印,APIMODELS 会去掉,留下淡淡的痕迹。Nano Banana Pro 也在一条「budget channel」上出售。APIMODELS 运营者 2026 年 8 月 29 日的博客提到,早期有一个上游一边报告成功、一边返回质量更差的视频,并说现在每条渠道都会和官方输出做对比检查。
- 安全条款和在售模型。 它的服务条款写本服务遵循上游提供商的规则、「不绕开其安全限制」,但它在卖标着「Relaxed Moderation」的 Spicy 版本,Seedance 页面也写着上游拒绝的真人照片「会自动登记并重试」。
- 地区。 它说自己的 API 在中国大陆不用代理就能访问。中国大陆既不在 Anthropic 支持的地区,也不在 OpenAI 支持的国家名单里,OpenAI 还警告在名单之外提供访问可能导致账号被封。
- 没有解释的价格。 它的 Veo 3.1 Fast HD 页面把结果写成「720p VEO-style 8s output」,也没有解释为什么比 Google 低 90%。
隐私、条款和运营方
它的服务条款和隐私政策2026 年 10 月 22 日生效,写明运营方是美国公司 PIXLUME LLC,但没有地址和适用法律。首页的商务联系邮箱是个人 Gmail;联系页列的是 support@ 和 business@apimodels.app。MCP 和 skill 的代码放在个人 GitHub 账号下。8 月那篇博客说,运营者自己不会写代码,所有代码都是 AI 编程 Agent 写的。
隐私政策写明它保存的内容:Google 或支付宝的登录信息、注册和登录时的 IP 地址、访客第一次从哪里来到本站,以及每一次调用的记录,包括提示词。结果和上传文件 30 天后删除;调用记录随账户保留、目前不自动删除,超过 30 天的记录还会另存一份归档,保留一年。没有零数据保留选项,也不能选上游服务方。充值的额度「一般不予退款」,没有状态页。
用户怎么说
没有找到用户对 APIMODELS 的讨论:Hacker News 上没有人提交过 apimodels.app,它的 Product Hunt 页面没有评价,只有 1 个赞,还写着三个不同的模型数量(200+、110+ 和 60+)。有一个开源项目 infOS 把 APIMODELS 加成了图片和视频服务方,它的说明写着还没有跑过真实的 API 调用。APIMODELS 自己的记录显示,97% 的调用来自 API Key,而不是官网的在线体验,所以本页的数字反映的是 API 的实际使用,而不是网站上的随手试用。
和 OpenRouter、Kie.ai 以及媒体平台比
- OpenRouter 按官方价收费、充值另加 5.5%,但公司主体明确,可以选服务方,提供零数据保留,也有状态页。语言模型重视合规多于价格时选它。
- Kie.ai 的 Claude Opus 5.5 更便宜,Veo 更贵,写明由丹佛的两家 LLC 运营。只追求最低媒体价格时选它。
- fal、Replicate 和 WaveSpeedAI 的 Veo 和 Nano Banana Pro 按 Google 官方价或更高收费,但都有状态页。媒体业务需要有名有姓的服务方和公开的可用率时选它们。
- APIMODELS 在中间:多数模型低于官方价,但不是每个都最低,故障切换、按次查花费和 30 天文件托管都是自带的。
十分钟上手
- 在 apimodels.app 用 Google 或支付宝登录;个人 Google 账户和支付宝注册会送 $0.10 试用额度。
- 在控制台创建一个 API Key。
- 用任意 OpenAI SDK 指向
https://api.apimodels.app/v1 发一次对话请求,再用 GET /v1/records/{id} 查这次请求花了多少钱。
- 建一个带
callback_url 的图片任务,或者轮询它,然后打开结果链接。
- 充值 $10 或更多;接入要无人值守运行的话,打开自动充值。
- 上生产前,按稳定性表选模型,给视频加上你自己的重试和第二个模型,需要保存超过 30 天的文件及时另存。
谁应该跳过它
如果你需要有地址和适用法律的签约公司、DPA、零数据保留或状态页,要发送机密数据,需要批量价或 Claude 的结构化输出,或者你的使用地区超出了厂商的服务范围,就跳过 APIMODELS。如果你的产品团队想用一份余额调用多种模型,愿意为备用渠道接受中间价位,也能接受 30 天的文件链接,它正是为这种情况做的。