> ## 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 Video-Edit

> - HappyHorse 1.0 edicion de video, toma 1 video de origen mas instrucciones de texto para realizar transferencia de estilo, reemplazo local, etc.
- Acepta opcionalmente de 0 a 5 imagenes de referencia para guia de estilo / sujeto
- **No admite `duration`**: duracion del video de salida = `min(duracion del video de entrada, 15)`, determinada por el modelo
- **No admite `aspect_ratio`**: la relacion de aspecto de salida coincide con la del video de origen
- **Regla de facturacion especial**: `(duracion del video de entrada + duracion del video de salida) × precio unitario de la resolucion`; el modelo trunca las entradas superiores a 15 segundos a 15 segundos
- Modo de procesamiento asincrono, utilice el ID de tarea devuelto para [consultar el estado](/es/api-manual/task-management/get-task-detail)
- Los enlaces de video generados son validos durante 24 horas, guardelos lo antes posible



## OpenAPI

````yaml es/api-manual/video-series/happyhorse1.0/happyhorse-1.0-video-edit.json POST /v1/videos/generations
openapi: 3.1.0
info:
  title: API de HappyHorse 1.0 Video-Edit
  description: >-
    API de edicion de video HappyHorse 1.0, realiza transferencia de estilo,
    reemplazo local, etc., a partir de un video de origen e instrucciones de
    texto
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api.evolink.ai
    description: Produccion
security:
  - bearerAuth: []
tags:
  - name: Generacion de video
    description: APIs relacionadas con la generacion de video con IA
