Gemini 图片生成 API 使用说明（MoreToken版）

概述

本页为MoreToken版接口说明。MoreToken版走MoreToken 渠道（MORETOKEN），是纯图片渠道，仅提供 Gemini 系列文生图模型，按预估一口价计费。与「face 优化版」「官方版」「可当版」「贞贞版」相互独立、互不影响。

• 上游（moretokens.ai）是同步出图接口，本服务封装为与其他版本一致的任务式调用：POST 提交后立即返回任务 ID，随后轮询任务状态，成功后取图片链接或打包下载 zip。
• 仅文生图：只接受 model + prompt + 可选尺寸，不支持参考图参数 image / images，传入会返回 400。
• 任务状态透出为 QUEUED / RUNNING / SUCCEEDED / FAILED 等，上游细节由本服务统一封装，客户无需感知。

快速开始

认证方式

所有接口均需在请求头中传入 API Key：

Authorization: Bearer <你的 API Key>

基础信息

计费与余额（预估一口价）

MoreToken版采用预付费余额模式，与其他版本共用同一个账户余额（单位：积分）。

冻结与扣费流程

1. 下单冻结：提交任务时按该模型的预估价（积分/张，以管理员配置为准）全额冻结相应积分。
2. 成功结算：任务成功后按冻结额一口价结算（上游不回报实际消费，故不多退少补）。
3. 解冻退回：任务失败 / 取消 / 超时则全额解冻，不扣费。

可用余额

可用余额 = 账户总余额 − 冻结中金额

下单时若「可用余额 < 本次预估费用」，接口返回 402 insufficient_balance，任务不会提交。

余额查询与充值

• 余额查询：用你的 API Key 登录工作台 https://sd.boosterai.cn/#bill 查看实时余额、冻结金额与消费明细。
• 充值：请联系管理员。

可用模型列表

下游模型名（别名）由管理员配置。MoreToken 渠道当前提供以下生图模型：

接口详情

1. 提交图片生成任务

请求体参数

请求示例（文生图）

curl -X POST "https://sd.boosterai.cn/api/v3/images/generations" \
  -H "Authorization: Bearer 你的APIKey" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3.1-flash-image-mt",
    "prompt": "高端护肤品电商主图，纯白柔光展台，玻璃精华瓶",
    "metadata": {"width": 1024, "height": 1024}
  }'

请求示例（图生图，带参考图）

curl -X POST "https://sd.boosterai.cn/api/v3/images/generations" \
  -H "Authorization: Bearer 你的APIKey" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3.1-flash-image-mt",
    "prompt": "把图片里的背景换成纯白摄影棚背景，产品保持不变",
    "images": ["https://example.com/product.jpg"]
  }'

响应示例

{
  "id": "task_01KWBW73D7WCN1PFZN9S1QQCK2"
}

提交成功返回任务 id，后续用它轮询结果。任务落库后立即返回，实际出图在后台异步执行。

2. 查询任务状态

将提交任务时返回的 id 填入路径。建议每 3~5 秒轮询一次。

curl https://sd.boosterai.cn/api/v3/images/generations/task_01KWBW73D7WCN1PFZN9S1QQCK2 \
  -H "Authorization: Bearer 你的APIKey"

响应示例（成功）

{
  "id": "task_01KWBW73D7WCN1PFZN9S1QQCK2",
  "model": "gemini-3.1-flash-image-mt",
  "status": "SUCCEEDED",
  "result_url": "https://.../image-1.png",
  "image_urls": ["https://.../image-1.png"]
}

status 为 SUCCEEDED 时，result_url 是主图直链，全部结果图 URL 在 image_urls 数组；图片存于阿里云 OSS，URL 为 7 天有效的预签名地址，请及时下载转存。失败时费用全额解冻。

任务状态说明

3. 打包下载全部图片

任务成功后，可将该任务的全部结果图一次性打包下载为 zip：

curl -o images.zip \
  https://sd.boosterai.cn/api/v3/images/generations/task_01KWBW73D7WCN1PFZN9S1QQCK2/images.zip \
  -H "Authorization: Bearer 你的APIKey"

错误码参考