Templates

Create a template

POST /api/v1/templates

Create a new template with model settings and optional folder mappings.

Authentication

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

Body parameters

Name	Type	Description
`name` required	string
`prompt` required	string
`model` required	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` required	string	Aspect ratio, e.g. 1280:720.
`duration` required	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).
`folder_mappings`	array

curl -X POST "https://videitos.click/api/v1/templates" \ -H "Authorization: Bearer $VIDEITOS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"name": "Product loops", "model": "gen4.5", "prompt": "Slow cinematic dolly around the product on a white pedestal", "ratio": "1280:720", "duration": 4}'

import os import requests url = "https://videitos.click/api/v1/templates" headers = {"Authorization": f"Bearer {os.environ['VIDEITOS_API_KEY']}"} payload = { "name": "Product loops", "model": "gen4.5", "prompt": "Slow cinematic dolly around the product on a white pedestal", "ratio": "1280:720", "duration": 4, } 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(`{"name": "Product loops", "model": "gen4.5", "prompt": "Slow cinematic dolly around the product on a white pedestal", "ratio": "1280:720", "duration": 4}`) req, _ := http.NewRequest("POST", "https://videitos.click/api/v1/templates", 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/templates"); 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, '{"name": "Product loops", "model": "gen4.5", "prompt": "Slow cinematic dolly around the product on a white pedestal", "ratio": "1280:720", "duration": 4}'); $response = curl_exec($ch); echo $response;

{ "template": { "id": 42, "name": "Product loops", "model": "gen4.5", "prompt": "Slow cinematic dolly around the product on a white pedestal", "ratio": "1280:720", "duration_seconds": 4, "include_audio": false, "is_enabled": true, "folders": [ { "source_folder": "/incoming", "source_connection_id": 7, "destination_folder": "/processed", "destination_connection_id": 7, "provider": "dropbox" } ], "default_destination_folder": "/processed" }, "message": "Template 'Product loops' created." }