curl --request POST \
--url https://api.modellix.ai/api/v1/google/nano-banana-2.1-edit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"prompt": "Transform this into a watercolor painting"
}
'{
"code": 0,
"message": "success",
"data": {
"status": "pending",
"task_id": "task-nb21e",
"model_id": "google/nano-banana-2.1-edit",
"get_result": {
"method": "GET",
"url": "https://api.modellix.ai/api/v1/tasks/task-nb21e"
}
}
}{
"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"
}Nano Banana 2.1 Edit
[Core Function] Nano Banana 2.1 Edit is Google’s fast image-editing and video-to-image model, exposed as google/nano-banana-2.1-edit. [Strengths] It edits up to 14 reference images, or one HTTPS video plus up to 10 images, at 1K, 2K, or 4K, with improved character and multi-reference consistency. thinkingLevel defaults to medium. Optional systemInstruction is omitted when blank. enableWebSearch turns on Google Search grounding (web and image search) only when true. [Best For] Prompted restyling, multi-image product and character edits, and turning a video into a still. [Limitations] Do NOT use this model for text-only generation, 512-pixel output, or audio generation. At least one of image or video is required. seed, temperature, topP, topK, and logprobs are rejected. [Routing] Use this endpoint when the user provides images or a video and wants Nano Banana 2.1. Use google/nano-banana-2-edit for the previous Gemini 3.1 Flash Image editor, including 512 output. Use google/nano-banana-2.1 when there is no visual input. Use google/nano-banana-pro-edit for the highest-fidelity still edits that do not need video input.
curl --request POST \
--url https://api.modellix.ai/api/v1/google/nano-banana-2.1-edit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"prompt": "Transform this into a watercolor painting"
}
'{
"code": 0,
"message": "success",
"data": {
"status": "pending",
"task_id": "task-nb21e",
"model_id": "google/nano-banana-2.1-edit",
"get_result": {
"method": "GET",
"url": "https://api.modellix.ai/api/v1/tasks/task-nb21e"
}
}
}{
"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
API Key authentication. Format: Bearer YOUR_API_KEY.
Body
At least one of image or video must be provided. Both may be provided together.
Editing instruction describing the desired transformation
1"Transform this into a watercolor painting"
Input image URLs. At least one of image or video must be provided. Supports up to 14 images, or up to 10 images when video is also provided.
1 - 14 elementsImage URL (e.g. https://example.com/image.jpg).
["https://example.com/image.jpg"]
Input video URL. At least one of image or video must be provided. Must be a publicly accessible HTTPS URL without cookies, authentication, or custom headers. Maximum file size: 15 MB.
"https://example.com/video.mp4"
MIME type of the input video. Requires video. Defaults to video/mp4.
video/x-flv, video/quicktime, video/mpeg, video/mpegs, video/mpg, video/mp4, video/webm, video/wmv, video/3gpp "video/mp4"
Output image aspect ratio. Defaults to 1:1.
1:1, 3:2, 2:3, 3:4, 1:4, 4:1, 4:3, 4:5, 5:4, 1:8, 8:1, 9:16, 16:9, 21:9, 9:21 "16:9"
Output image resolution. Defaults to 1K. 512 is not supported.
1K, 2K, 4K "1K"
Thinking effort. minimal is fastest; high spends more thinking. Defaults to medium.
minimal, medium, high "medium"
Optional system instruction. Omitted when empty. Not sent upstream when blank.
When true, enables Google Search grounding with web search and image search. Image search cannot be used to look up people. Omitted or false does not send the tool. Search uses extra tokens.