curl --request POST \
  --url https://api.modellix.ai/api/v1/google/imagen-4.0-generate-001 \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "A golden retriever playing fetch on the beach at sunset"
}
'

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

{
  "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

[Core Function] Imagen 4.0 is Google’s flagship professional-grade text-to-image model designed for high-fidelity visual generation. [Strengths] It excels at industry-leading photorealism, exceptional typography/text rendering inside images, and strong prompt adherence, supporting up to 2K resolution and batch generation. [Best For] Highly recommended for general high-quality image generation, marketing assets (posters, product labels, menus, signage), and product photography mockups where readable text is required. [Limitations] Do NOT use this model if you need instant/real-time generation, native image editing (inpainting/outpainting), or negative prompts. It is strictly an image-only output model. [Routing] Use this model by default for high-quality, photorealistic text-to-image requests. If the user emphasizes speed or needs lower cost, route to Imagen 4.0 Fast. If the user demands the absolute highest detail and prompt precision, route to Imagen 4.0 Ultra.

POST

google

imagen-4.0-generate-001

curl --request POST \
  --url https://api.modellix.ai/api/v1/google/imagen-4.0-generate-001 \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "A golden retriever playing fetch on the beach at sunset"
}
'

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

{
  "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 fast generate 001 Imagen 4 0 ultra generate 001