Generaciones
Crea static ads, video ads, UGC ads y outputs de modelos AI.
POST /generations
Pone en cola una o más generaciones.
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 '{...}'
Campos Compartidos
| Campo | Tipo | Notas |
|---|---|---|
type | string | static_ad, video_ad, ugc_ad o ai_model. |
prompt | string | Instrucción visible del usuario. |
aspect_ratio | string | 1:1, 9:16, 16:9, 4:5 o auto. |
reference_image_urls | string[] | Referencias de producto, marca, persona, escena, estilo o first frame. |
brand_kit_id | number | Brand kit opcional desde GET /assets. |
avatar_id | string | Avatar opcional desde GET /assets. |
preset_id | string | Preset integrado opcional desde GET /models. |
custom_reference_inspiration_id | uuid | Referencia guardada por el usuario. |
request_count | number | De 1 a 10. |
Static Ads
Usa template_slug desde static_ads[].slug y resolution, normalmente 1K.
Video Ads Y UGC Ads
Usa template_slug, quality_tier, aspect_ratio, imágenes de producto y, si aplica, avatar_id.
AI Models
Usa model_slug, variant_id y los inputs que indique GET /models.