图像生成

先通过 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。模型能力、画幅和参考图限制以媒体模型目录及 GET /api/openapi.json 为准。

计费与退款

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

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

错误处理

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