> ## Documentation Index
> Fetch the complete documentation index at: https://evolink.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# HappyHorse 1.0 Reference-to-Video

> - HappyHorse 1.0 Reference-to-Video, unterstützt 1–9 Referenzbilder plus einen Textprompt
- **Konvention für Charakterreferenzen**: Verwenden Sie im `prompt` die Schlüsselwörter `character1`, `character2`, `character3` ... in Reihenfolge, um auf die Bilder im `image_urls`-Array zu verweisen
- Asynchroner Verarbeitungsmodus, verwenden Sie die zurückgegebene Aufgaben-ID [zur Statusabfrage](/de/api-manual/task-management/get-task-detail)
- Generierte Video-Links sind 24 Stunden gültig, bitte rechtzeitig speichern



## OpenAPI

````yaml de/api-manual/video-series/happyhorse1.0/happyhorse-1.0-reference-to-video.json POST /v1/videos/generations
openapi: 3.1.0
info:
  title: HappyHorse 1.0 Reference-to-Video API
  description: >-
    HappyHorse 1.0 Reference-to-Video-API, generiert Videos aus 1–9
    Referenzbildern und einem Textprompt
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api.evolink.ai
    description: Produktionsumgebung
security:
  - bearerAuth: []
tags:
  - name: Videogenerierung
    description: API-Schnittstellen für KI-Videogenerierung
