Jobs

Generate a video

POST /api/v1/jobs

Start a video generation job. Three modes: (1) Studio multi-scene — pass `scenes` (2–8 entries with `prompt` + `duration`, total ≤ 30s); (2) template — pass `template_id` (video templates require `image_url` or `dropbox_path`); (3) templateless — pass `prompt` plus optional `model`/`ratio`/`duration`. Optional start image via `image_url` or `dropbox_path`.

Authentication

Send your API key in the Authorization header: Authorization: Bearer <key>. Create a key.

Body parameters

Name	Type	Description
`template_id`	integer	Template to use. Omit for Studio (scenes) or templateless (prompt) generation.
`prompt`	string	Text prompt (required for templateless generation when scenes is omitted).
`scenes`	array	Studio multi-scene mode: 2–8 scenes, each with prompt and duration. Total duration must be ≤ 30 seconds. Do not combine with template_id.
`source_job_id`	integer	Studio only: reuse the start-frame image from a previous Studio job owned by this user. Do not combine with dropbox_path/image_url.
`output_type`	string	Output type: video (default) or image.
`model`	string	Video models: gen4.5, gen4_turbo, veo3, veo3.1, veo3.1_fast, seedance2, seedance2_fast, seedance2_mini, happyhorse_1_0, gemini_omni_flash. Image models: gen4_image, gen4_image_turbo, gemini_2.5_flash. gen4_turbo requires an input image for video.
`ratio`	string	Aspect ratio, e.g. 1280:720 or 1920:1080.
`duration`	integer	Duration in seconds for video (model-dependent).
`include_audio`	boolean	Include audio (Veo 3.1 and Seedance video models only).
`output_count`	integer	Number of images to generate (1 or 4; image templates only).
`reference_tag`	string	Reference tag for image templates using folder watch (use @tag in prompt).
`dropbox_path`	string	Path of the source image in the user's Dropbox, e.g. /photos/cat.jpg.
`image_url`	string	Public http(s) URL of the source image (JPEG, PNG or WebP).
`source_connection_id`	integer	Storage connection to read dropbox_path from.
`destination_folder`	string	Destination folder for the finished video.
`destination_folder_ref`	string	Google Drive folder id when destination_folder is a Drive destination.
`destination_connection_id`	integer	Storage connection to deliver into when destination_folder is set.

curl -X POST "https://videitos.click/api/v1/jobs" \ -H "Authorization: Bearer $VIDEITOS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"scenes": [{"prompt": "Wide shot of a rainy street at dusk", "duration": 5}, {"prompt": "Close-up of neon reflections on wet pavement", "duration": 5}], "model": "gen4.5", "ratio": "1280:720"}'

import os import requests url = "https://videitos.click/api/v1/jobs" headers = {"Authorization": f"Bearer {os.environ['VIDEITOS_API_KEY']}"} payload = { "scenes": [ { "prompt": "Wide shot of a rainy street at dusk", "duration": 5, }, { "prompt": "Close-up of neon reflections on wet pavement", "duration": 5, }, ], "model": "gen4.5", "ratio": "1280:720", } resp = requests.post(url, headers=headers, json=payload) print(resp.json())

package main import ( "bytes" "fmt" "io" "net/http" "os" ) func main() { payload := bytes.NewBufferString(`{"scenes": [{"prompt": "Wide shot of a rainy street at dusk", "duration": 5}, {"prompt": "Close-up of neon reflections on wet pavement", "duration": 5}], "model": "gen4.5", "ratio": "1280:720"}`) req, _ := http.NewRequest("POST", "https://videitos.click/api/v1/jobs", payload) req.Header.Set("Authorization", "Bearer "+os.Getenv("VIDEITOS_API_KEY")) req.Header.Set("Content-Type", "application/json") resp, _ := http.DefaultClient.Do(req) defer resp.Body.Close() out, _ := io.ReadAll(resp.Body) fmt.Println(string(out)) }

<?php $ch = curl_init("https://videitos.click/api/v1/jobs"); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST"); curl_setopt($ch, CURLOPT_HTTPHEADER, [ "Authorization: Bearer " . getenv("VIDEITOS_API_KEY"), "Content-Type: application/json", ]); curl_setopt($ch, CURLOPT_POSTFIELDS, '{"scenes": [{"prompt": "Wide shot of a rainy street at dusk", "duration": 5}, {"prompt": "Close-up of neon reflections on wet pavement", "duration": 5}], "model": "gen4.5", "ratio": "1280:720"}'); $response = curl_exec($ch); echo $response;

{ "job": { "id": 123, "status": "running", "progress": 0.25, "template_id": 42, "template_name": "Product loops", "source_filename": "cat.jpg", "prompt_snapshot": "A cat riding a skateboard, cinematic", "error_message": "", "credits_charged": 120.0, "output_video_path": "", "output_video_url": "", "output_video_presigned_url": "", "delivery_targets": [ { "provider": "dropbox", "destination_folder": "/processed", "status": "pending", "output_path": "", "last_error": "" } ], "created_at": "2026-07-07T18:00:00+00:00", "updated_at": "2026-07-07T18:00:30+00:00", "mode": "multi_scene", "scenes": [ { "prompt": "Wide shot of a rainy street at dusk", "duration": 5 }, { "prompt": "Close-up of neon reflections on wet pavement", "duration": 5 } ], "scene_count": 2, "scene_index": 0, "progress_label": "Scene 1/2" }, "message": "Studio multi-scene generation started (job 123, 2 scenes). Use get_job_status to track progress." }