跳转到主要内容
EggAPI 使用统一响应信封:
成功响应也使用同样信封,但 error 为 null。

错误码

参数校验错误

生成请求当前会校验:
  • model:nanobanana
  • prompt:必填,1 到 2000 个字符
  • negative_prompt:最多 1000 个字符
  • num_outputs:1 到 4
  • duration:1 到 60
  • aspect_ratio:16:9 或 9:16
  • resolution:1k、2k 或 4k
  • image_urls:最多 9 个合法 URL
  • webhook_url:合法 URL,最多 2048 个字符
模型名错误示例:

鉴权错误

缺少请求头:
格式错误:

任务失败

GET /v1/tasks/{id} 查询到失败任务时,HTTP 仍是 200,因为任务查询本身成功了。具体失败状态在 data.status 和 data.error 中表达。

处理模式

轮询任务时,要同时检查 HTTP 响应信封和任务状态: