Avatar-Video erstellen · DeutschlandGPT

Startet einen asynchronen Talking-Head-Avatar-Video-Job (HeyGen). Der Avatar liest das angegebene script in der gewählten Stimme vor.

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

Die gerenderte Dauer ist im Voraus unbekannt, daher wird Guthaben vorab auf Basis einer Schätzung der Skriptlänge belastet und bei Abschluss auf die tatsächliche Dauer abgerechnet (etwaige Differenzen werden erstattet).

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

Beispielaufruf

curl https://api.deutschlandgpt.de/v2/videos/avatar-generations \
  -X POST \
  -H "Authorization: Bearer $DGPT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "script": "Hi! Welcome to DeutschlandGPT — let me show you what our platform can do.",
  "model": "heygen-avatar-v2",
  "avatar_id": "Daisy-inskirt-20220818",
  "voice_id": "1bd001e7e50f421d891986aad5158bc8",
  "aspect_ratio": "16:9",
  "resolution": "720p",
  "speed": 0,
  "background_color": "#FFFFFF"
}'

curl https://api.deutschlandgpt.de/v2/videos/avatar-generations \
  -X POST \
  -H "Authorization: Bearer $DGPT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "script": "Hi! Welcome to DeutschlandGPT — let me show you what our platform can do.",
  "model": "heygen-avatar-v2",
  "avatar_id": "Daisy-inskirt-20220818",
  "voice_id": "1bd001e7e50f421d891986aad5158bc8",
  "aspect_ratio": "16:9",
  "resolution": "720p",
  "speed": 0,
  "background_color": "#FFFFFF"
}'

import os, requests

response = requests.post(
    "https://api.deutschlandgpt.de/v2/videos/avatar-generations",
    headers={"Authorization": f"Bearer {os.environ['DGPT_API_KEY']}"},
    json={
        "script": "Hi! Welcome to DeutschlandGPT — let me show you what our platform can do.",
        "model": "heygen-avatar-v2",
        "avatar_id": "Daisy-inskirt-20220818",
        "voice_id": "1bd001e7e50f421d891986aad5158bc8",
        "aspect_ratio": "16:9",
        "resolution": "720p",
        "speed": 0,
        "background_color": "#FFFFFF"
    },
)

print(response.json())

import os, requests

response = requests.post(
    "https://api.deutschlandgpt.de/v2/videos/avatar-generations",
    headers={"Authorization": f"Bearer {os.environ['DGPT_API_KEY']}"},
    json={
        "script": "Hi! Welcome to DeutschlandGPT — let me show you what our platform can do.",
        "model": "heygen-avatar-v2",
        "avatar_id": "Daisy-inskirt-20220818",
        "voice_id": "1bd001e7e50f421d891986aad5158bc8",
        "aspect_ratio": "16:9",
        "resolution": "720p",
        "speed": 0,
        "background_color": "#FFFFFF"
    },
)

print(response.json())

const response = await fetch('https://api.deutschlandgpt.de/v2/videos/avatar-generations', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DGPT_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "script": "Hi! Welcome to DeutschlandGPT — let me show you what our platform can do.",
    "model": "heygen-avatar-v2",
    "avatar_id": "Daisy-inskirt-20220818",
    "voice_id": "1bd001e7e50f421d891986aad5158bc8",
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "speed": 0,
    "background_color": "#FFFFFF"
  }),
});

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

const response = await fetch('https://api.deutschlandgpt.de/v2/videos/avatar-generations', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DGPT_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "script": "Hi! Welcome to DeutschlandGPT — let me show you what our platform can do.",
    "model": "heygen-avatar-v2",
    "avatar_id": "Daisy-inskirt-20220818",
    "voice_id": "1bd001e7e50f421d891986aad5158bc8",
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "speed": 0,
    "background_color": "#FFFFFF"
  }),
});

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

Anfrage-Body

scriptstringerforderlich

Der Text, den der Avatar sprechen wird. Modellabhängig begrenzt (HeyGen ~1500 Zeichen).

modelstringoptional

Avatar-Videomodell. Standard: heygen-avatar-v2.

avatar_idstringoptional

Zu verwendender Avatar. Standard ist der Standardavatar des Modells. Entdecken Sie Avatare über HeyGens GET /v2/avatars.

voice_idstringoptional

Zu verwendende Stimme. Standard ist die Standardstimme des Modells. Entdecken Sie Stimmen über HeyGens GET /v2/voices.

aspect_ratiostringoptional

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

resolutionstringoptional

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

speednumberoptional

Sprechgeschwindigkeitsmultiplikator, der an die Stimme übergeben wird.

background_colorstringoptional

Einfarbige Hintergrundfarbe als Hex-String.

Antwort

200application/json

{
  "id": "00000000-0000-0000-0000-000000000000",
  "object": "avatar_video.generation_job",
  "status": "pending",
  "model": "string",
  "created": 0,
  "params": {
    "avatarId": "string",
    "voiceId": "string",
    "resolution": "string",
    "aspectRatio": "string",
    "estimatedDurationSeconds": 0
  },
  "estimated_cost_in_euro": 0
}

{
  "id": "00000000-0000-0000-0000-000000000000",
  "object": "avatar_video.generation_job",
  "status": "pending",
  "model": "string",
  "created": 0,
  "params": {
    "avatarId": "string",
    "voiceId": "string",
    "resolution": "string",
    "aspectRatio": "string",
    "estimatedDurationSeconds": 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

avatarIdstring

voiceIdstring

resolutionstring

aspectRatiostring

estimatedDurationSecondsinteger

estimated_cost_in_euronumber

Obere Kostengrenze, die bei der Job-Erstellung belastet wird. Wird bei Abschluss auf die tatsächliche Dauer abgerechnet.

Statuscodes

200

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

object

400

Skript zu lang oder nicht unterstützte Auflösung/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