Generate images
pixverse_create_imageGenerate 1-4 images with Qwen Image (the default), Nano Banana, Seedream, GPT Image or Kling image models, from a prompt and up to 16 reference images (by model). Each model has its own qualities, ratios and reference count (pixverse_get_features lists the image models the plan allows). Uses PixVerse credits per image, free in Relax Mode where the plan includes the model. Waits up to ~50 s and returns each image's image_id and image_url, the first as an image; else the ids for pixverse_get_image. POST /images/create.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"prompt": "<prompt>"
},
"name": "pixverse_create_image"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| seed | No | Seed for a repeatable result. | |
| wait | No | Wait up to ~50 s for the job to finish (default true); false returns the id at once. | |
| No | The PixVerse account email (pixverse_list_accounts). Optional: by default a random account with a free slot. | ||
| model | No | Default qwen-image. | |
| prompt | Yes | What the image shows; the limit depends on the model. | |
| maxJobs | No | Override the account's maxJobs (jobs at once) for this request, 1-8. | |
| quality | No | Default: the model's first quality. Each model takes only some (400 otherwise). | |
| relax_mode | No | Left out, the image is free where the plan includes the model (Relax Mode) and costs credits otherwise; true insists on Relax Mode (412 when the plan does not include the model); false pays credits at full speed. | |
| image_paths | No | Reference images in order: paths from pixverse_upload_file (the model sets how many). | |
| aspect_ratio | No | Default: the model's first ratio (auto where offered). 1:4, 4:1, 1:8 and 8:1 on nano-banana-2.1 only. | |
| create_count | No | Images to make, 1-4 (default 1). Each image is charged. | |
| detail_level | No | gpt-image-2.0 (low, medium, high), gpt-image-2.5-flare / -sunburst (also xhigh, max) and nano-banana-2.1 (minimal, medium, high) only; default low, medium on nano-banana-2.1. |