Jobs

Generate a video

POST /api/v1/jobs

Start a video generation job. With `template_id`, uses that template's settings and requires an image (`image_url` or `dropbox_path`). Without `template_id`, pass `prompt` plus optional `model`/`ratio`/`duration` for templateless generation (text-to-video when no image is provided).

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 templateless generation with prompt.
`prompt`	string	Text prompt (required when template_id is omitted).
`model`	string	Video model (gen4.5, gen4_turbo, veo3, veo3.1, veo3.1_fast, seedance2, seedance2_fast, seedance2_mini, happyhorse_1_0, gemini_omni_flash). gen4_turbo requires an image.
`ratio`	string	Aspect ratio, e.g. 1280:720.
`duration`	integer	Duration in seconds (model-dependent; defaults to 8 for chat/MCP generation).
`include_audio`	boolean	Include audio (Veo 3.1 and Seedance models only).
`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 '{"prompt": "A cat riding a skateboard, cinematic", "model": "veo3.1_fast", "ratio": "1280:720", "duration": 8}'

import os import requests url = "https://videitos.click/api/v1/jobs" headers = {"Authorization": f"Bearer {os.environ['VIDEITOS_API_KEY']}"} payload = { "prompt": "A cat riding a skateboard, cinematic", "model": "veo3.1_fast", "ratio": "1280:720", "duration": 8, } 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(`{"prompt": "A cat riding a skateboard, cinematic", "model": "veo3.1_fast", "ratio": "1280:720", "duration": 8}`) 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, '{"prompt": "A cat riding a skateboard, cinematic", "model": "veo3.1_fast", "ratio": "1280:720", "duration": 8}'); $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_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" }, "message": "Video generation started (job 123). Use get_job_status to track progress; the video is delivered to the destination folder when done." }