GET videos/video_id

Retrieve a generated video or image information

December 6, 2024 (September 22, 2025)

Request Headers
Path parameter
Responses
Model
Examples
Try It

Use this endpoint to retrieve a generated video or image information. Attempting to retrieve a video that is still processing will result in a 404 response. Use GET /videos to retrieve all available videos.

As of September 2025, the only endpoint capable of image generation is POST videos/create when an image template_id is used (template_type: 2). We’re planning to add separate images endpoints once PixVerse rolls out fully-fledged image generation.

https://api.useapi.net/v2/pixverse/videos/video_id

Request Headers

Authorization: Bearer {API token}
Content-Type: application/json

API token is required, see Setup useapi.net for details.

Path parameter

video_id is required. Specify the video_id or image_id you want to retrieve.

Responses

200 OK

{
    "video_id": "user:<userid>-pixverse:<email>-video:112233445566",
    "video_status": 1,
    "account_id": 33445566,
    "created_at": "2024-11-11T12:34:56Z",
    "first_frame": "https://media.pixverse.ai/....jpg",
    "output_width": 2560,
    "output_height": 1472,
    "original_video_id": "user:<userid>-pixverse:<email>-video:66778899",
    "upscaled": 1,
    "prompt": "<prompt>",
    "model": "v3",
    "negative_prompt": "<negative prompt>",
    "quality": "360p",
    "motion_mode": "normal",
    "asset_id": 0,
    "auto_character_prompt": 0,
    "seed": 0,
    "likes": 0,
    "model_name": "",
    "queue_data": {
        "queue_time": 1,
        "queue_count": 0
    },
    "video_duration": 5,
    "last_frame": "",
    "extended": 0,
    "lip_sync": null,
    "url": "https://media.pixverse.ai/...mp4",
    "img_id": 115994841,
    "img_url": "https://media.pixverse.ai/...webp",
    "duration": 5,
    "motion_brush": "",
    "asset_name": "",
    "asset_img_url": "",
    "remove_watermark": 1,
    "nick_name": "<name>",
    "avatar": "https://media.pixverse.ai/...jpeg",
    "aspect_ratio": "",
    "camera_movement": "default",
    "relation_type": 0,
    "style": "",
    "template_id": 307489548427968,
    "template_name": "Crazy Cat Woman",
    "template_thumbnail_url": "https://media.pixverse.ai/asset%2Ftemplate%2Fcatwoman.png",
    "template_thumbnail_video_url": "https://media.pixverse.ai/asset%2Ftemplate%2Fcatwoman.mp4",
    "template_i18n_json": "{\"zh-CN\":{\"display_name\":\"疯狂猫女变身\",\"display_prompt\":\"变身妖娆猫女，撩翻全场！\"}}",
    "workflow_tag": "",
    "customer_paths": null,
    "platform": "",
    "off_peak": 0,
    "video_status_name": "COMPLETED",
    "video_status_final": true
}

400 Bad Request

{
    "error": "<Error message>",
    "code": 400
}

401 Unauthorized

{
  "error": "Unauthorized",
  "code": 401
}

404 Not Found

The video was deleted, not found, or is still processing.
```
{
    "error": "The original video has been deleted"
}
```

Model

{   // TypeScript, all fields are optional
    video_id: string
    video_status: number
    account_id: number
    created_at: string
    first_frame: string
    output_width: number
    output_height: number
    original_video_id: number
    upscaled: number
    prompt: string
    model: string
    negative_prompt: string
    quality: string
    motion_mode: string
    asset_id: number
    auto_character_prompt: number
    seed: number
    likes: number
    model_name: string
    queue_data?: {
        queue_time: number
        queue_count: number
        estimated_gen_time?: number
        processing_start_time?: string
    }
    video_duration: number
    last_frame: string
    extended: number
    lip_sync?: any
    original_sound_switch: number
    sound_effect_switch: number
    lip_sync_switch: number
    is_sound: number
    url: string
    video_path: string
    img_id: number
    img_url: string
    img_path: string
    customer_img_path?: string
    customer_img_url?: string
    duration: number
    motion_brush: string
    asset_name: string
    asset_img_url: string
    remove_watermark: number
    nick_name: string
    avatar: string
    aspect_ratio: string
    camera_movement: string
    relation_type: number
    style: string
    template_id: number
    template_name: string
    template_thumbnail_url: string
    template_thumbnail_video_url: string
    template_thumbnail_gif_url: string
    template_i18n_json: string
    workflow_tag: string
    customer_paths?: {
        customer_img_url?: string
        customer_img_path?: string
        lip_sync_audio_url?: string
        lip_sync_audio_path?: string
        lip_sync_tts_content?: string
        sound_effect_content?: string
        lip_sync_tts_audio_path?: string
        lip_sync_tts_speaker_id?: string
        customer_video_url?: string
        customer_video_path?: string
        customer_video_duration?: number
        customer_first_frame?: string
        customer_last_frame?: string
        customer_first_frame_url?: string
        customer_last_frame_url?: string
        customer_img_urls?: string[]
        customer_img_paths?: string[]
        customer_lip_sync_audio_path?: string
    }
    platform: string
    create_mode: string
    qualities?: string[] | null
    lora_weight: number
    restyle_id: number
    restyle_prompt: string
    off_peak: number
    // added
    video_status_name: string
    video_status_final: boolean
    error: string
}

Examples

curl "https://api.useapi.net/v2/pixverse/videos/video_id" \
   -H "Accept: application/json" \
   -H "Authorization: Bearer …" 

const token = "API token";
const video_id = "video_id to retrieve"; 
const apiUrl = `https://api.useapi.net/v2/pixverse/videos/${video_id}`; 
const response = await fetch(apiUrl, {
  headers: {
    "Authorization": `Bearer ${token}`,
  },
});
const result = await response.json();
console.log("response", {response, result});

import requests
token = "API token"
video_id = "video_id to retrieve"
apiUrl = f"https://api.useapi.net/v2/pixverse/videos/{video_id}"
headers = {
    "Content-Type": "application/json", 
    "Authorization" : f"Bearer {token}"
}
response = requests.get(apiUrl, headers=headers)
print(response, response.json())