Photo to full-motion clip

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

Turn a photo into a short clip with real motion and a soundtrack — optionally traveling to an end frame.

Built for

Scene animation
Ads with motion
Start-to-end transitions

How it works

You provide

A starting photo, a sentence describing the motion, the clip length (5 or 10 seconds), and optionally an end photo.

You get back

One video clip with sound, at the length you chose.

What this means for you

Sound comes with the clip at no extra charge.
Give it an end photo and it travels there.
5 or 10 seconds — you choose.

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).
`end_image_url` optional	text, 1–2048 characters	Optional final frame — the clip travels from the start image to this one.
`generate_audio` optional	yes / no	Generate a soundtrack with the clip; on when omitted. Priced the same either way.
`negative_prompt` optional	text, 0–500 characters	What to avoid.
`start_image_url` required	text, 1–2048 characters	Starting frame. An uploaded file_url from /v1/uploads (validated for ownership) or an external image URL.

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-motion

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-motion \
  -H "Authorization: Bearer $ONEUP_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
  "prompt": "slow push-in as steam rises from the cup",
  "duration": 5,
  "start_image_url": "https://example.com/frame.jpg"
}'

Show input schema (JSON)

{
  "type": "object",
  "required": [
    "prompt",
    "start_image_url",
    "duration"
  ],
  "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)."
    },
    "end_image_url": {
      "type": "string",
      "maxLength": 2048,
      "minLength": 1,
      "description": "Optional final frame — the clip travels from the start image to this one."
    },
    "generate_audio": {
      "type": "boolean",
      "description": "Generate a soundtrack with the clip; on when omitted. Priced the same either way."
    },
    "negative_prompt": {
      "type": "string",
      "maxLength": 500,
      "description": "What to avoid."
    },
    "start_image_url": {
      "type": "string",
      "maxLength": 2048,
      "minLength": 1,
      "description": "Starting frame. An uploaded file_url from /v1/uploads (validated for ownership) or an external image URL."
    }
  },
  "additionalProperties": false
}

API Docs

Photo to full-motion clip

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)

Cinematic clip (4K)

Lip-sync a video (studio)

Talking photo

Lip-sync a video

Rendered short video

Captions on your video