> ## Documentation Index > Fetch the complete documentation index at: https://docs.evolink.ai/llms.txt > Use this file to discover all available pages before exploring further. # OmniHuman-1.5 Digitale Menschliche Videogenerierung > - OmniHuman-1.5 (omnihuman-1.5) Modell generiert digitale menschliche Videos, gesteuert durch Audio - Asynchroner Verarbeitungsmodus, verwenden Sie die zurückgegebene Aufgaben-ID zum [Abfragen](/de/api-manual/task-management/get-task-detail) - Generierte Videolinks sind 24 Stunden gültig, bitte speichern Sie diese umgehend **Hinweis:** - Audiodauer-Limit: maximal 35 Sekunden - Unterstützte Audioformate: MP3, WAV - Die Abrechnung basiert auf der Audiodauer (aufgerundet auf die nächste Sekunde) ## OpenAPI ````yaml de/api-manual/video-series/omnihuman/omnihuman-1.5-video-generate.json POST /v1/videos/generations openapi: 3.1.0 info: title: OmniHuman-1.5 Digitaler Mensch Videogenerierungs-API description: >- Audiogesteuerte Aufgaben zur Generierung digitaler menschlicher Videos mit dem OmniHuman-1.5 Modell erstellen license: name: MIT version: 1.0.0 servers: - url: https://api.evolink.ai description: Produktionsumgebung security: - bearerAuth: [] tags: - name: Digitale Mensch-Videogenerierung description: OmniHuman-1.5 APIs zur Generierung digitaler menschlicher Videos paths: /v1/videos/generations: post: tags: - Digitale Mensch-Videogenerierung summary: OmniHuman-1.5 Digitale Menschliche Videogenerierung description: >- - OmniHuman-1.5 (omnihuman-1.5) Modell generiert digitale menschliche Videos, gesteuert durch Audio - Asynchroner Verarbeitungsmodus, verwenden Sie die zurückgegebene Aufgaben-ID zum [Abfragen](/de/api-manual/task-management/get-task-detail) - Generierte Videolinks sind 24 Stunden gültig, bitte speichern Sie diese umgehend **Hinweis:** - Audiodauer-Limit: maximal 35 Sekunden - Unterstützte Audioformate: MP3, WAV - Die Abrechnung basiert auf der Audiodauer (aufgerundet auf die nächste Sekunde) operationId: createOmniHumanVideoGeneration requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/OmniHumanVideoGenerationRequest' examples: basic_generation: summary: Einfache digitale menschliche Generierung value: model: omnihuman-1.5 audio_url: https://example.com/audio.mp3 image_urls: - https://example.com/person.jpg responses: '200': description: >- Aufgabe zur Generierung digitaler menschlicher Videos erfolgreich erstellt content: application/json: schema: $ref: '#/components/schemas/OmniHumanVideoGenerationResponse' '400': description: Ungültige Anfrageparameter content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: invalid_request message: Invalid request parameters type: invalid_request_error '401': description: Nicht autorisiert, ungültiges oder abgelaufenes Token content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: unauthorized message: Invalid or expired token type: authentication_error '402': description: Unzureichendes Kontingent, Aufladung erforderlich content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: insufficient_quota message: Insufficient quota. Please top up your account. type: insufficient_quota '403': description: Zugriff verweigert content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: model_access_denied message: 'Token does not have access to model: omnihuman-1.5' type: invalid_request_error '429': description: Ratenlimit überschritten content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: rate_limit_exceeded message: Too many requests, please try again later type: rate_limit_error '500': description: Interner Serverfehler content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: internal_error message: Internal server error type: api_error components: schemas: OmniHumanVideoGenerationRequest: type: object required: - model - audio_url - image_urls properties: model: type: string description: Modellname für die Generierung digitaler menschlicher Videos enum: - omnihuman-1.5 default: omnihuman-1.5 example: omnihuman-1.5 audio_url: type: string format: uri description: >- 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) example: https://example.com/audio.mp3 image_urls: type: array description: |- 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 items: type: string format: uri maxItems: 1 example: - https://example.com/person.jpg prompt: type: string description: >- Optionaler Text-Prompt zur Steuerung des Generierungsstils, unterstützt nur Chinesisch, Englisch, Japanisch, Koreanisch, Mexikanisches Spanisch und Indonesisch example: A person speaking naturally with subtle expressions pe_fast_mode: type: boolean description: >- Schnellverarbeitungsmodus aktivieren **Hinweis:** - `true`: Schnellere Generierung mit möglicherweise geringerer Qualität - `false`: Standardqualitätsverarbeitung (Standard) default: false example: false mask_url: type: array description: >- Masken-URL-Array zur Angabe von Animationsbereichen **Hinweis:** - Optionaler Parameter für erweiterte Steuerung - Maskenbilder sollten den Abmessungen des Referenzbildes entsprechen items: type: string format: uri example: - https://example.com/mask.png seed: type: integer description: >- 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: type: boolean description: >- 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) default: false example: false auto_mask: type: boolean description: >- 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) default: false example: false callback_url: type: string description: >- 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 format: uri example: https://your-domain.com/webhooks/video-task-completed OmniHumanVideoGenerationResponse: type: object properties: created: type: integer description: Zeitstempel der Aufgabenerstellung example: 1757169743 id: type: string description: Aufgaben-ID example: task-unified-1757169743-7cvnl5zw model: type: string description: Tatsächlich verwendeter Modellname example: omnihuman-1.5 object: type: string enum: - video.generation.task description: Spezifischer Aufgabentyp progress: type: integer description: Aufgabenfortschritt in Prozent (0-100) minimum: 0 maximum: 100 example: 0 status: type: string description: Aufgabenstatus enum: - pending - processing - completed - failed example: pending task_info: $ref: '#/components/schemas/VideoTaskInfo' description: Detaillierte Informationen zur Videoaufgabe type: type: string enum: - text - image - audio - video description: Aufgaben-Ausgabetyp example: video usage: $ref: '#/components/schemas/VideoUsage' description: Nutzungs- und Abrechnungsinformationen ErrorResponse: type: object properties: error: type: object properties: code: type: string description: Fehlercode-Bezeichner message: type: string description: Fehlerbeschreibung type: type: string description: Fehlertyp VideoTaskInfo: type: object properties: can_cancel: type: boolean description: Ob die Aufgabe abgebrochen werden kann (immer false für OmniHuman) example: false estimated_time: type: integer description: Geschätzte Abschlusszeit (Sekunden) minimum: 0 example: 120 video_duration: type: integer description: Videodauer (Sekunden), basierend auf der Audiodauer example: 10 VideoUsage: type: object description: Nutzungs- und Abrechnungsinformationen properties: billing_rule: type: string description: Abrechnungsregel (per_second für OmniHuman) enum: - per_call - per_token - per_second example: per_second credits_reserved: type: number description: Geschätzte verbrauchte Credits (basierend auf der Audiodauer) minimum: 0 example: 10 user_group: type: string description: Benutzergruppenkategorie example: default securitySchemes: bearerAuth: type: http scheme: bearer description: >- ##Alle APIs erfordern Bearer-Token-Authentifizierung## **API-Schlüssel erhalten:** Besuchen Sie die [API-Schlüsselverwaltungsseite](https://evolink.ai/dashboard/keys), um Ihren API-Schlüssel zu erhalten **Zum Anfrage-Header hinzufügen:** ``` Authorization: Bearer YOUR_API_KEY ``` ````