Start a text-to-image or image-editing task

Global Server

https://video.a2e.ai

POST

/api/v1/userNanoBanana/start

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/json

Example

{
    "name": "Test Name",
    "prompt": "create a 1/7 scale commercialized figure of the character in the illustration, in a realistic style and environment. Place the figure on a computer desk, using a circular transparent acrylic base without any text.On the computer screen, display the ZBrush modeling process of the figure. Next to the computer screen, place a BANDAI-style toy packaging box printed with the original artwork.",
    "input_images": [
        "https://a2e-prod-jumpy.ai2everyone.com/stable/sample/nano_banana/i-v-girl1.jpg"
    ]
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://video.a2e.ai/api/v1/userNanoBanana/start' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "Test Name",
    "prompt": "create a 1/7 scale commercialized figure of the character in the illustration, in a realistic style and environment. Place the figure on a computer desk, using a circular transparent acrylic base without any text.On the computer screen, display the ZBrush modeling process of the figure. Next to the computer screen, place a BANDAI-style toy packaging box printed with the original artwork.",
    "input_images": [
        "https://a2e-prod-jumpy.ai2everyone.com/stable/sample/nano_banana/i-v-girl1.jpg"
    ]
}'

Responses

🟢200Success

application/json

Body

Example

{
    "code": 0,
    "data": {
        "_id": "68baa0353b3544003bb2270c",
        "name": "Test Name",
        "prompt": "create a 1/7 scale commercialized figure of the character in the illustration, in a realistic style and environment. Place the figure on a computer desk, using a circular transparent acrylic base without any text.On the computer screen, display the ZBrush modeling process of the figure. Next to the computer screen, place a BANDAI-style toy packaging box printed with the original artwork.",
        "input_images": [
            "https://a2e-prod-jumpy.ai2everyone.com/stable/sample/nano_banana/i-v-girl1.jpg"
        ],
        "image_urls": [],
        "text_responses": [],
        "reference_id": "a23e6379-36a7-4892-98d1-3caf956feaad",
        "conversation_id": "conv_f2a53029-9f95-4817-8548-fbd0794d09f2",
        "current_status": "initialized",
        "coins": 20,
        "failed_message": "",
        "quality_settings": {
            "creativity_level": "medium",
            "detail_level": "detailed",
            "style_consistency": true
        },
        "composition_mode": "blend",
        "iteration_count": 0,
        "processing_time": 0,
        "user_rating": null,
        "user_feedback": "",
        "createdAt": "2025-09-05T08:32:53.181Z",
        "updatedAt": "2025-09-05T08:32:53.181Z"
    },
    "trace_id": "a23e6379-36a7-4892-98d1-3caf956feaad"
}

Modified at 2025-09-05 08:32:46

Quick Add Avarar

Query the detail of one task