GET /api/v1/video-status.php

Video Status

Retrieve the current status, output URL and metadata of any video generation job you own. Use the video_id returned from a generation request.

Synchronous by default

The generation endpoints (/text-to-video, /image-to-video) are synchronous and return the video URL directly in the response, you don't need to poll. Use this endpoint only for auditing past generations or building custom monitoring.

Query Parameters

Parameter	Type	Required	Description
`video_id`	string	Required	The video ID returned in the generation response (e.g. `vid_a1b2c3d4`).

Request Example

cURL

curl "https://nanobananavideo.com/api/v1/video-status.php?video_id=vid_a1b2c3d4" \
  -H "Authorization: Bearer $NB_API_KEY"

Response Fields

Success Response (200)

{
  "success": true,
  "video": {
    "id":                    "vid_a1b2c3d4e5f6",
    "status":                "completed",
    "title":                 "Text to Video",
    "description":           "A cinematic aerial shot of a golden beach at sunset",
    "mode":                  "text-to-video",
    "resolution":            "1080p",
    "duration_seconds":      5,
    "output_url":            "https://cdn.nanobananavideo.com/videos/vid_a1b2c3.mp4",
    "thumbnail_url":         "https://cdn.nanobananavideo.com/thumbs/vid_a1b2c3.jpg",
    "credits_used":          7,
    "created_at":            "2026-05-05T16:00:00Z",
    "updated_at":            "2026-05-05T16:00:07Z",
    "processing_started_at":  "2026-05-05T16:00:01Z",
    "processing_completed_at":"2026-05-05T16:00:07Z"
  }
}

Status Values

Status	Description
`pending`	Job created, awaiting processing.
`processing`	Generation is in progress (image + video pipeline running).
`completed`	Video generated successfully. `output_url` is set.
`failed`	Generation failed. Credits may be refunded, contact support.

Error Responses

Status	Message	Cause
`400`	video_id parameter is required	Missing query parameter
`401`	API key required	Missing or invalid auth header
`403`	Access denied	Video belongs to a different user
`404`	Video not found	Invalid or non-existent video_id