AGTCloud API Docs
GuidesAPI ReferenceIntegrations and resourcesUpdate and help
Video generationPixVerse

PixVerse Upload image

Upload an image file or image URL to obtain an image ID shared by video generation and image templates.

POST/openapi/v2/image/upload

Authorization

bearerAuth
AuthorizationBearer <token>

Use a platform API key in the format Authorization: Bearer your-api-key.

In: header

Header Parameters

Ai-trace-id?string

Optional unique trace value; generated by the platform if omitted. Not an idempotency key.

Accept-Language?string

Optional language preference for resource APIs.

Request Body

multipart/form-data

Response Body

application/json

application/json

application/json

application/json

Use the returned result

Choose either image or image_url; both use a multipart form. Let the client generate the boundary rather than constructing it manually. After success, use Resp.img_id for Image-to-video, first-and-last-frame generation or reference-to-video.

The same Resp.img_id can also be used in img_ids for image template generation. Follow the selected template’s required image count and order.

PixVerse upload image — official documentationView the corresponding upstream protocol definition.