Cinematic clip (4K)

video Queued Runs in the background — you get a link when it is ready.

Our most cinematic photo-to-video, at 4K — when the footage has to hold up on the largest screens.

Built for

Premium listings
Broadcast and event screens
Crop-and-reframe workflows

How it works

You provide

A starting photo, a sentence describing the shot, and the clip length (5 or 10 seconds).

You get back

One 4K video clip with sound.

What this means for you

Four times the pixels of 1080p — room to crop and reframe.
The same shot at 720p or 1080p costs a fraction; pick 4K on purpose.
Sound included.

Try it

Use the API

Details

What you can set

Setting	Type and limits	What it means
`prompt` required	text, 1–2000 characters	Motion/scene description.
`duration` required	whole number, one of: 5, 10	Clip length in seconds — 5 or 10 only (ADR 0013).
`image_url` required	text, 1–2048 characters	Starting frame (JPEG, PNG or WebP). An uploaded file_url from /v1/uploads (validated for ownership) or an external image URL.
`resolution` required	text, one of: 4k	This capability renders at 4K — the value is fixed. For 720p or 1080p use the sibling capabilities.
`aspect_ratio` optional	text, one of: auto, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16	Frame shape; auto (matches the image) when omitted.
`end_image_url` optional	text, 1–2048 characters	Optional final frame for a transition from the start image.

What you get back: An MP4 video
Limits: second of clip: 5–10
How it runs: Queued — Runs in the background — you get a link when it is ready.
Alias: oneup/video-cinematic-4k

For developers

The same request as an API call, with this capability's example input:

curl -X POST https://api.oneupai.com/v1/queue/submit/oneup/video-cinematic-4k \
  -H "Authorization: Bearer $ONEUP_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
  "prompt": "golden-hour drone reveal of the house, slow and steady",
  "duration": 5,
  "image_url": "https://example.com/frame.jpg",
  "resolution": "4k"
}'

Show input schema (JSON)

{
  "type": "object",
  "required": [
    "prompt",
    "image_url",
    "duration",
    "resolution"
  ],
  "properties": {
    "prompt": {
      "type": "string",
      "maxLength": 2000,
      "minLength": 1,
      "description": "Motion/scene description."
    },
    "duration": {
      "enum": [
        5,
        10
      ],
      "type": "integer",
      "description": "Clip length in seconds — 5 or 10 only (ADR 0013)."
    },
    "image_url": {
      "type": "string",
      "maxLength": 2048,
      "minLength": 1,
      "description": "Starting frame (JPEG, PNG or WebP). An uploaded file_url from /v1/uploads (validated for ownership) or an external image URL."
    },
    "resolution": {
      "enum": [
        "4k"
      ],
      "type": "string",
      "description": "This capability renders at 4K — the value is fixed. For 720p or 1080p use the sibling capabilities."
    },
    "aspect_ratio": {
      "enum": [
        "auto",
        "21:9",
        "16:9",
        "4:3",
        "1:1",
        "3:4",
        "9:16"
      ],
      "type": "string",
      "description": "Frame shape; auto (matches the image) when omitted."
    },
    "end_image_url": {
      "type": "string",
      "maxLength": 2048,
      "minLength": 1,
      "description": "Optional final frame for a transition from the start image."
    }
  },
  "additionalProperties": false
}

API Docs

Cinematic clip (4K)

How it works

You provide

You get back

What this means for you

Try it

Details

What you can set

For developers

Other video capabilities

Photo to video clip

Cinematic clip (720p)

Cinematic clip (1080p)

Photo to full-motion clip

Lip-sync a video (studio)

Talking photo

Lip-sync a video

Rendered short video

Captions on your video