Job UUID from the create clips or edit video response
curl https://api.usenaive.ai/v1/video/clips/job-uuid \
-H "Authorization: Bearer nv_sk_live_..."
{
"id": "job-uuid",
"type": "video_clipping",
"status": "completed",
"progress": 100,
"result": {
"clips": [
{
"id": "clip-uuid-1",
"title": "The Secret to Scaling",
"duration": 42,
"virality_score": {
"total": 87,
"shareability": 82,
"hook_strength": 91,
"story_quality": 85,
"emotional_impact": 90
},
"download_url": "https://...",
"direct_url": "https://...",
"preview_url": "https://..."
}
],
"clip_count": 5,
"top_virality_score": 87
},
"credits_used": 4,
"created_at": "2026-05-19T10:30:00Z",
"completed_at": "2026-05-19T10:37:02Z"
}
Status Values
| Status | Meaning |
|---|
queued | Submitted and processing (typically 5-10 minutes) |
completed | Clips or edited video ready |
failed | Processing failed (no credits deducted) |
cancelled | Job was cancelled |
Result Shapes
When complete, result contains:
| Field | Type | Description |
|---|
clips | array | Array of extracted clips with virality scores |
clip_count | number | Total number of clips extracted |
top_virality_score | number | Highest virality score among all clips |
id, title, duration, virality_score (with total, shareability, hook_strength, story_quality, emotional_impact), download_url, direct_url, preview_url.
Video Editing (video_clip_edit)
When complete, result contains:
| Field | Type | Description |
|---|
video_url | string | Direct URL to the edited video |
download_url | string | Download URL for the edited video |
Also Available
The generic jobs endpoint GET /v1/jobs/:id also returns clip and edit jobs. This endpoint validates that the job is a clipping or editing type.