paths:
  /v1/videos/generations:
    post:
      tags:
        - Generacion de video
      summary: HappyHorse 1.0 Video-Edit
      description: >-
        - HappyHorse 1.0 edicion de video, toma 1 video de origen mas
        instrucciones de texto para realizar transferencia de estilo, reemplazo
        local, etc.

        - Acepta opcionalmente de 0 a 5 imagenes de referencia para guia de
        estilo / sujeto

        - **No admite `duration`**: duracion del video de salida = `min(duracion
        del video de entrada, 15)`, determinada por el modelo

        - **No admite `aspect_ratio`**: la relacion de aspecto de salida
        coincide con la del video de origen

        - **Regla de facturacion especial**: `(duracion del video de entrada +
        duracion del video de salida) × precio unitario de la resolucion`; el
        modelo trunca las entradas superiores a 15 segundos a 15 segundos

        - Modo de procesamiento asincrono, utilice el ID de tarea devuelto para
        [consultar el estado](/es/api-manual/task-management/get-task-detail)

        - Los enlaces de video generados son validos durante 24 horas, guardelos
        lo antes posible
      operationId: createHappyHorse10VideoEdit
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/VideoGenerationRequest'
            examples:
              with_reference:
                summary: Edicion de video con imagen de referencia
                value:
                  model: happyhorse-1.0-video-edit
                  prompt: >-
                    Have the character in the video wear the striped sweater
                    from the image
                  video_urls:
                    - https://cdn.example.com/source.mp4
                  image_urls:
                    - https://cdn.example.com/sweater.jpg
                  quality: 720p
                  keep_original_sound: true
              style_transfer:
                summary: Transferencia de estilo (sin imagen de referencia)
                value:
                  model: happyhorse-1.0-video-edit
                  prompt: Replace the video background with snowy mountains
                  video_urls:
                    - https://cdn.example.com/source.mp4
                  quality: 1080p
                  keep_original_sound: false
      responses:
        '200':
          description: Tarea de generacion de video creada exitosamente
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VideoGenerationResponse'
        '400':
          description: Error en los parametros de la solicitud
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: missing_video_urls
                  message: happyhorse-1.0-video-edit requires video_urls or video_url
                  type: invalid_request_error
        '401':
          description: No autenticado, Token invalido o expirado
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: unauthorized
                  message: Invalid or expired token
                  type: authentication_error
        '402':
          description: Cuota insuficiente, se requiere recarga
          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: Acceso no autorizado
          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-video-edit
                  type: invalid_request_error
        '429':
          description: Limite de frecuencia de solicitudes excedido
          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: Error interno del servidor
          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
        - video_urls
      properties:
        model:
          type: string
          description: Nombre del modelo de generacion de video
          enum:
            - happyhorse-1.0-video-edit
          default: happyhorse-1.0-video-edit
          example: happyhorse-1.0-video-edit
        prompt:
          type: string
          description: >-
            Texto de instruccion de edicion, **obligatorio**


            **Limites de longitud:**

            - Chino: hasta `2500` caracteres

            - No chino: hasta `5000` caracteres

            - El contenido excedente se trunca automaticamente


            **Consejos de prompt:**

            - Use instrucciones de edicion en lugar de descripciones creativas

            - Ejemplos: `Reemplaza la ropa del protagonista por el sueter a
            rayas de la imagen`, `Reemplaza el fondo del video por montañas
            nevadas`
          example: >-
            Have the character in the video wear the striped sweater from the
            image
        video_urls:
          type: array
          description: >-
            URL del video de origen a editar, **obligatorio**, **solo 1** (se
            toma el primer elemento del array)


            **Requisitos del video:**

            - Formatos admitidos: MP4, MOV (se recomienda codificacion H.264)

            - Duracion: `3` ~ `60` segundos

            - El modelo trunca automaticamente las entradas superiores a `15`
            segundos a los primeros `15` segundos

            - Resolucion: lado largo ≤ `2160` px, lado corto ≥ `320` px

            - Relacion de aspecto: `1:2.5` ~ `2.5:1`

            - Tamaño del archivo: ≤ `100MB`

            - Tasa de frames: > `8` fps

            - La URL del video debe ser **accesible publicamente (HTTP o
            HTTPS)**; no se admiten enlaces OSS privados, de intranet o
            autenticados


            **Campos compatibles:** tambien se aceptan `video_url` / `video`
            (con prioridad inferior a `video_urls`)
          items:
            type: string
            format: uri
          minItems: 1
          maxItems: 1
          example:
            - https://cdn.example.com/source.mp4
        image_urls:
          type: array
          description: >-
            Array de URLs de imagenes de referencia, **opcional**, **0 ~ 5
            imagenes**


            Usado para guia de estilo / sujeto.


            **Requisitos de imagen:**

            - Formatos admitidos: JPEG, JPG, PNG, WEBP

            - Resolucion: ancho y alto ≥ `300` px

            - Relacion de aspecto: `1:2.5` ~ `2.5:1`

            - Tamaño del archivo: ≤ `10MB`

            - Las URLs de imagen deben ser **accesibles publicamente (HTTP o
            HTTPS)**
          items:
            type: string
            format: uri
          maxItems: 5
          example:
            - https://cdn.example.com/sweater.jpg
        keep_original_sound:
          type: boolean
          description: >-
            Si se mantiene el audio original del video de entrada, valor
            predeterminado `false`


            **Opciones:**

            - `true`: mantener el audio original del video de entrada

            - `false`: descartar el audio original; el modelo genera nuevo audio
          default: false
          example: false
        quality:
          type: string
          description: >-
            Nivel de resolucion del video, valor predeterminado `720p`


            **Opciones:**

            - `720p`: claridad estandar, este es el valor predeterminado

            - `1080p`: claridad HD


            **Nota de facturacion:** El nivel de resolucion afecta directamente
            la facturacion
          enum:
            - 720p
            - 1080p
          default: 720p
          example: 720p
        seed:
          type: integer
          description: >-
            Semilla aleatoria, valor predeterminado aleatorio


            **Detalles:**

            - Rango: `1` ~ `2147483647`

            - Una semilla fija reduce las variaciones inducidas por parametros
            al iterar sobre prompts y mejora la reproducibilidad
          minimum: 1
          maximum: 2147483647
          example: 42
        callback_url:
          type: string
          description: >-
            Direccion de callback HTTPS despues de completar la tarea


            **Momento del callback:**

            - Se activa cuando la tarea se completa, falla o se cancela

            - Se envia despues de confirmar la facturacion


            **Restricciones de seguridad:**

            - Solo admite protocolo HTTPS

            - Prohibido el callback a direcciones IP privadas (127.0.0.1,
            10.x.x.x, 172.16-31.x.x, 192.168.x.x, etc.)

            - La longitud de la URL no debe exceder `2048` caracteres


            **Mecanismo de callback:**

            - Tiempo de espera: `10` segundos

            - Maximo `3` reintentos despues del fallo (respectivamente
            `1`/`2`/`4` segundos despues del fallo)

            - El formato del cuerpo de la respuesta de callback coincide con el
            formato de respuesta de la API de consulta de tarea

            - Un codigo de estado 2xx se considera exitoso; otros codigos
            activan reintentos
          format: uri
          example: https://your-domain.com/webhooks/video-task-completed
    VideoGenerationResponse:
      type: object
      properties:
        created:
          type: integer
          description: Marca de tiempo de creacion de la tarea
          example: 1761313744
        id:
          type: string
          description: ID de la tarea
          example: task-unified-1761313744-h1edgh12
        model:
          type: string
          description: Nombre del modelo realmente utilizado
          example: happyhorse-1.0-video-edit
        object:
          type: string
          enum:
            - video.generation.task
          description: Tipo especifico de la tarea
        progress:
          type: integer
          description: Porcentaje de progreso de la tarea (0-100)
          minimum: 0
          maximum: 100
          example: 0
        status:
          type: string
          description: Estado de la tarea
          enum:
            - pending
            - processing
            - completed
            - failed
            - cancelled
          example: pending
        task_info:
          $ref: '#/components/schemas/VideoTaskInfo'
          description: Informacion detallada de la tarea de video
        type:
          type: string
          enum:
            - text
            - image
            - audio
            - video
          description: Tipo de salida de la tarea
          example: video
        usage:
          $ref: '#/components/schemas/VideoUsage'
          description: Informacion de uso y facturacion
    ErrorResponse:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              description: Identificador de codigo de error
            message:
              type: string
              description: Mensaje de descripcion del error
            type:
              type: string
              description: Tipo de error
    VideoTaskInfo:
      type: object
      properties:
        can_cancel:
          type: boolean
          description: Si la tarea se puede cancelar
          example: true
        estimated_time:
          type: integer
          description: Tiempo estimado de finalizacion (segundos)
          minimum: 0
          example: 2400
        video_duration:
          type: integer
          description: >-
            Duracion del video de salida (segundos), igual a min(duracion del
            video de entrada, 15)
          example: 6
    VideoUsage:
      type: object
      description: >-
        Informacion de uso y facturacion. Facturacion EDIT = (duracion del video
        de entrada + duracion del video de salida) × precio unitario de la
        resolucion; el predescuento se estima como duracion de entrada detectada
        localmente × 2, y el descuento real se reconcilia segun el campo usage
        devuelto por el modelo
      properties:
        billing_rule:
          type: string
          description: Regla de facturacion
          enum:
            - per_call
            - per_token
            - per_second
          example: per_second
        credits_reserved:
          type: number
          description: >-
            Creditos estimados a consumir (predescontados como duracion de
            entrada × 2)
          minimum: 0
          example: 1608660
        user_group:
          type: string
          description: Categoria del grupo de usuarios
          example: default
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        ##Todas las interfaces requieren autenticacion mediante Bearer Token##


        **Obtener API Key:**


        Visite la [Pagina de gestion de API
        Key](https://evolink.ai/dashboard/keys) para obtener su API Key


        **Agregar en el encabezado de la solicitud:**

        ```

        Authorization: Bearer YOUR_API_KEY

        ```

````