Topaz Video Upscale
Topaz · Video · Video → Video
Video upscaling and enhancement with Topaz AI — Proteus, Artemis, Nyx, Gaia and Starlight models.
topaz-upscale-videoWorkflow: topaz/upscale/videoAuthentication
Send your Picsart API key as a bearer token on every request.
Authorization: Bearer <PICSART_API_KEY>Make a request
One endpoint serves every model: POST to /workflows/v1/models/execute with the model id and its input in the body. The nesting is deliberate — the outer paramsis the envelope every workflow takes, and the inner one is this model's own input. Those inner names are the same unified ones the SDK takes, so a call translates one-to-one between the two — no per-vendor naming to learn.
curl -X POST 'https://api.picsart.com/workflows/v1/models/execute' \
-H 'Authorization: Bearer $PICSART_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"params": {
"model": "topaz-upscale-video",
"params": {
"videoUrl": "https://cdn.example.com/input.mp4"
}
}
}'Async (submit & poll)
This model can run longer than the sync limit (~20s), so send it to /workflows/v1/models/submit, which returns a task id, and poll /workflows/v1/models/{taskId}/result until response.status is COMPLETED or FAILED.
# 1. Submit the job
curl -X POST 'https://api.picsart.com/workflows/v1/models/submit' \
-H 'Authorization: Bearer $PICSART_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"params": {
"model": "topaz-upscale-video",
"params": {
"videoUrl": "https://cdn.example.com/input.mp4"
}
}
}'
# → { "status": "success", "response": { "id": "task_abc123" } }
# 2. Poll until response.status is COMPLETED
curl 'https://api.picsart.com/workflows/v1/models/task_abc123/result' \
-H 'Authorization: Bearer $PICSART_API_KEY'{
"status": "success",
"response": {
"id": "task_abc123",
"status": "COMPLETED",
"result": {
"url": "https://cdn.picsart.com/…/result",
"items": [
{
"url": "https://cdn.picsart.com/…/result"
}
],
"model": "topaz-upscale-video"
},
"usage": {
"credits": 3
}
}
}Parameters
2 parameters, sent inside the inner paramsobject. Identical to the SDK's — one parameter set, whichever transport you use.
| Parameter | Type | Required | Default | Details |
|---|---|---|---|---|
videoUrlSource Video | file (video) | yes | — | — |
modelModel | enum | no | Proteus | Proteus, Artemis HQ, Artemis MQ, Artemis LQ, Nyx, Nyx Fast, Nyx XL, Nyx HF, Gaia HQ, Gaia CG, Gaia 2, Starlight Precise 1, Starlight Precise 2, Starlight Precise 2.5, Starlight HQ, Starlight Mini, Starlight Sharp, Starlight Fast 1, Starlight Fast 2 |
Response
The body arrives in the gateway's status envelope, so the output is at response.result — alongside the task id, its status and the credits charged. Asset models return url plus an items array; text models return text instead.
{
"status": "success",
"response": {
"id": "task_abc123",
"status": "COMPLETED",
"result": {
"url": "https://cdn.picsart.com/…/result",
"items": [
{
"url": "https://cdn.picsart.com/…/result"
}
],
"model": "topaz-upscale-video"
},
"usage": {
"credits": 3
}
}
}