paths:
  /v1/videos/generations:
    post:
      tags:
        - Videogenerierung
      summary: HappyHorse 1.0 Reference-to-Video
      description: >-
        - HappyHorse 1.0 Reference-to-Video, unterstützt 1–9 Referenzbilder plus
        einen Textprompt

        - **Konvention für Charakterreferenzen**: Verwenden Sie im `prompt` die
        Schlüsselwörter `character1`, `character2`, `character3` ... in
        Reihenfolge, um auf die Bilder im `image_urls`-Array zu verweisen

        - Asynchroner Verarbeitungsmodus, verwenden Sie die zurückgegebene
        Aufgaben-ID [zur
        Statusabfrage](/de/api-manual/task-management/get-task-detail)

        - Generierte Video-Links sind 24 Stunden gültig, bitte rechtzeitig
        speichern
      operationId: createHappyHorse10ReferenceToVideo
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/VideoGenerationRequest'
            examples:
              multi_character:
                summary: Multi-Charakter Reference-to-Video
                value:
                  model: happyhorse-1.0-reference-to-video
                  prompt: >-
                    A woman in a red qipao character1, the camera first frames
                    the slim cut of the qipao from a side medium shot, then
                    switches to a low-angle upward shot capturing details as she
                    gracefully lifts her hand to open a folding fan character2,
                    with tasseled earrings character3 swaying lightly as she
                    turns her head.
                  image_urls:
                    - https://cdn.example.com/girl.jpg
                    - https://cdn.example.com/folding-fan.jpg
                    - https://cdn.example.com/earrings.jpg
                  quality: 720p
                  aspect_ratio: '16:9'
                  duration: 5
              single_reference:
                summary: Einzelbild Reference-to-Video
                value:
                  model: happyhorse-1.0-reference-to-video
                  prompt: >-
                    character1 runs through a forest, with sunlight filtering
                    through the leaves
                  image_urls:
                    - https://cdn.example.com/character.jpg
                  quality: 1080p
                  aspect_ratio: '9:16'
                  duration: 6
      responses:
        '200':
          description: Videogenerierungsaufgabe erfolgreich erstellt
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VideoGenerationResponse'
        '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 authentifiziert, Token ungültig oder abgelaufen
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: unauthorized
                  message: Invalid or expired token
                  type: authentication_error
        '402':
          description: Unzureichendes Guthaben, 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:
                    happyhorse-1.0-reference-to-video
                  type: invalid_request_error
        '429':
          description: Anfragelimit ü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:
    VideoGenerationRequest:
      type: object
      required:
        - model
        - prompt
        - image_urls
      properties:
        model:
          type: string
          description: Name des Videogenerierungsmodells
          enum:
            - happyhorse-1.0-reference-to-video
          default: happyhorse-1.0-reference-to-video
          example: happyhorse-1.0-reference-to-video
        prompt:
          type: string
          description: >-
            Textprompt, **erforderlich**


            **Längengrenzen:**

            - Chinesisch: bis zu `2500` Zeichen

            - Nicht-Chinesisch: bis zu `5000` Zeichen

            - Überschüssiger Inhalt wird automatisch abgeschnitten


            **Konvention für Charakterreferenzen (wichtig):**

            - Der Prompt muss explizit `character1`, `character2`, `character3`
            ... Schlüsselwörter verwenden, um in Reihenfolge auf Bilder in
            `image_urls` zu verweisen

            - Das 1. Bild entspricht `character1`, das 2. `character2`, usw.

            - Fehlende explizite Verweise können zu Charakterverwechslungen
            führen
          example: >-
            A woman in a red qipao character1, the camera first frames the slim
            cut of the qipao from a side medium shot, then switches to a
            low-angle upward shot capturing details as she gracefully lifts her
            hand to open a folding fan character2, with tasseled earrings
            character3 swaying lightly as she turns her head.
        image_urls:
          type: array
          description: >-
            Referenzbild-URL-Array, **erforderlich**, **1 ~ 9 Bilder**


            **Bildanforderungen:**

            - Unterstützte Formate: JPEG, JPG, PNG, WEBP

            - Auflösung: kurze Kante ≥ `400` px; 720P oder höhere
            Qualitätsbilder werden empfohlen (vermeiden Sie extrem kleine,
            unscharfe oder stark komprimierte Bilder)

            - Empfohlenes Seitenverhältnis: kurze Kante / lange Kante ≥ `0.4`,
            mit konsistenten Proportionen über alle Bilder (nahe am
            Ziel-Videoverhältnis)

            - Dateigröße: ≤ `10MB` pro Bild

            - Bild-URLs müssen **öffentlich zugänglich (HTTP oder HTTPS)** sein;
            private OSS-, Intranet- oder authentifizierte Links werden nicht
            unterstützt


            **Reihenfolge:** Die Array-Reihenfolge entspricht den `character1`,
            `character2` ... Verweisen im Prompt
          items:
            type: string
            format: uri
          minItems: 1
          maxItems: 9
          example:
            - https://cdn.example.com/girl.jpg
            - https://cdn.example.com/folding-fan.jpg
            - https://cdn.example.com/earrings.jpg
        quality:
          type: string
          description: >-
            Videoauflösungsstufe, Standard ist `720p`


            **Optionen:**

            - `720p`: Standardauflösung, dies ist der Standardwert

            - `1080p`: HD-Auflösung


            **Abrechnungshinweis:** Die Auflösungsstufe wirkt sich direkt auf
            die Abrechnung aus
          enum:
            - 720p
            - 1080p
          default: 720p
          example: 720p
        aspect_ratio:
          type: string
          description: |-
            Video-Seitenverhältnis, Standard ist `16:9`

            **Optionen:**
            - `16:9` (Querformat)
            - `9:16` (Hochformat)
            - `1:1` (Quadrat)
            - `4:3`
            - `3:4`
            - `4:5`
            - `5:4`
            - `9:21`
            - `21:9`
          enum:
            - '16:9'
            - '9:16'
            - '1:1'
            - '4:3'
            - '3:4'
            - '4:5'
            - '5:4'
            - '9:21'
            - '21:9'
          default: '16:9'
          example: '16:9'
        duration:
          type: integer
          description: |-
            Videodauer (Sekunden), Standard ist `5` Sekunden

            **Bereich:**
            - Ganzzahl `3` ~ `15`
            - Die Dauer wirkt sich direkt auf die Abrechnung aus
          default: 5
          minimum: 3
          maximum: 15
          example: 5
        seed:
          type: integer
          description: >-
            Zufalls-Seed, Standard ist zufällig


            **Details:**

            - Bereich: `1` ~ `2147483647`

            - Ein fester Seed reduziert parameterbedingte Variationen beim
            Iterieren über Prompts und verbessert die Reproduzierbarkeit
          minimum: 1
          maximum: 2147483647
          example: 42
        callback_url:
          type: string
          description: >-
            HTTPS-Callback-URL nach Aufgabenabschluss


            **Callback-Zeitpunkt:**

            - Wird ausgelöst, wenn die Aufgabe abgeschlossen, fehlgeschlagen
            oder abgebrochen ist

            - Wird nach Abschluss der Abrechnungsbestätigung gesendet


            **Sicherheitseinschränkungen:**

            - Nur HTTPS-Protokoll wird unterstützt

            - Callbacks an private IP-Adressen sind 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

            - Bis zu `3` Wiederholungsversuche nach Fehler (jeweils nach
            `1`/`2`/`4` Sekunden)

            - Format des Callback-Antwort-Bodys entspricht dem Antwortformat der
            Task-Query-API

            - Ein 2xx-Statuscode gilt als Erfolg; andere Statuscodes lösen
            Wiederholungsversuche aus
          format: uri
          example: https://your-domain.com/webhooks/video-task-completed
    VideoGenerationResponse:
      type: object
      properties:
        created:
          type: integer
          description: Zeitstempel der Aufgabenerstellung
          example: 1761313744
        id:
          type: string
          description: Aufgaben-ID
          example: task-unified-1761313744-h1r2vef0
        model:
          type: string
          description: Tatsächlich verwendeter Modellname
          example: happyhorse-1.0-reference-to-video
        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
            - cancelled
          example: pending
        task_info:
          $ref: '#/components/schemas/VideoTaskInfo'
          description: Detaillierte Informationen zur Videoaufgabe
        type:
          type: string
          enum:
            - text
            - image
            - audio
            - video
          description: Ausgabetyp der Aufgabe
          example: video
        usage:
          $ref: '#/components/schemas/VideoUsage'
          description: Nutzungs- und Abrechnungsinformationen
    ErrorResponse:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              description: Fehlercode-Kennung
            message:
              type: string
              description: Fehlerbeschreibungsnachricht
            type:
              type: string
              description: Fehlertyp
    VideoTaskInfo:
      type: object
      properties:
        can_cancel:
          type: boolean
          description: Ob die Aufgabe abgebrochen werden kann
          example: true
        estimated_time:
          type: integer
          description: Geschätzte Fertigstellungszeit (Sekunden)
          minimum: 0
          example: 2400
        video_duration:
          type: integer
          description: Videodauer (Sekunden)
          example: 5
    VideoUsage:
      type: object
      description: Nutzungs- und Abrechnungsinformationen
      properties:
        billing_rule:
          type: string
          description: Abrechnungsregel
          enum:
            - per_call
            - per_token
            - per_second
          example: per_second
        credits_reserved:
          type: number
          description: Geschätzter Credit-Verbrauch
          minimum: 0
          example: 607500
        user_group:
          type: string
          description: Benutzergruppenkategorie
          example: default
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        ##Alle Schnittstellen erfordern eine Authentifizierung mit Bearer
        Token##


        **API Key erhalten:**


        Besuchen Sie die
        [API-Key-Verwaltungsseite](https://evolink.ai/dashboard/keys), um Ihren
        API Key zu erhalten


        **Im Anfrage-Header hinzufügen:**

        ```

        Authorization: Bearer YOUR_API_KEY

        ```

````