Generations
Erstelle Static Ads, Video Ads, UGC Ads und AI-Model-Ergebnisse.
POST /generations
Stellt eine oder mehrere Generations in die Queue.
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 '{...}'
Gemeinsame Felder
| Feld | Typ | Notizen |
|---|---|---|
type | string | static_ad, video_ad, ugc_ad oder ai_model. |
prompt | string | User-Anweisung. |
aspect_ratio | string | 1:1, 9:16, 16:9, 4:5 oder auto. |
reference_image_urls | string[] | Produkt-, Marken-, Personen-, Szenen-, Stil- oder First-Frame-Referenzen. |
brand_kit_id | number | Brand Kit aus GET /assets. |
avatar_id | string | Avatar aus GET /assets. |
preset_id | string | Integriertes Preset aus GET /models. |
custom_reference_inspiration_id | uuid | Gespeicherte Referenz. |
Typen
Static Ads nutzen template_slug und resolution.
Video Ads und UGC Ads nutzen template_slug, quality_tier, aspect_ratio, Produktbilder und optional avatar_id.
AI Models nutzen model_slug, variant_id und die Inputs aus GET /models.