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