Zum Hauptinhalt springen
POST
/
v1
/
videos
/
generations
OmniHuman-1.5 Digitale Menschliche Videogenerierung
curl --request POST \
  --url https://api.evolink.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "omnihuman-1.5",
  "audio_url": "https://example.com/audio.mp3",
  "image_urls": [
    "https://example.com/person.jpg"
  ]
}
'
{
  "created": 1757169743,
  "id": "task-unified-1757169743-7cvnl5zw",
  "model": "omnihuman-1.5",
  "object": "video.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": false,
    "estimated_time": 120,
    "video_duration": 10
  },
  "type": "video",
  "usage": {
    "billing_rule": "per_second",
    "credits_reserved": 10,
    "user_group": "default"
  }
}

Autorisierungen

​
Authorization
string
header
erforderlich

##Alle APIs erfordern Bearer-Token-Authentifizierung##

API-Schlüssel erhalten:

Besuchen Sie die API-Schlüsselverwaltungsseite, um Ihren API-Schlüssel zu erhalten

Zum Anfrage-Header hinzufügen:

Authorization: Bearer YOUR_API_KEY

Body

application/json
​
model
enum<string>
Standard:omnihuman-1.5
erforderlich

Modellname für die Generierung digitaler menschlicher Videos

Verfügbare Optionen:
omnihuman-1.5
Beispiel:

"omnihuman-1.5"

​
audio_url
string<uri>
erforderlich

Audio-URL zur Steuerung von Lippensynchronisation und Körperbewegungen

Hinweis:

  • Maximale Audiodauer: 35 Sekunden
  • Unterstützte Formate: .mp3, .wav
  • Audio-URLs müssen direkt vom Server zugänglich sein
  • Die Abrechnung basiert auf der Audiodauer (aufgerundet auf die nächste Sekunde)
Beispiel:

"https://example.com/audio.mp3"

​
image_urls
string<uri>[]
erforderlich

Referenzbild-URL-Liste mit der zu animierenden Person

Hinweis:

  • Anzahl der Bilder pro Anfrage: 1
  • Das Bild sollte eine deutliche menschliche Figur enthalten
  • Bildgröße: nicht mehr als 10MB
  • Unterstützte Dateiformate: .jpg, .jpeg, .png, .webp
  • Bild-URLs müssen direkt vom Server einsehbar sein
Maximum array length: 1
Beispiel:
["https://example.com/person.jpg"]
​
prompt
string

Optionaler Text-Prompt zur Steuerung des Generierungsstils, unterstützt nur Chinesisch, Englisch, Japanisch, Koreanisch, Mexikanisches Spanisch und Indonesisch

Beispiel:

"A person speaking naturally with subtle expressions"

​
pe_fast_mode
boolean
Standard:false

Schnellverarbeitungsmodus aktivieren

Hinweis:

  • true: Schnellere Generierung mit möglicherweise geringerer Qualität
  • false: Standardqualitätsverarbeitung (Standard)
Beispiel:

false

​
mask_url
string<uri>[]

Masken-URL-Array zur Angabe von Animationsbereichen

Hinweis:

  • Optionaler Parameter für erweiterte Steuerung
  • Maskenbilder sollten den Abmessungen des Referenzbildes entsprechen
Beispiel:
["https://example.com/mask.png"]
​
seed
integer

Zufälliger Seed als Grundlage zur Bestimmung des anfänglichen Diffusionszustands, Standard ist zufällig. Wenn der Seed die gleiche positive Ganzzahl ist und alle anderen Parameter konsistent sind, kann der generierte Inhalt konsistente Ergebnisse aufweisen

​
subject_check
boolean
Standard:false

Subjekterkennung aktivieren, um die menschliche Präsenz im Bild zu überprüfen

Hinweis:

  • true: Subjekterkennung aktivieren, die Anfragestartzeit wird sich erhöhen
  • false: Subjekterkennung überspringen (Standard)
Beispiel:

false

​
auto_mask
boolean
Standard:false

Automatische Maskengenerierung aktivieren

Hinweis:

  • true: Menschliche Figur automatisch erkennen und maskieren, die Anfragestartzeit wird sich erhöhen. Dieser Parameter wird ignoriert, wenn mask_url einen Wert hat
  • false: Bereitgestellte mask_url verwenden oder keine Maske (Standard)
Beispiel:

false

​
callback_url
string<uri>

HTTPS-Callback-Adresse nach Aufgabenabschluss

Callback-Zeitpunkt:

  • Wird ausgelöst, wenn die Aufgabe abgeschlossen, fehlgeschlagen oder abgebrochen wurde
  • Wird nach Abschluss der Abrechnungsbestätigung gesendet

Sicherheitsbeschränkungen:

  • Nur HTTPS-Protokoll wird unterstützt
  • Callback an interne IP-Adressen ist verboten (127.0.0.1, 10.x.x.x, 172.16-31.x.x, 192.168.x.x, usw.)
  • URL-Länge darf 2048 Zeichen nicht überschreiten

Callback-Mechanismus:

  • Timeout: 10 Sekunden
  • Maximal 3 Wiederholungsversuche bei Fehler (Wiederholung nach 1 Sekunde/2 Sekunden/4 Sekunden)
  • Das Format des Callback-Antwortkörpers entspricht dem Antwortformat der Aufgabenabfrage-API
  • Ein 2xx-Statuscode der Callback-Adresse gilt als erfolgreich, andere Statuscodes lösen eine Wiederholung aus
Beispiel:

"https://your-domain.com/webhooks/video-task-completed"

Antwort

Aufgabe zur Generierung digitaler menschlicher Videos erfolgreich erstellt

​
created
integer

Zeitstempel der Aufgabenerstellung

Beispiel:

1757169743

​
id
string

Aufgaben-ID

Beispiel:

"task-unified-1757169743-7cvnl5zw"

​
model
string

Tatsächlich verwendeter Modellname

Beispiel:

"omnihuman-1.5"

​
object
enum<string>

Spezifischer Aufgabentyp

Verfügbare Optionen:
video.generation.task
​
progress
integer

Aufgabenfortschritt in Prozent (0-100)

Erforderlicher Bereich: 0 <= x <= 100
Beispiel:

0

​
status
enum<string>

Aufgabenstatus

Verfügbare Optionen:
pending,
processing,
completed,
failed
Beispiel:

"pending"

​
task_info
object

Detaillierte Informationen zur Videoaufgabe

​
type
enum<string>

Aufgaben-Ausgabetyp

Verfügbare Optionen:
text,
image,
audio,
video
Beispiel:

"video"

​
usage
object

Nutzungs- und Abrechnungsinformationen