Generierungsvorlagen

Vorlagen sind vorgefertigte “kreative Effekt”-Rezepte für /v1/images/generations und /v1/videos/generations. Jede Vorlage enthält ein empfohlenes Modell, eine Liste unterstützter Modelle, Standardparameter und erforderliche Eingaberegeln. Geben Sie template: "<slug>" in den Anforderungstext weiter, und EmpirioLabs wendet den Effekt auf alles andere an, was Sie anbieten, wählt das am besten unterstützte Modell für Sie aus und leitet den Anruf an den Mitarbeiter weiter.

Der gleiche Template-Katalog treibt den Templates-Button im Spielplatz an.

Listenvorlagen

1
curl https://api.empiriolabs.ai/v1/templates \
2
     -H "Authorization: Bearer <token>" \
3
     -H "Content-Type: application/json"

Verwenden Sie den generischen Endpunkt für den vollständigen Bild- und Videokatalog oder die modalitätsspezifischen Endpunkte, wenn Sie den Erzeugungstyp bereits kennen.

$
curl https://api.empiriolabs.ai/v1/templates?modality=image \
>
  -H "Authorization: Bearer $EMPIRIOLABS_API_KEY"

Listen von Videovorlagen

1
curl https://api.empiriolabs.ai/v1/videos/templates \
2
     -H "Authorization: Bearer <token>" \
3
     -H "Content-Type: application/json"

Filter

• category: viral, cinematic, motion, transform, social, extend, product, edit, portrait
• modality: video oder image
• model: Nur Vorlagen zurückgeben, die ein bestimmtes Modell unterstützen
• featured: true nur auf vorgestellte Vorlagen filtern

$
curl https://api.empiriolabs.ai/v1/videos/templates?category=viral \
>
  -H "Authorization: Bearer $EMPIRIOLABS_API_KEY"

Antwortform

1
{
2
  "object": "list",
3
  "template_count": 11,
4
  "data": [
5
    {
6
      "slug": "baseball-stadium",
7
      "display_name": "Stadium",
8
      "category": "viral",
9
      "description": "Customer-facing description shown in the playground card.",
10
      "recommended_model": "kling-o3",
11
      "supported_models": ["kling-o3"],
12
      "default_params": { "aspect_ratio": "16:9", "duration": 10 },
13
      "required_inputs": { "image": true, "min_images": 1, "max_images": 1 },
14
      "cover_image_url": "https://media.empiriolabs.ai/assets/template-posters/baseball-stadium.jpg",
15
      "preview_video_url": "https://media.empiriolabs.ai/assets/template-previews/baseball-stadium.mp4",
16
      "modality": "video",
17
      "is_featured": true,
18
      "display_order": 10
19
    }
20
  ]
21
}

Listbildvorlagen

1
curl https://api.empiriolabs.ai/v1/images/templates \
2
     -H "Authorization: Bearer <token>" \
3
     -H "Content-Type: application/json"

$
curl https://api.empiriolabs.ai/v1/images/templates?model=seedream-5-0-lite \
>
  -H "Authorization: Bearer $EMPIRIOLABS_API_KEY"

Hol eine einzelne Vorlage

1
curl https://api.empiriolabs.ai/v1/templates/studio-product-shot \
2
     -H "Authorization: Bearer <token>" \
3
     -H "Content-Type: application/json"

$
curl https://api.empiriolabs.ai/v1/templates/studio-product-shot \
>
  -H "Authorization: Bearer $EMPIRIOLABS_API_KEY"

Gibt 404 mit code: "template_not_found" zurück, falls der Slug nicht existiert.

Erstellen Sie ein Video mit einer Vorlage

Füge template: "<slug>" zu einem normalen /v1/videos/generations hinzu. Du musst alles bereitstellen, was die Vorlage verlangt (required_inputs), in der Regel ein Referenzbild.

$
curl https://api.empiriolabs.ai/v1/videos/generations \
>
  -H "Authorization: Bearer $EMPIRIOLABS_API_KEY" \
>
  -H "Content-Type: application/json" \
>
  -d '{
>
    "template": "baseball-stadium",
>
    "image_url": "https://example.com/me.jpg"
>
  }'

Verhalten:

• Modellauswahl: Wenn du model nicht bestehst, wird die recommended_model der Vorlage verwendet. Wenn ja, bestätigen die meisten Vorlagen, dass sie in supported_models sind, und geben 400 template_model_unsupported ansonsten zurück. Templates mit metadata.force_recommended_model: true sind für die Effekttreue an recommended_model gepinnt.
• Modalitätsprüfung: Bildvorlagen gelten nur für /v1/images/generations; Videovorlagen gelten nur für /v1/videos/generations.
• Prompt-Blending: Dein prompt (falls vorhanden) wird mit dem integrierten Stil der Vorlage kombiniert, sodass die generierte Ausgabe sowohl zu deiner Anfrage als auch zur Ästhetik des Effekts passt. Senden Sie eine kurze Richtungsanweisung; EmpirioLabs übernimmt den Rest.
• Standardparams: default_params aus der Vorlage nur für Schlüssel, die du nicht explizit gesetzt hast, zusammenfügen.
• Erforderliche Eingaben: \{ "image": true \} bedeutet, dass der Anruf 400 template_missing_image zurückgibt, wenn kein image_url / image / images angegeben wird.

Erstelle ein Bild mit einer Vorlage

$
curl https://api.empiriolabs.ai/v1/images/generations \
>
  -H "Authorization: Bearer $EMPIRIOLABS_API_KEY" \
>
  -H "Content-Type: application/json" \
>
  -d '{
>
    "template": "background-swap",
>
    "prompt": "Place this product on a brushed steel studio plinth",
>
    "image": ["https://example.com/product.jpg"]
>
  }'

Die Antwort ist dieselbe asynchrone Job-Hüllkurve wie bei einer normalen Videoerzeugung:

1
{
2
  "job_id": "abc123...",
3
  "status": "processing",
4
  "poll_url": "/v1/jobs/abc123..."
5
}

Frage GET /v1/jobs/\{job_id\} bis zum Terminal.

Verlängere ein vorheriges Video

/v1/videos/generations akzeptiert auch extend_from, eine vorherige Generation fortzuführen. EmpirioLabs übernimmt die Prior-Clip-Verkabelung für dich und verwendet eine sinnvolle Continuity-Eingabe, es sei denn, du stellst deine eigene bereit.

$
curl https://api.empiriolabs.ai/v1/videos/generations \
>
  -H "Authorization: Bearer $EMPIRIOLABS_API_KEY" \
>
  -H "Content-Type: application/json" \
>
  -d '{
>
    "extend_from": { "job_id": "<prior_job_id>" }
>
  }'

Du kannst auch eine direkte URL weitergeben:

1
{ "extend_from": { "video_url": "https://media.empiriolabs.ai/..." } }

Extend kann mit Vorlagen schreiben:

1
{
2
  "template": "action-hero",
3
  "extend_from": { "job_id": "<prior>" }
4
}

Extend funktioniert bei jedem Videomodell

Bestehen Sie extend_from mit jedem unterstützten Videomodell. Wenn du model weglässt, wählt EmpirioLabs einen sinnvollen Standard für die Verlängerung.

Fehlercodes