图像生成

图像生成

先通过 GET /api/open/v1/media/models?mediaType=image 获取已验证模型，再调用 POST /api/open/v1/media/images/jobs 生成图片。任务详情使用 GET /api/open/v1/media/images/jobs/{jobId} 查询，并且只允许 API Key 所属用户访问。

创建任务

curl https://fishaudio.org/api/open/v1/media/images/jobs \
  -H "Authorization: Bearer $FISHAUDIO_API_KEY" \
  -H "Idempotency-Key: image-$(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"prompt":"电影感汽车产品照","model":"nano-banana","aspect_ratio":"9:16"}'

编辑图片时将 generation_type 设为 edit 并传入 image_url，或使用 image_urls 按顺序传入最多 4 张参考图；两个字段不能同时使用。resolution 可为 1k（默认）、2k 或 4k。实际可选分辨率、每档积分报价与参考图上限见模型目录的 variants。GPT Image 2 当前仅 1K 支持参考图；Nano Banana Pro 的三个档位均支持最多 4 张参考图。模型能力、画幅和参考图限制以媒体模型目录及 GET /api/openapi.json 为准。

计费与退款

此接口扣除 API 额度，不扣网站会员积分。供应商生成、存储或任务落库失败时，系统使用任务计费引用幂等退回 API 额度。批量生成前可查询 Profile 获取剩余额度。

Idempotency-Key 为必填请求头，每次有意创建新任务时必须使用新值。使用同一个 key 重试会返回首次结果，不会重复创建任务或重复扣费。

错误处理

客户端应分别处理不支持的模型、无效参考图、API 额度不足和生成失败。响应包含稳定错误码及 requestId。