Generazioni
Crea static ads, video ads, UGC ads e output di modelli AI.
POST /generations
Mette in coda una o più generazioni.
curl -X POST https://videotok.app/api/v1/generations \
-H "Authorization: Bearer vt_live_..." \
-H "Content-Type: application/json" \
-H "Idempotency-Key: generation-001" \
-d '{...}'
Campi Condivisi
| Campo | Tipo | Note |
|---|---|---|
type | string | static_ad, video_ad, ugc_ad o ai_model. |
prompt | string | Istruzione dell’utente. |
aspect_ratio | string | 1:1, 9:16, 16:9, 4:5 o auto. |
reference_image_urls | string[] | Referenze prodotto, brand, persona, scena, stile o first frame. |
brand_kit_id | number | Brand kit da GET /assets. |
avatar_id | string | Avatar da GET /assets. |
preset_id | string | Preset integrato da GET /models. |
custom_reference_inspiration_id | uuid | Referenza salvata. |
Tipi
Static ads usano template_slug e resolution.
Video ads e UGC ads usano template_slug, quality_tier, aspect_ratio, immagini prodotto e opzionalmente avatar_id.
AI models usano model_slug, variant_id e gli input indicati da GET /models.