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
`output_type`	string	Output type: video (default) or image.
`model` required	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` required	string	Aspect ratio, e.g. 1280:720 or 1920:1080.
`duration` required	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).
`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." }