Video erstellen · DeutschlandGPT

Startet einen asynchronen Text-zu-Video-Generierungsjob. Verfügbare Modelle umfassen EU-gehostetes Google Veo (auf Vertex AI) sowie fal.ai-Modelle (kling-2.6-pro, seedance-2.0, seedance-2.0-fast, seedance-1-pro, hailuo-02-pro) — tauschen Sie den model-String aus, um den Anbieter zu wechseln. Verwenden Sie /v2/models/all, um alle Videomodelle aufzulisten.

Gibt einen Job-Deskriptor mit status: "pending" zurück. Fragen Sie GET /v2/videos/generations/{id} ab, bis status succeeded (gibt signierte URLs zurück) oder failed (gibt eine Fehlermeldung zurück) ist. Die Generierung dauert typischerweise 30 Sekunden bis mehrere Minuten.

Guthaben wird vorab basierend auf der angeforderten Auflösung, Dauer und Anzahl der Videos belastet. Falls der Job fehlschlägt oder weniger Videos als angefordert liefert, wird die Differenz automatisch erstattet. fal.ai-Modelle akzeptieren zusätzliche Parameter (negative_prompt, generate_audio, cfg_scale, …) über das parameters-Passthrough.

POSThttps://api.deutschlandgpt.de/v2/videos/generationsAusprobieren

Beispielaufruf

curl https://api.deutschlandgpt.de/v2/videos/generations \
  -X POST \
  -H "Authorization: Bearer $DGPT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "prompt": "A golden retriever puppy bounding through autumn leaves, slow motion, cinematic",
  "model": "veo-3.1-fast",
  "n": 1,
  "durationSeconds": 8,
  "resolution": "720p",
  "aspectRatio": "16:9",
  "seed": 0,
  "parameters": {}
}'

curl https://api.deutschlandgpt.de/v2/videos/generations \
  -X POST \
  -H "Authorization: Bearer $DGPT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "prompt": "A golden retriever puppy bounding through autumn leaves, slow motion, cinematic",
  "model": "veo-3.1-fast",
  "n": 1,
  "durationSeconds": 8,
  "resolution": "720p",
  "aspectRatio": "16:9",
  "seed": 0,
  "parameters": {}
}'

import os, requests

response = requests.post(
    "https://api.deutschlandgpt.de/v2/videos/generations",
    headers={"Authorization": f"Bearer {os.environ['DGPT_API_KEY']}"},
    json={
        "prompt": "A golden retriever puppy bounding through autumn leaves, slow motion, cinematic",
        "model": "veo-3.1-fast",
        "n": 1,
        "durationSeconds": 8,
        "resolution": "720p",
        "aspectRatio": "16:9",
        "seed": 0,
        "parameters": {}
    },
)

print(response.json())

import os, requests

response = requests.post(
    "https://api.deutschlandgpt.de/v2/videos/generations",
    headers={"Authorization": f"Bearer {os.environ['DGPT_API_KEY']}"},
    json={
        "prompt": "A golden retriever puppy bounding through autumn leaves, slow motion, cinematic",
        "model": "veo-3.1-fast",
        "n": 1,
        "durationSeconds": 8,
        "resolution": "720p",
        "aspectRatio": "16:9",
        "seed": 0,
        "parameters": {}
    },
)

print(response.json())

const response = await fetch('https://api.deutschlandgpt.de/v2/videos/generations', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DGPT_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "prompt": "A golden retriever puppy bounding through autumn leaves, slow motion, cinematic",
    "model": "veo-3.1-fast",
    "n": 1,
    "durationSeconds": 8,
    "resolution": "720p",
    "aspectRatio": "16:9",
    "seed": 0,
    "parameters": {}
  }),
});

console.log(await response.json());

const response = await fetch('https://api.deutschlandgpt.de/v2/videos/generations', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DGPT_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "prompt": "A golden retriever puppy bounding through autumn leaves, slow motion, cinematic",
    "model": "veo-3.1-fast",
    "n": 1,
    "durationSeconds": 8,
    "resolution": "720p",
    "aspectRatio": "16:9",
    "seed": 0,
    "parameters": {}
  }),
});

console.log(await response.json());

Anfrage-Body

promptstringerforderlich

Textbeschreibung des gewünschten Videos. Englisch liefert die zuverlässigsten Ergebnisse.

modelstringoptional

Zu verwendendes Videomodell. Standard: veo-3.1-fast. Verwenden Sie /v2/models, um verfügbare Videomodelle zu entdecken.

nintegeroptional

Anzahl der zu generierenden Videos. Modellabhängig begrenzt; Veo erlaubt derzeit bis zu 4.

durationSecondsintegeroptional

Länge des Videos in Sekunden. Muss einer der vom Modell unterstützten Dauern entsprechen (Veo: 4, 6 oder 8).

resolutionstringoptional

Ausgabeauflösung. Muss vom Modell unterstützt werden (Veo: 720p, 1080p).

aspectRatiostringoptional

Seitenverhältnis. Muss vom Modell unterstützt werden (Veo: 16:9, 9:16).

seedintegeroptional

Optionaler Seed für reproduzierbare Generierung (sofern vom Modell unterstützt).

parametersobjectoptional

Anbieterspezifisches Passthrough, das in die Upstream-Anfrage eingebunden wird (nur fal.ai). z.B. { "negative_prompt": "blurry", "generate_audio": true }. Wird von Vertex/Veo-Modellen ignoriert.

Antwort

200application/json

{
  "id": "00000000-0000-0000-0000-000000000000",
  "object": "video.generation_job",
  "status": "pending",
  "model": "string",
  "created": 0,
  "params": {
    "durationSeconds": 0,
    "resolution": "string",
    "aspectRatio": "string",
    "n": 0
  },
  "estimated_cost_in_euro": 0
}

{
  "id": "00000000-0000-0000-0000-000000000000",
  "object": "video.generation_job",
  "status": "pending",
  "model": "string",
  "created": 0,
  "params": {
    "durationSeconds": 0,
    "resolution": "string",
    "aspectRatio": "string",
    "n": 0
  },
  "estimated_cost_in_euro": 0
}

Job angenommen; fragen Sie den GET-Endpunkt mit der zurückgegebenen id ab.

idstring<uuid>

objectstring

statusstring

modelstring

createdinteger

Unix-Zeitstempel

paramsobject

durationSecondsinteger

resolutionstring

aspectRatiostring

ninteger

estimated_cost_in_euronumber

Obere Kostengrenze, die bei der Job-Erstellung belastet wird. Wird bei Abschluss auf die tatsächlichen Kosten erstattet.

Statuscodes

200

Job angenommen; fragen Sie den GET-Endpunkt mit der zurückgegebenen id ab.

object

400

Ungültige Dauer, Auflösung oder Seitenverhältnis für dieses Modell

401

Nicht autorisiert

402

Nicht genügend Guthaben

403

API-Key besitzt keine Berechtigung für dieses Modell

404

Modell nicht gefunden