Dashboard

Nano Banana Pro Text-to-Image

Google Nano Banana Pro (Gemini 3.0 Pro Image) supports text-to-image and can output 4K resolution results. It offers a ready-to-use REST inference API, excellent performance, no cold start, and affordable price.

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

1. Authentication

The API uses an API Key for authentication.

Get your API Key

Get your API key from https://icreat.ai/hub/keys .

2. Calling the API

Submit a request

Use cURL to submit a http request to start a task:

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"
}'

The server will return a response body like:

{ "task_id" : "task-xxx"}

Use the task_id to poll the status and get the results.

3. Polling the status

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"
}'

The server will return the status of the task. When the status is SUCCEEDED, you can get the results.

4. Get the results

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"
}'

The server will return the outputs of this task.

5. Schema

Field Type Required Description
prompt string Yes Text prompt, maximum 8192 characters
aspect_ratio string Yes Aspect ratio. Available values: 1:1、2:3、3:2、3:4、4:3、4:5、5:4、9:16、16:9、21:9。Defaults to the aspect ratio of the first uploaded image
image_size string Yes Resolution tier. Available values: 1K、2K、4K

6. Input examples

6.1 text to image

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

6.2 referece image

{
  "prompt": "A fat dog",
  "image": [
    "http://example.com/1.jpg",
    "http://example.com/2.jpg"
  ]
  "aspect_ratio": "1:1",
  "image_size": "1k"
}