MoonApiX Docs

Appearance

Gemini Nano 异步调用 ​

已开通异步图片能力的 API Key，可以使用 MoonApiX 统一图片异步入口提交 gemini-3-pro-image-preview 图片任务。异步提交先返回 MoonApiX 任务 ID，再通过统一任务接口查询状态和结果；需要在同一个 HTTP 请求中直接等待 Gemini-compatible 响应时，请使用 Gemini Nano 同步调用。异步请求只会路由到当前模型和分组已验证的原生异步能力；如果当前分组没有可用异步能力，创建请求会在任务创建和计费前失败。

异步入口 ​

能力路径说明
图片异步生成/v1/images/generations/async提交 prompt 并立即返回任务 ID。
查询任务/v1/images/tasks/{task_id}查询 status、progress、error 和成功结果。
获取内容/v1/images/tasks/{task_id}/content任务成功后跳转到结果图片。

并非所有 API Key 或模型变体都开通异步能力。可用模型、尺寸、比例、分辨率和单次生成数量，以当前 API Key、价格页和 GET /v1/models 返回为准。

提交任务 ​

bash
curl https://moonapix.com/v1/images/generations/async \
  -H "Authorization: Bearer <MOONAPIX_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3-pro-image-preview",
    "prompt": "A premium outdoor lifestyle advertising storyboard proposal board, Chinese typography, warm evening light.",
    "size": "16:9",
    "resolution": "4K",
    "n": 1
  }'

响应会先返回任务状态：

json
{
  "id": "task_xxx",
  "object": "image.generation",
  "status": "queued",
  "model": "gemini-3-pro-image-preview"
}

查询任务 ​

bash
curl https://moonapix.com/v1/images/tasks/task_xxx \
  -H "Authorization: Bearer <MOONAPIX_API_KEY>"

只有 status=succeeded 时读取 data[].url：

json
{
  "id": "task_xxx",
  "object": "image.generation",
  "status": "succeeded",
  "progress": 100,
  "model": "gemini-3-pro-image-preview",
  "data": [
    {
      "url": "https://media.moonapix.com/image/example.png"
    }
  ]
}

status 为 submitted、queued 或 running 时继续轮询；为 failed 时读取 error.message。结果是 URL 类型，客户端应保存完整 URL；也可以访问 /v1/images/tasks/{task_id}/content 获取或下载结果。

相关页面 ​