MAKEUGC PLATFORM API · DOCS V2

Video Extend

Build a continuous video from connected Veo 3.1 scenes.

Workflow

Describe one to four scenes in sequence.
Optionally provide a first-frame image and choose fast or pro.
Submit once, then poll for the final connected video.

Send X-Api-Key on every MakeUGC request. POST operations require an active paid subscription and a positive credit balance; custom voice creation also requires a plan with custom voices.

Requests are strict JSON: unknown fields, user_id and webhook_url are rejected. Use polling for jobs; these endpoints do not send webhooks.

The outer status boolean indicates request success. Most jobs use data.status: processing, completed or failed; Upscale documents its own statuses. Poll every 5–10 seconds and require a non-empty result URL (or voice_id) before using output.

API credit units × 100 = website display credits. A timeout, network error or 5xx may occur after acceptance: do not automatically resubmit a paid operation. If submission_unknown is true, check the project or contact support with x-request-id; reserved credits remain held until the result is resolved.

Example IDs and media URLs are placeholders. Replace them with values from your account and accessible media files.

Generate connected scenes #

POST /video-extend/generate

Create one to four connected scenes using Veo 3.1. Start from a prompt or image and extend the generated first scene.

The first scene uses an 8-second duration; continuation length is controlled by the model. This endpoint builds a new sequence; it does not accept an existing video URL.

end_image_url is supported only when scenes has one item. fast and pro select the Veo tier. Charges depend on tier and scene count.

Request body

Parameter	Description
`project_id` string Optional	Existing project owned by your account. Omit to create one. Allowed: `At least 1 characters; Up to 256 characters`
`model` string Optional	model input. Allowed: `fast \| pro` Default: `fast`
`scenes` object[] Required	scenes input. Allowed: `At least 1 items; Up to 4 items`
`scenes[].prompt` string Required	prompt input. Allowed: `At least 1 characters; Up to 2000 characters`
`image_url` string Optional	Public HTTP(S) media URL. Private addresses, credentials and data URIs are not accepted.
`end_image_url` string Optional	Public HTTP(S) media URL. Private addresses, credentials and data URIs are not accepted.
`aspect_ratio` string Optional	aspect ratio input. Allowed: `9:16 \| 16:9 \| 1:1` Default: `9:16`

Request example

cURL

curl --fail-with-body --max-time 120 -X POST "https://app.makeugc.ai/api/platform/video-extend/generate" \
  -H "X-Api-Key: $MAKEUGC_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "project_id": "project_123",
  "model": "fast",
  "image_url": "https://your-cdn.example/product.jpg",
  "scenes": [
    {
      "prompt": "A slow close-up of the cup on a sunlit table."
    },
    {
      "prompt": "Continue the same shot as a hand picks up the cup."
    }
  ],
  "aspect_ratio": "9:16"
}'

JavaScript

// Run on your server with Node.js 20+.
const apiKey = process.env.MAKEUGC_API_KEY;
if (!apiKey) throw new Error("Set MAKEUGC_API_KEY first");

const response = await fetch("https://app.makeugc.ai/api/platform/video-extend/generate", {
  method: "POST",
  headers: {
    "X-Api-Key": apiKey,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "project_id": "project_123",
  "model": "fast",
  "image_url": "https://your-cdn.example/product.jpg",
  "scenes": [
    {
      "prompt": "A slow close-up of the cup on a sunlit table."
    },
    {
      "prompt": "Continue the same shot as a hand picks up the cup."
    }
  ],
  "aspect_ratio": "9:16"
}),
  signal: AbortSignal.timeout(120000),
});
const text = await response.text();
if (!response.ok) {
  throw new Error(`HTTP ${response.status}: ${text} (request ${response.headers.get("x-request-id")})`);
}
const result = JSON.parse(text);
console.log(result);

Python

# Install the requests package before running.
import os
import requests

payload = {
    "project_id": "project_123",
    "model": "fast",
    "image_url": "https://your-cdn.example/product.jpg",
    "scenes": [{
        "prompt": "A slow close-up of the cup on a sunlit table."
    }, {
        "prompt": "Continue the same shot as a hand picks up the cup."
    }],
    "aspect_ratio": "9:16"
}

response = requests.post(
    "https://app.makeugc.ai/api/platform/video-extend/generate",
    headers={"X-Api-Key": os.environ["MAKEUGC_API_KEY"]},
    json=payload,
    timeout=120,
)
if not response.ok:
    raise RuntimeError(f"HTTP {response.status_code}: {response.text} "
                       f"(request {response.headers.get('x-request-id')})")
print(response.json())

200 response example

JSON response

{
  "status": true,
  "data": {
    "id": "job_123",
    "project_id": "project_123",
    "status": "processing",
    "scene_count": 2
  }
}

All requests require X-Api-Key. See errors & retries for unsuccessful responses.

Get connected video status #

GET /video-extend/status

Poll until the final connected output is available in video_url.

Parameters

Parameter	Description
`id` string · query Required	id input. Allowed: `At least 1 characters; Up to 256 characters`