PixVerse Image parameters and API differences
Learn how to select PixVerse image templates and generate images asynchronously.
For the API structures, see Create an image and Get a task.
Image template generation
| Item | Description |
|---|---|
| Service name | pixverse-image-template provides image template generation. The request body does not require model. |
| Template selection | Call List effect templates with type=2 to retrieve image templates. Select by name, effect preview and input requirements; available templates change as the catalog is updated. |
| Input images | Call Upload an image to obtain image IDs. The template determines whether an image or multiple images are needed and in which order. Video templates cannot be used directly for image generation. |
| Generation method | Process images using the selected template. The current creation API does not offer a free-form prompt, image size or model version selection. |
| Retrieving results | Creation returns task information only. Retrieve the image task afterward to obtain the image URL on success. |
ID reference
| Field | Source and purpose |
|---|---|
img_id | The uploaded image’s asset ID. Supply these IDs in order in the creation request’s img_ids. |
template_id | The image template ID returned by the template catalog. It determines the effect and input requirements. |
image_id | The image task ID returned by creation. Use it as task_id in the retrieval API. |
Preserve every digit when reading and passing IDs to avoid precision loss. Asset IDs, template IDs and task IDs are not interchangeable.