Image Generation

Aspect Ratio	Resolution	Tokens
1:1	1024×1024	5
2:3	832×1248	5
3:2	1248×832	5
3:4	864×1184	5
4:3	1184×864	5
4:5	896×1152	5
5:4	1152×896	5
9:16	768×1344	5
16:9	1344×768	5
21:9	1536×672	5

Aspect Ratio	1K Resolution	1K Tokens	2K Resolution	2K Tokens	4K Resolution	4K Tokens
1:1	1024×1024	15	2048×2048	15	4096×4096	30
2:3	848×1264	15	1696×2528	15	3392×5056	30
3:2	1264×848	15	2528×1696	15	5056×3392	30
3:4	896×1200	15	1792×2400	15	3584×4800	30
4:3	1200×896	15	2400×1792	15	4800×3584	30
4:5	928×1152	15	1856×2304	15	3712×4608	30
5:4	1152×928	15	2304×1856	15	4608×3712	30
9:16	768×1376	15	1536×2752	15	3072×5504	30
16:9	1376×768	15	2752×1536	15	5504×3072	30
21:9	1584×672	15	3168×1344	15	6336×2688	30

Resolution	Tokens
Total pixels range: [1280×720, 4096×4096]	5

Resolution	Tokens
Total pixels range: [1280×720, 2048×2048]	3

Request

Path Params

Header Params

Body Params application/json

Example

{
    "content": [
        {
            "type": "text",
            "text": "Subject:\nThe human subject is reimagined as the main character in a cinematic moment, walking a loyal pet companion. Their silhouette is enhanced with soft, dramatic lighting that adds depth, presence, and storytelling. The subject’s features remain natural, recognized, and elevated with movie-grade atmosphere.\n\nOutfit:\nA stylish, film-inspired outfit adapted to the user’s daily-wear vibe — flowing coats, layered sweaters, subtle textures, or minimalist modern clothing depending on the final look. Everything is realistic, grounded, and aesthetically pleasing.\n\nPet:\nA [Dog] walking beside the subject. The pet’s form is natural, expressive, and receives soft directional lighting to match the cinematic tone. The pet behaves calmly, walking close to the subject.\n\nSetting:\nA beautifully cinematic environment such as a quiet evening street, a misty park pathway, a soft golden-hour field, or a lantern-lit city walkway. Warm or cool tones depending on the mood. Light mist, drifting particles, or soft bokeh enhance the storytelling. Nature or city elements glow gently in the background.\n\nCamera / Composition:\n4:5 vertical movie-frame\nMedium-distance shot showing the full walk\nCinematic depth, wide aperture feel, atmospheric haze\nNo text, no watermark"
        },
        {
            "type": "image_url",
            "url": "https://u-static.fotor.com/uid_0f5eccd484e6403084043fd20e320027/image_to_image/app-fotor-web/ef3f9d2c-aa9b-4a99-96e6-c6c32d11df36.jpg",
            "role": "smart_reference"
        }
    ],
    "width": 841,
    "height": 1152
}

Request Code Samples

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://api-b.fotor.com/v1/aiart/imagegeneration/gemini-3-pro-image-preview' \
--header 'Authorization: Bearer <your api key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "content": [
        {
            "type": "text",
            "text": "Subject:\nThe human subject is reimagined as the main character in a cinematic moment, walking a loyal pet companion. Their silhouette is enhanced with soft, dramatic lighting that adds depth, presence, and storytelling. The subject’s features remain natural, recognized, and elevated with movie-grade atmosphere.\n\nOutfit:\nA stylish, film-inspired outfit adapted to the user’s daily-wear vibe — flowing coats, layered sweaters, subtle textures, or minimalist modern clothing depending on the final look. Everything is realistic, grounded, and aesthetically pleasing.\n\nPet:\nA [Dog] walking beside the subject. The pet’s form is natural, expressive, and receives soft directional lighting to match the cinematic tone. The pet behaves calmly, walking close to the subject.\n\nSetting:\nA beautifully cinematic environment such as a quiet evening street, a misty park pathway, a soft golden-hour field, or a lantern-lit city walkway. Warm or cool tones depending on the mood. Light mist, drifting particles, or soft bokeh enhance the storytelling. Nature or city elements glow gently in the background.\n\nCamera / Composition:\n4:5 vertical movie-frame\nMedium-distance shot showing the full walk\nCinematic depth, wide aperture feel, atmospheric haze\nNo text, no watermark"
        },
        {
            "type": "image_url",
            "url": "https://u-static.fotor.com/uid_0f5eccd484e6403084043fd20e320027/image_to_image/app-fotor-web/ef3f9d2c-aa9b-4a99-96e6-c6c32d11df36.jpg",
            "role": "smart_reference"
        }
    ],
    "width": 841,
    "height": 1152
}'

Responses

🟢200success

application/json

Body

Example

{
    "code": "000",
    "msg": "success",
    "data": {
        "taskId": "e0dc194703174b6eafeacb4ee8e02850"
    }
}

Gemini 2.5 Flash Image

Gemini 3 Pro Image (Preview)

Seedream 4.0

Qwen

Request

Request Code Samples

Responses

Image Generation

Gemini 2.5 Flash Image#

Gemini 3 Pro Image (Preview)#

Seedream 4.0#

Qwen#

Request

Request Code Samples

Responses

Gemini 2.5 Flash Image

Gemini 3 Pro Image (Preview)

Seedream 4.0

Qwen