Avatar erstellen (aus Foto)

Erstellt einen benutzerdefinierten HeyGen-Avatar aus einem hochgeladenen Bild (Talking Photo). Die zurückgegebene avatar_id ist auf Ihren Workspace beschränkt — nur Ihr Workspace darf sie in /v2/videos/avatar-generations verwenden. Als multipart/form-data einreichen.

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

Beispielaufruf

curl https://api.deutschlandgpt.de/v2/videos/avatars \
  -X POST \
  -H "Authorization: Bearer $DGPT_API_KEY"

curl https://api.deutschlandgpt.de/v2/videos/avatars \
  -X POST \
  -H "Authorization: Bearer $DGPT_API_KEY"

import os, requests

response = requests.post(
    "https://api.deutschlandgpt.de/v2/videos/avatars",
    headers={"Authorization": f"Bearer {os.environ['DGPT_API_KEY']}"},
)

print(response.json())

import os, requests

response = requests.post(
    "https://api.deutschlandgpt.de/v2/videos/avatars",
    headers={"Authorization": f"Bearer {os.environ['DGPT_API_KEY']}"},
)

print(response.json())

const response = await fetch('https://api.deutschlandgpt.de/v2/videos/avatars', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DGPT_API_KEY}`,
  },
});

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

const response = await fetch('https://api.deutschlandgpt.de/v2/videos/avatars', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DGPT_API_KEY}`,
  },
});

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

Antwort

200application/json

{
  "id": "00000000-0000-0000-0000-000000000000",
  "object": "avatar",
  "avatar_id": "string",
  "name": "string",
  "preview_url": "string",
  "created": 0
}

{
  "id": "00000000-0000-0000-0000-000000000000",
  "object": "avatar",
  "avatar_id": "string",
  "name": "string",
  "preview_url": "string",
  "created": 0
}

Der erstellte Avatar.

idstring<uuid>

Registry-ID (an DELETE /v2/videos/avatars/{id} übergeben).

objectstring

avatar_idstring

HeyGen-Avatar-ID — als avatar_id an /v2/videos/avatar-generations übergeben.

namestring

preview_urlstring | null

createdinteger

Statuscodes

200

Der erstellte Avatar.

object

400

Fehlender Name/Datei oder Provider-Fehler.

401

Nicht autorisiert

503

HeyGen ist nicht konfiguriert.