Agnes Image 2.5 Flash

这个模型适合什么场景？

Agnes Image 2.5 Flash 最新图像模型：文生图/图生图/多图合成，支持 1K-4K 档位与比例参数。当前上游优惠价 ¥0（刊例价 1K ¥0.07/张起，优惠结束需改价）。｜渠道 Agnes 国内主/国际备

怎么调用这个模型？端点和协议是什么？

• POST/v1/images/generations图像生成 / 编辑

这个模型多少钱？按什么单位计费？

这个模型走的是官方直连渠道吗？怎么核验？

Agnes Image 2.5 Flash 经上游厂商官方 API 直连接入，不做来源不明的转发或逆向接口。每笔调用都把上游实际服务的模型标识（actual_model_id）与经过的渠道（channel_id）写入调用日志，可用该次 Request ID 在控制台逐笔比对「请求模型」与「上游实际服务模型」。主渠道不可用时按后台显式配置的降级映射切换，未配置映射的模型宁可报错，也不会静默换成便宜模型。

这个模型有并发和限流上限吗？超了返回什么？

Key 级默认 60 RPM / 90,000 TPM，IP 级 5 次/天（注册防护），另有用户×模型级并发闸门。超限返回 429（错误码 42901/42902/42903）并携带 Retry-After 与 X-RateLimit-* 响应头，建议客户端按 1s→2s→4s 指数退避。单渠道连续失败 5 次会进入 60 秒熔断，只影响该渠道，不影响同模型的其他渠道。

调用失败会计费吗？可用性怎么算、怎么赔？

失败请求不计费；流式响应中断时按实际已产生的输出结算，不按预估全额扣。平台月度可用性目标 99.9%，口径为统一网关能够正常受理并转发请求——上游厂商波动、您自身网络或客户端问题不计入；确属平台原因的不可用按配额补偿，累计上限为您在前 1 个自然月实际支付的服务费用。赠送配额与免费试用期间的调用不提供可用性承诺。

统一协议

全平台所有模型统一走 OpenAI 兼容协议（另提供 Anthropic 兼容端点）。更换模型只需修改 model 参数，代码零改动；渠道故障平台自动降级，不中断你的任务。

API 调用示例

curl https://api.starhubc.com/v1/images/generations \
  -H "Authorization: Bearer ***" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "agnes-image-2.5-flash",
    "prompt": "一只猫在花园里弹钢琴",
    "size": "1024x1024",
    "n": 1
  }'

身份验证

所有请求需在请求头携带 Authorization: Bearer ***。API Key 在控制台「API 密钥」页创建，支持按模型、IP、速率维度约束。