Gemini 3.1 Flash Lite Image

请求 ID gemini-3.1-flash-lite-image

协议

POST /v1/images/generations · 生成图片示例
GET /v1/images/tasks/{task_id} · 查询图片任务示例

认证

请求需要 API Key。在控制台的 API Key 管理获取密钥。发送 JSON 请求时，设置 Content-Type: application/json。

Authorization: Bearer YOUR_API_KEY

请求参数

`POST /v1/images/generations`

参数	类型	是否必填	说明
`model`	`string`	必填	填写此模型的请求 ID `gemini-3.1-flash-lite-image`.
`prompt`	`string`	必填	描述要生成的图像。
`aspect_ratio`	`string`	选填	输出图像的宽高比。例如 `1:1` 或 `16:9`。省略时根据 `size` 推导。默认 `1:1`.
`n`	`integer`	选填	单次请求的图片数量，建议保持为 `1`。默认 `1`.
`?async`	`string`	选填	URL 查询参数。传 `1`、`true` 或 `yes` 返回 `202` 和 `task_id`。省略时等待生成结果。

请求示例

先将 API Key 设置为本机环境变量 ICODEEASY_API_KEY，并选择支持直接 HTTP 调用的接入点。接入点要求特定客户端时，按对应客户端指南配置。

示例中的素材 URL 和素材 ID 需要替换成自己的有效素材。

Images Generations

bash

curl -sS 'https://api.icodeeasy.cc/v1/images/generations' \
  -H "Authorization: Bearer $ICODEEASY_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{
  "model": "gemini-3.1-flash-lite-image",
  "prompt": "A watercolor illustration of a paper lantern by a lake."
}'

查询图片任务

bash

curl -sS 'https://api.icodeeasy.cc/v1/images/tasks/YOUR_TASK_ID' \
  -H "Authorization: Bearer $ICODEEASY_API_KEY"

响应与任务

HTTP 200 · 同步成功

使用 ?sync=1 时，成功响应中的 data[].url 是图片地址。created 为 Unix 秒时间戳，id 为任务 ID。

json

{
  "id": "d142c93a-de26-40c9-be62-0de840d10960",
  "created": 1781599773,
  "data": [
    {
      "url": "https://example.com/generated-image.png"
    }
  ]
}

HTTP 202 · 异步提交

json

{
  "task_id": "d142c93a-de26-40c9-be62-0de840d10960",
  "status": "pending"
}

使用 ?async=1 后，用同一 API Key 查询 GET /v1/images/tasks/{task_id}。status 可为 pending、completed 或 failed。完成后从 result_url 读取图片地址。

HTTP 200 · 查询到已完成任务

json

{
  "task_id": "d142c93a-de26-40c9-be62-0de840d10960",
  "status": "completed",
  "model": "gemini-3.1-flash-lite-image",
  "result_url": "https://example.com/generated-image.png"
}