跳转到主要内容

前置条件

  1. 注册并验证账号。
  2. 确保积分余额足以覆盖本次调用。
  3. 在 API Keys 创建密钥。

接入地址

鉴权方式

仅在服务端使用 API Key。若泄露,请在 API Keys 轮换。

模型 ID 与素材

model 使用工作台的模型 ID。旧别名见对应模型页;新任务回显提交的 ID。 素材须可被 API 读取。图片和音频也可传 Base64 Data URI,解码后分别限 20 MiB/张和 15 MiB/段;完整请求限 32 MiB。视频仅支持 HTTP(S) URL。 视频模式根据素材及其 reference_type 推断,无需传 video_mode。

异步任务模型

提交后凭 task_id 轮询图像任务或视频任务。建议分别每 2 秒、5 秒查询一次。

第一步:提交生成任务

以下示例使用 nano-banana 模型生成一张 1:1 图像:
成功响应示例(HTTP 200):

第二步:轮询任务结果

使用上一步返回的 task_id 轮询任务状态,直至 status 变为 succeeded 或 failed:
任务状态说明: 成功响应示例(status: succeeded):

错误处理

已受理的任务若生成失败,原因见轮询响应的 error。排查时提供 task_id 和 request_id。

重试

查询遇到临时错误时退避重试。提交超时不代表任务未创建;不要直接重发,以免重复扣费。

下一步

API 手册

模型价格