vibedream.ai logo
vibedream.ai

text-to-video

Video Upscaler

AI Video Upscaler enhances resolution and clarity to fix blurry outputs and improve low-resolution footage with ML upscaling. It features a ready-to-use REST inference API, optimized performance, and affordable pricing.

Use one of our client libraries to get started quickly.

Video Upscaler

AI Video Upscaler enhances resolution and clarity to fix blurry outputs and improve low-resolution footage with ML upscaling. It features a ready-to-use REST inference API, optimized performance, and affordable pricing.. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

Video output~5–10 seconds per second of videofrom $0.03/run

1. Calling the API

Submit a request

Send a POST request to start generation. The API returns immediately with a prediction ID for polling.

curl -X POST "https://api.vibedream.ai/api/v1/models/video-upscaler/generate" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $VIBEDREAM_API_KEY" \
  -d '{
    "video": "https://example.com/your-video.mp4",
    "target_resolution": "720p",
    "Enable Safety Checker": false
}'

2. Authentication

The API uses an API Key for authentication.

Get your API Key

Get your API key from vibedream.ai/models/api-keys.

Environment variable

export VIBEDREAM_API_KEY="your-api-key"

3. Queue & Results

Generation requests are queued and processed asynchronously. Poll the prediction endpoint until status is completed or failed.

Submit request

curl -X POST "https://api.vibedream.ai/api/v1/models/video-upscaler/generate" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $VIBEDREAM_API_KEY" \
  -d '{
    "video": "https://example.com/your-video.mp4",
    "target_resolution": "720p",
    "Enable Safety Checker": false
}'

Response

Returns immediately with a prediction ID. Use id to poll for results.

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "processing",
  "statusUrl": "https://api.vibedream.ai/api/v1/predictions/550e8400-e29b-41d4-a716-446655440000",
  "estimatedTime": "5–10 seconds per second of video",
  "costCents": 3,
  "createdAt": "2025-01-15T12:00:00.000Z"
}

Get the result

Polling

# Replace YOUR_PREDICTION_ID with the id from the submit response
curl "https://api.vibedream.ai/api/v1/predictions/YOUR_PREDICTION_ID" \
  -H "Authorization: Bearer $VIBEDREAM_API_KEY"

# Poll every 1-2s until status is "completed" or "failed"

Completed response

outputs is string[] — an array of direct download URLs hosted on assets.vibedream.ai.

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "modelId": "video-upscaler",
  "modelName": "Video Upscaler",
  "status": "completed",
  "outputs": [
    "https://assets.vibedream.ai/outputs/550e8400-e29b-41d4-a716-446655440000/1736942400000-0.mp4"
  ],
  "error": null,
  "createdAt": "2025-01-15T12:00:00.000Z",
  "completedAt": "2025-01-15T12:00:30.000Z"
}

Failed response

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "modelId": "video-upscaler",
  "modelName": "Video Upscaler",
  "status": "failed",
  "outputs": null,
  "error": "Your request was flagged by content moderation. Please modify your prompt.",
  "createdAt": "2025-01-15T12:00:00.000Z",
  "completedAt": "2025-01-15T12:00:05.000Z"
}
FieldTypeDescription
idstringUnique prediction ID (UUID).
modelIdstringID of the model used for generation.
modelNamestringHuman-readable model name.
statusstringCurrent status. One of: processing, completed, failed.
outputsstring[] | nullArray of output URLs. Each URL is a direct download link to the generated file on assets.vibedream.ai. null when still processing or failed.
errorstring | nullError message if the generation failed. null on success.
createdAtstringISO 8601 timestamp when the request was submitted.
completedAtstring | nullISO 8601 timestamp when generation finished. null while processing.

4. Schema

Input

ParameterTypeRequiredDefaultRangeDescription
videostringYes----Video file to be upscaled.Pass a public video URL. Accepted: MP4, WebM, MOV.
target_resolutionstringYes--720p, 1080p, 2k, 4kChoose the resolution for the output video.
Enable Safety CheckerbooleanNo----Toggle to enable safety checks during processing.

Example request

{
    "video": "https://example.com/your-video.mp4",
    "target_resolution": "720p",
    "Enable Safety Checker": false
}

Output

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "modelId": "video-upscaler",
  "modelName": "Video Upscaler",
  "status": "completed",
  "outputs": [
    "https://assets.vibedream.ai/outputs/550e8400-e29b-41d4-a716-446655440000/1736942400000-0.mp4"
  ],
  "error": null,
  "createdAt": "2025-01-15T12:00:00.000Z",
  "completedAt": "2025-01-15T12:00:30.000Z"
}