模型能力
图片生成与编辑
使用图像接口提交提示词或参考图片,保存结果并核对任务状态。
选择模型
选择支持 Images API 的图像模型与线路,按 API 概览准备密钥。不是所有图片模型都使用相同协议;Gemini 原生图片模型应按其原生内容结构接入。
文本生成图片
下面是 Bash 请求。将 <model-id> 换为实际图片模型 ID。
curl --fail-with-body 'https://gateway.irouter.io/v1/images/generations' \
-H "Authorization: Bearer $IROUTER_API_KEY" \
-H 'Content-Type: application/json' \
--data '{"model":"<model-id>","prompt":"A clean product photograph of a ceramic cup on a white desk."}'尺寸、数量、质量和返回格式均需按该模型能力增加。基础示例省略这些可选项,避免把某个模型的选项当作通用配置。
编辑已有图片
选择支持图片编辑的模型,并将 input.png 换为自己的参考文件。此示例适用于接受单个 image 文件字段的兼容线路;多图和蒙版字段另按模型要求配置。
curl --fail-with-body 'https://gateway.irouter.io/v1/images/edits' \
-H "Authorization: Bearer $IROUTER_API_KEY" \
-F 'model=<model-id>' \
-F 'image=@input.png' \
-F 'prompt=Change the background to a bright studio and keep the main object.'保存结果和处理长任务
同步响应可能在 data 中提供 URL 或 Base64 图片,按实际字段保存。临时结果地址可能失效,生成后及时下载到自己的存储。不要把整个 Base64 响应放入日志。
若所选线路返回任务 ID,按照该线路明确提供的任务协议查询。不要把其他服务的异步路径、任务状态或固定轮询频率直接套用。可以通过体验台查看受支持模型的任务状态。
提交后超时不代表任务未执行。重试前检查任务和用量,避免重复生成与费用。实际收费与失败处理按订单及用量记录核对。