Happy Horse 1.0 API

Referencia completa de la API para los modelos de generación de video Happy Horse 1.0 de Alibaba.

Variantes de modelo

Esta API admite dos variantes de modelo:

Comparación rápida

Relaciones de aspecto compatibles para Texto a video

Happy Horse 1.0 Texto a video

Punto de conexión

POST /api/v1/video/task

Parámetros de solicitud

Obligatorio

Opcional

Solicitud de ejemplo

javascriptCopiar
const response = await fetch('https://api.flaq.ai/api/v1/video/task', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    model_name: 'happyhorse-1.0-text-to-video',
    prompt: 'A cat playing with a ball of yarn on a sunny windowsill',
    duration: 5,
    resolution: '1080p',
    aspect_ratio: '16:9',
    seed: 42,
  }),
});

const { data } = await response.json();
const taskId = data.task_id;

Happy Horse 1.0 Imagen a video

Parámetros de solicitud

Obligatorio

Opcional

Requisitos de la imagen de entrada

• Compatible formats: JPEG, JPG, PNG, BMP, WEBP
• Rango de relación de aspecto compatible: de 1:2.5 to 2.5:1
• Dimensión mínima: 300px
• Sin límite superior explícito de resolución
• El encuadre de salida sigue la composición de la imagen cargada

Solicitud de ejemplo

javascriptCopiar
const response = await fetch('https://api.flaq.ai/api/v1/video/task', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    model_name: 'happyhorse-1.0-image-to-video',
    image_url: 'https://example.com/first-frame.jpg',
    prompt: 'Gentle motion; cinematic lighting',
    duration: 5,
    resolution: '1080p',
    seed: 42,
  }),
});

const { data } = await response.json();
const taskId = data.task_id;

Formato de respuesta

Respuesta inicial

jsonCopiar
{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "{task_id}",
    "response_url": "https://api.flaq.ai/api/v1/video/{task_id}",
    "task_status": "submitted"
  }
}

Respuesta de consulta

Consulta GET /api/v1/video/{taskId} para comprobar el estado:

jsonCopiar
{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "{task_id}",
    "response_url": "https://api.flaq.ai/api/v1/video/{task_id}",
    "task_status": "succeed",
    "task_status_msg": null,
    "task_result": {
      "videos": [
        {
          "url": "https://example.com/generated-video.mp4"
        }
      ]
    }
  }
}

Valores de estado

• submitted: Tarea aceptada y en espera de procesamiento
• processing: Generación de video en curso
• succeed: Generación de video completada
• failed: La generación de video falló

Tiempo de procesamiento

Tiempo de procesamiento típico: 2-5 minutos, según la duración y la carga de la cola.

Buenas prácticas

1. Describe el movimiento con claridad: Añade movimiento del sujeto, movimiento de cámara y progresión de la escena para mejorar la dinámica del video.
2. Usa iteraciones cortas primero: Empieza con generaciones de 3-5 segundos para validar la dirección del prompt antes de ejecutar clips más largos clips.
3. Elige la imagen de entrada adecuada: Para imagen a video, usa una imagen clara y bien iluminada con un sujeto bien enfocado.
4. Reutiliza seeds para variantes: Mantén el mismo seed al probar refinamientos del prompt para comparar salidas de forma más consistently.
5. Ajusta la relación al canal de entrega: Usa 16:9 para video horizontal, 9:16 para shorts y reels, y 1:1 para ubicaciones cuadradas.