Video

Get Video Task

Check a video task and collect the finished clip.

Poll every 10–15 seconds. When status is succeeded, output.video_url holds a durable CDN URL.

GET/v1/videos/tasks/{id}Try it

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your SpicyAPI key (sk-spicy-…). Create one in the dashboard under API Keys.

Response

200 — application/json

Successful Response

idstringrequired

The task id.

statusstringrequired

queued, processing, finalizing, succeeded, or failed.

outputobject | null

Present once finished.

errorstring | null

Failure reason, if any. Failed tasks are refunded.

cost_usdnumberrequired

What this request cost, in US dollars, already debited from your balance.

Was this page helpful?

Suggest edits Raise issue

Create Chat Completion

Get Video Task

cURL

curl --request GET \
  --url https://api.spicyapi.com/v1/videos/tasks/task_5d9e2f10 \
  --header 'Authorization: Bearer $SPICYAPI_KEY'

200

JSON

{
  "id": "task_5d9e2f10",
  "object": "task",
  "type": "video",
  "model": "spicy-pov-missionary-1",
  "status": "succeeded",
  "output": {
    "video_url": "https://cdn.spicyapi.com/outputs/a1b2/task_5d9e2f10.mp4"
  },
  "error": null,
  "cost_usd": 0.875
}