控制台

Nano Banana Pro 文生图

Google Nano Banana Pro（Gemini 3.0 Pro Image）支持文本生图，并可输出 4K 分辨率的结果。它提供开箱即用的 REST 推理 API，性能出色、无冷启动且价格实惠。

google/gemini-3-pro-image/text-to-image

1. 身份验证

该 API 使用 API Key 进行身份验证。

获取你的 API Key

从 https://icreat.ai/hub/keys 获取你的 API key。

2. 调用 API

提交请求

使用 cURL 提交 http 请求以启动任务：

curl --fail-with-body --connect-timeout 10 --max-time 60 \
  -X POST https://api.icreat.ai/v1/task/submit/google/gemini-3-pro-image/text-to-image \
  -H "Authorization: Bearer ${ICREAT_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
  "aspect_ratio": "1:1",
  "prompt": "A fat dog",
  "image_size": "1k"
}'

服务器将返回如下响应体：

{ "task_id" : "task-xxx"}

使用 task_id 轮询状态并获取结果。

3. 轮询状态

curl --connect-timeout 10 --max-time 60 \
  -X POST "https://api.icreat.ai/v1/task/query-status" \
  -H "Authorization: Bearer ${ICREAT_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
  "task_id": "task-xxx"
}'

服务器将返回任务状态。当状态为 SUCCEEDED 时，你可以获取结果。

4. 获取结果

curl --connect-timeout 10 --max-time 60 \
  -X POST "https://api.icreat.ai/v1/task/get-result" \
  -H "Authorization: Bearer ${ICREAT_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
  "task_id": "task-xxx"
}'

服务器将返回此任务的输出。

5. Schema

Field Type Required Description
prompt string Yes 文本提示词，最多 8192 个字符
aspect_ratio string Yes 宽高比。可用值：1:1、2:3、3:2、3:4、4:3、4:5、5:4、9:16、16:9、21:9。默认为第一张上传图片的宽高比
image_size string Yes 分辨率档位。可用值：1K、2K、4K

6. 输入示例

6.1 文生图

{
  "prompt": "A fat dog",
  "aspect_ratio": "1:1",
  "image_size": "1k"
}