Gemini 出图 API
一张图 5 分钱,按张计费
兼容 Gemini 官方接口格式,改一行 base_url 就能接。 按成功出图的张数计费,不按 token、不按时长。支持 1K / 2K / 4K。
价格以控制台实时计费为准。下方运行数据取自后台真实日志。
# 换掉域名,其余与官方一致 POST api.houditoken.com/v1beta/models/ gemini-3.1-flash-image:generateContent x-goog-api-key: $API_KEY {"contents":[{"parts":[{"text": "雨天撑伞的柴犬,电影感光影"}]}]}
按张计费,价格表就在这里
按成功出图的张数计费。请求失败、被内容安全策略拦截的,不计费。
| 模型 | 1K | 2K | 4K | ¥100 可出张数(1K) |
|---|---|---|---|---|
| Flash 经济款gemini-3.1-flash-image | ¥0.05 | ¥0.09 | ¥0.13 | 2,000 张 |
| Pro 高画质 · 更快gemini-3-pro-image | ¥0.08 | ¥0.12 | ¥0.20 | 1,250 张 |
本次扣费 = 成功张数 × 该分辨率单价
纯粹为了省钱的场景。要说清楚:Flash 不比 Pro 快,反而更慢 —— 1K 平均 35.6 秒,而 Pro 只要 20.2 秒。它的唯一优势就是便宜。
其余情况都建议用 Pro:画质更好,而且每个分辨率都比 Flash 快 30% 以上。 1K 每张贵 ¥0.03,多数场景这个差价值得。
社媒配图、电商详情用 1K 足够;印刷、大屏、需要后期裁切的用 2K 以上。4K 明显更慢。
这些图都是这个接口出的
提示词、耗时、扣费原样贴在下面,没有挑好的留、差的删。 用的是 Flash —— 便宜但更慢的那个,所以这些耗时比用 Pro 要高。
耗时 52.8s · 本次扣费 ¥0.09
耗时 36.3s · 本次扣费 ¥0.09
耗时 34.0s · 本次扣费 ¥0.09
耗时 40.1s · 本次扣费 ¥0.09
耗时 39.7s · 本次扣费 ¥0.09
耗时 52.9s · 本次扣费 ¥0.09
图片为展示压缩过(720px WebP),实际返回的是 2048×2048 原图,不做任何缩放。
改一行 base_url 就能跑
请求体、参数、返回结构都与 Gemini 官方一致,现有代码基本不用改。
curl https://api.houditoken.com/v1beta/models/gemini-3.1-flash-image:generateContent \ -H "x-goog-api-key: $API_KEY" \ -H "Content-Type: application/json" \ -d '{"contents":[{"parts":[{"text":"雨天撑伞的柴犬,电影感光影"}]}]}' # 返回与官方结构一致,图在 inlineData 里
为什么能做到 5 分钱一张
便宜本身不该让你放心。这一段把钱省在哪儿讲清楚,你可以自己验证。
我们靠批量采购与长期合约拿到上游额度,只做出图这一条产品线,不摊其他业务的成本; 调度、失败重试、多节点冗余都是自建的。失败的请求不向你收费,这部分损耗我们自己承担。
请求原样转发给上游,返回的图原样给你 —— 不做二次压缩、不降分辨率、不偷换模型。 这三件事是这个行业最常见的猫腻。
自己验:把返回图的尺寸和编码与官方直连的结果对比一遍,一致才说明中间没做手脚。
出图要多久,把真实数字给你
出图是重计算任务,不是毫秒级接口。分辨率越高越慢,高峰期会排队。 另外一件反直觉的事也一并说了:Flash 虽然便宜,但比 Pro 慢,对速度敏感就别选它。
| 模型 · 分辨率 | 平均耗时 | P95 耗时 | 近 7 天出图张数 |
|---|---|---|---|
| Pro · 1K | 20.2 秒 | 31.7 秒 | 636,355 |
| Pro · 2K | 29.7 秒 | 42.1 秒 | 1,397,667 |
| Pro · 4K | 45.9 秒 | 74.3 秒 | 355,643 |
| Flash · 1K | 35.6 秒 | 72.4 秒 | 64,137 |
| Flash · 2K | 43.1 秒 | 76.1 秒 | 42,062 |
| Flash · 4K | 59.2 秒 | 96.8 秒 | 18,698 |
P95 = 95% 的请求在这个时间内返回。建议客户端超时设到 120 秒以上。
拿去转售是允许的
不限制你的终端用户,不要求署名。按标价拿货,加价空间归你。
可创建多个 API Key,按 Key 分别查看用量与账单,方便给不同客户或项目算账。
月用量达到一定规模走阶梯价,联系售前谈具体折扣。
支持对公转账,可开具增值税发票(信息服务费)。开票信息在控制台提交。
你可能想问的
生成失败扣不扣费?被内容安全拦截怎么算?
都不扣费。只有成功返回图像的请求才计费,内部重试也不会重复计。被上游内容安全策略拦截的请求会原样返回错误码,同样不计费。
4K 是真 4K 吗?为什么这么慢?
是上游返回的原始分辨率,我们不做任何缩放或重新编码。慢是因为出图本身是重计算任务:Pro 4K 平均 45.9 秒、P95 74.3 秒,Flash 4K 更慢。对速度敏感的场景建议用 Pro + 1K。
余额会不会清零?最低充多少?
余额不设有效期。起充金额和当前活动以控制台为准。建议先小额充值跑通业务再加量。
并发有上限吗?超了会怎样?
有上限,按账户配置。超出后请求会排队而不是直接报错;如果你的业务需要更高并发,联系售前单独配置。
错误码是原样透传的吗?
是。上游返回什么错误码就给你什么,不做包装、不吞错误,方便你按官方文档排查。
和直接用官方有什么区别?
接口格式一致,代码基本不用改。区别是按张计费、不需要自己申请和维护上游额度,并且我们做了多节点冗余和失败重试。缺点是多一层转发,链路上会比直连多一点延迟。
提示词和生成的图你们会留存吗?
为了计费和排障,后台会记录请求元数据(时间、模型、分辨率、耗时、扣费)。具体的留存策略以隐私政策为准,有合规要求的客户可以联系我们单独确认。
能退款吗?
已消耗的额度不退。未消耗的余额可以申请退款,具体规则以退款政策为准。如果出现"不做二次压缩、不降分辨率、不偷换模型"这三条承诺被违反的情况,当月账单全额退。