curl --request POST \
  --url https://api.modellix.ai/api/v1/google/imagen-4.0-ultra-generate-001 \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "Cinematic still from a sci-fi film, astronaut on alien planet, volumetric lighting"
}
'

{
  "code": 0,
  "message": "success",
  "data": {
    "status": "pending",
    "task_id": "task-mno345",
    "model_id": "google/imagen-4.0-ultra-generate-001",
    "get_result": {
      "method": "GET",
      "url": "https://api.modellix.ai/api/v1/tasks/task-mno345"
    }
  }
}

{
  "code": 400,
  "message": "Invalid parameters: parameter 'prompt' is required"
}

{
  "code": 401,
  "message": "Authentication failed: invalid API key"
}

{
  "code": 429,
  "message": "Rate limit exceeded: 100 requests per minute, retry after 60 seconds"
}

{
  "code": 500,
  "message": "Internal server error"
}

Imagen 4.0 Ultra

[Core Function] Imagen 4.0 Ultra is Google’s premium text-to-image model optimized for the highest quality and instruction alignment. [Strengths] It delivers ultimate photorealistic detail, superior texture rendering, and extremely strict adherence to complex, multi-part prompt instructions, supporting up to 2K resolution. [Best For] Highly recommended for high-end commercial marketing assets, professional design, intricate artistic compositions, and scenarios where precise instruction-following is paramount. [Limitations] Do NOT use this model if you need instant/real-time generation, native image editing (inpainting/outpainting), or negative prompts. It is the most expensive tier in the Imagen family. [Routing] Choose this model when the user demands the absolute highest quality, ultimate detail, or has highly complex prompt instructions. Otherwise, default to standard Imagen 4.0 or Imagen 4.0 Fast.

POST

google

imagen-4.0-ultra-generate-001

curl --request POST \
  --url https://api.modellix.ai/api/v1/google/imagen-4.0-ultra-generate-001 \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "Cinematic still from a sci-fi film, astronaut on alien planet, volumetric lighting"
}
'

{
  "code": 0,
  "message": "success",
  "data": {
    "status": "pending",
    "task_id": "task-mno345",
    "model_id": "google/imagen-4.0-ultra-generate-001",
    "get_result": {
      "method": "GET",
      "url": "https://api.modellix.ai/api/v1/tasks/task-mno345"
    }
  }
}

{
  "code": 400,
  "message": "Invalid parameters: parameter 'prompt' is required"
}

{
  "code": 401,
  "message": "Authentication failed: invalid API key"
}

{
  "code": 429,
  "message": "Rate limit exceeded: 100 requests per minute, retry after 60 seconds"
}

{
  "code": 500,
  "message": "Internal server error"
}

Authorizations

Authorization

string

header

required

API Key authentication. Format: Bearer YOUR_API_KEY.

Body

application/json

prompt

string

required

Image description text

Minimum string length: 1

Example:

"A golden retriever playing fetch on the beach at sunset"

sampleCount

integer

default:1

Number of images to generate per request

Required range: 1 <= x <= 4

Example:

1

aspectRatio

enum<string>

default:1:1

Image aspect ratio

Available options:

1:1,

3:4,

4:3,

9:16,

16:9

Example:

"16:9"

personGeneration

enum<string>

default:allow_all

Person generation policy

Available options:

dont_allow,

allow_adult,

allow_all

Example:

"allow_all"

imageSize

enum<string>

Output image resolution

Available options:

1K,

2K

Example:

"1K"

Response

Task submitted successfully

code

integer

required

Response code, 0 indicates success

Example:

0

message

string

required

Response message

Example:

"success"

data

object

required

Detailed data about the submitted asynchronous task.

Show child attributes

Imagen 4 0 generate 001 Nano banana