popnow
Iniciar sesiónEmpieza a crear

HappyHorse 1.1 API

alibaba/happyhorse-1.1/text-to-videoDesde 105 créditos por un clip de 5 segundos· Crear video

HappyHorse 1.1 es una familia de video de Alibaba con tres endpoints: text-to-video, image-to-video y reference-to-video, que admite hasta nueve imágenes de referencia. Los clips van de 3 a 15 segundos completos a 720p o 1080p, en nueve proporciones que incluyen 4:5, 5:4, 21:9 y 9:21.

Llámalo con el nombre de modelo alibaba/happyhorse-1.1/text-to-video en POST /jobs/createTask, desde 105 créditos por un clip de 5 segundos (1,05 US$). Las cuentas nuevas reciben 30 créditos gratis para que lo pruebes primero en el Playground.

  • Crear video
  • Imagen a video
  • Referencias a video
  • Hasta 1080p
  • Clips de 3 a 15 s
  • Hasta 9 imágenes de referencia
  • 9 relaciones de aspecto
de AlibabaObtener clave APIEjemplos y prompts de HappyHorse 1.1 →

Por ahora esta guía solo está en inglés. →

Parámetros de la petición

ParámetroObligatorioDescripción
promptSíDescribe the scene, action, camera movement, and timing.
resolutionNoTamaño de salida. Más grande es más nítido y cuesta más. 720p · 1080p · Por defecto: 720p
aspect_ratioNoLa forma del encuadre: horizontal, cuadrado o vertical. 16:9 · 9:16 · 1:1 · 4:3 · 3:4 · 4:5 · 5:4 · 9:21 · 21:9 · Por defecto: 16:9
duration_secondsNoCuánto dura el clip. Se cobra por segundo. ≥ 3 · ≤ 15 · Por defecto: 5

Precios

Los precios están en créditos, los mismos que usas en la web (1 crédito = 0,01 $). El importe se retiene cuando se acepta la tarea y se liquida al coste real cuando termina; las tareas fallidas se reembolsan.

OpciónCréditos por segundo≈ USD
resolution 720p210,21 US$
resolution 1080p270,27 US$

Para saber la cifra exacta antes de ejecutar, envía el mismo cuerpo a POST /jobs/quote.

Inicio rápido de la API

Llama a la API de HappyHorse 1.1 en tres pasos

  1. Crea una clave de API. Inicia sesión en PopNow y crea una clave en la consola de la API. Las claves empiezan por sk-popnow- y usan los mismos créditos que el sitio web.
  2. Envía la solicitud. Haz POST /jobs/createTask con model alibaba/happyhorse-1.1/text-to-video y un objeto input según la tabla de parámetros. La respuesta devuelve un ID de tarea al instante.
  3. Obtén el resultado. Consulta GET /jobs/recordInfo con el ID de tarea, o pasa una callBackUrl y te enviamos el resultado ahí. Descarga los enlaces de salida cuando la tarea termine bien.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -d '{
  "model": "alibaba/happyhorse-1.1/text-to-video",
  "input": {
    "prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "duration_seconds": 5
  }
}'

# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Sustituye el prompt y los enlaces por los tuyos. La pestaña API tiene la referencia de la respuesta, el sondeo y el callback.

Preguntas sobre la API de HappyHorse 1.1

¿Cuánto cuesta la API de HappyHorse 1.1?

HappyHorse 1.1 cuesta desde 105 créditos (1,05 US$) por un clip de 5 segundos con Crear video, su tarea más barata. Precios por opción: 720p 21 créditos por segundo, 1080p 27 créditos por segundo. Los créditos son los mismos que en la web (1 crédito = 0,01 $), las cuentas nuevas reciben 30 créditos gratis y las tareas fallidas se reembolsan.

¿Cuál es el nombre de modelo de HappyHorse 1.1 en la API?

Pon alibaba/happyhorse-1.1/text-to-video para Crear video; alibaba/happyhorse-1.1/image-to-video para Imagen a video; alibaba/happyhorse-1.1/reference-to-video para Referencias a video en el campo model de POST /jobs/createTask.

¿Cuántas imágenes de referencia admite HappyHorse 1.1?

De una a nueve en reference-to-video, donde el campo es obligatorio. Mándalas en el orden en que el prompt se refiere a ellas y dale a cada imagen un solo trabajo: nueve vistas superpuestas del mismo sujeto se promedian en vez de reconciliarse.

¿Qué proporciones hay disponibles?

Nueve: 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21 y 21:9, con 16:9 por defecto. Están expuestas en text-to-video y reference-to-video; el image-to-video toma su forma del cuadro inicial.

¿HappyHorse 1.1 genera audio?

Sí. Los clips vuelven con una pista de audio generada aunque ninguno de los tres endpoints tenga campo de audio, así que no hay forma de desactivarla. Describe en el prompt el sonido que quieres y silencia o reemplaza la pista en la edición cuando el clip vaya bajo tu propia mezcla.

¿Puedo fijar el último cuadro de un clip?

No. En image-to-video no hay campo de cuadro de cierre, solo image_url. Si un plano tiene que aterrizar en una composición concreta, haz de esa composición el cuadro inicial de un movimiento invertido, o corta a ella en la edición.

¿Qué resoluciones admite?

720p y 1080p, con 720p por defecto en cada endpoint. Borronea en 720p y vuelve a correr en 1080p la toma que entregues: cada pasada saca su propia toma, así que fija la redacción en vez de esperar los mismos cuadros.

¿Qué límites tiene la API de HappyHorse 1.1?

Duración del clip: 3–15 s; Resoluciones: 720p · 1080p; Relaciones de aspecto: 16:9 · 9:16 · 1:1 · 4:3 · 3:4 · 4:5 +3; Longitud del prompt (caracteres): 2,500. Las peticiones fuera de estos límites se rechazan antes de cobrar nada.

¿Puedo probar HappyHorse 1.1 sin escribir código?

Sí. El Playground ejecuta HappyHorse 1.1 con tus créditos de PopNow, no necesita clave API y te muestra el código de cada generación.

Más sobre HappyHorse 1.1