Endpoints
jobs
Was this page helpful?
Poll an API-created media job and retrieve signed output URLs when it is ready.
Requested model and actual model
model is the public model requested at submission and never changes. modelUsed is the model of the last clip; use modelsUsed for index-aligned per-clip truth on mixed outputs. fallbackFired is true after a model switch, including while the job is still running. These fallback fields apply to workflows with a fallback chain. Stitch jobs use stitch for both model and modelUsed.
Status fields
{
"model": "seedance-2",
"modelUsed": "seedance-2",
"modelsUsed": [
"seedance-2"
],
"fallbackFired": false
}GET
/api/v1/jobs/{id}
Get job status
Limited to 120 requests per minute per key. Image creditsCharged is net of refunds.
Authentication: Bearer API key required
curl "https://reviral.ai/api/v1/jobs/$JOB_ID" \
-H "Authorization: Bearer $REVIRAL_API_KEY"Responses
- 200
- Owned API job
- 401
- Key is missing, revoked, or invalid
- 404
- Job is not owned or does not exist
- 429
- Too many requests
- 502
- Job status could not be checked
- 503
- Models or rate limiting are temporarily unavailable