Core prediction workflow operations
Submit a request to generate images or videos using one of the
available AI models. This is the first step in the workflow.
The request will be queued for processing and you’ll receive a prediction
ID to track its status.
The model to use is specified via the Model header. The request body structure
varies by model (see examples below).
If the Try-Sync header is set to true, the API will wait up to 60 seconds
for completion. If generation completes within this time, the response will
include the final result directly.
The AI model to use for generation. Each model has specific capabilities and input requirements.
Allowed values:flux-devflux-dev-loraflux-2-klein-4bwan-i2vwan-t2vwan-image-smallqwen-imageqwen-image-fastqwen-image-edit-plusvacep-imagep-image-editp-image-lorap-image-edit-loraz-image-turboz-image-turbo-lorap-image-trainerp-image-edit-trainer
If true, the API will wait up to 60 seconds for the generation to complete.
Default:false
Model-specific input parameters
Prediction request created successfully. Returns either an async response with prediction ID (default) or a sync response with final results (if Try-Sync=true and generation completes within 60 seconds).
One OfUnique identifier for the prediction
Example:1zww7deyssrme0csqwr90phzzr
Model identifier used for this prediction
Example:vace
The input parameters provided for this prediction
URL to check prediction status
Example:https://api.pruna.ai/v1/predictions/status/1zww7deyssrme0csqwr90phzzr
Check the status of a prediction request. This is the second step
in the asynchronous workflow.
When the prediction is completed successfully, the response will include download
URLs for the generated content (images or videos).
Rate limit: 30,000 requests per minute.
The prediction ID returned from the initial request
Example:1knpbkf075rme0csjqr987hg4w
Prediction status retrieved successfully
Current status of the prediction
Allowed values:startingprocessingsucceededfailedcanceled
Example:processing
URL to download the generated content (available when status is ‘succeeded’)
Example:https://api.pruna.ai/v1/predictions/delivery/xezq/52UGYRrRfqViaKmvYsEnENTh0qLDAWHptQ8jOnEHu7XC6AtKA/output.mp4
Status message
Example:Generation in progress
Error details (available when status is ‘failed’)
Example:Number of samples, -5, must be non-negative.
Upload files to be used as input for predictions
Upload a file (image or video) to be used as input for predictions.
The uploaded file will be stored temporarily and can be referenced in prediction
requests by its URL.
Uploaded files are available for 30 minutes after upload
and are automatically deleted after expiration. Use the returned URL in
your prediction input fields that accept file URLs.
Rate limit: 10000 requests per minute
Example with curl:
curl -X POST "https://api.pruna.ai/v1/files" \
-H "apikey: YOUR_API_KEY" \
-F "content=@/path/to/your/file.jpg"
Note: Use -F (form) with @ prefix to upload a file from your local filesystem.
The file to upload (image or video)
File uploaded successfully
Unique identifier for the uploaded file
Example:fqadqq42xq
Original filename
Example:test.jpg
MIME type of the uploaded file
Example:image/jpeg
File size in bytes
Example:185093
Entity tag for cache validation
Example:"14e9a51deaac6bee2dd8b5c52d7d0b5f"
File integrity checksums
Additional file metadata (varies by file type)
Timestamp when the file was uploaded
Example:2025-01-08T18:51:26.729Z
Timestamp when the file will expire and be deleted
Example:2025-01-09T18:51:26.729Z
URLs to access the uploaded file