PopNowDocs de la API
Contenido principal

Referencia de la API de HappyHorse 1.1

Clips 1080p con sonido en nueve relaciones de aspecto

Con una sola clave de API de PopNow puedes llamar a HappyHorse 1.1 desde tu propio código. Aquí tienes los ID de modelo que debes enviar, cada campo de entrada que acepta, cuántos créditos cuesta cada solicitud y una petición que puedes pegar tal cual en la terminal.

Las descripciones de los parámetros vienen del esquema de entrada del modelo y solo están en inglés.

De un vistazo

Creado por
Alibaba
Resultado
Video
Desde
21 créditos por segundo generado ($0.21)

1 crédito = 0,01 US$. Al aceptarse, la tarea retiene el cargo máximo posible y al terminar cobra el uso real, redondeado al crédito superior; el resto se libera. Las tareas fallidas no se cobran. Para saber la cifra exacta antes de ejecutar, llama a POST /api/v1/jobs/quote.

Crear video

alibaba/happyhorse-1.1/text-to-video

Precio

OpciónCréditos (por segundo generado)Dólares
720p21$0.21
1080p27$0.27

Parámetros

CampoTipoValor predeterminadoValores admitidosPara qué sirve
promptObligatoriostring—hasta 2500 caracteresDescribe the scene, action, camera movement, and timing.
aspect_ratioOpcionalstring16:916:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21, 21:9Output aspect ratio.
resolutionOpcionalstring720p720p, 1080pOutput video resolution.
duration_secondsOpcionalinteger5de 3 a 15Output duration in seconds. Any integer from 3 to 15 is accepted; longer clips cost proportionally more.

Solicitud de ejemplo

Esta solicitud funciona tal cual; los campos que no envíes usan su valor predeterminado. Antes, guarda tu clave en POPNOW_API_KEY.

POST /api/v1/jobs/createTask
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: $(uuidgen)" \
  -d '{
  "model": "alibaba/happyhorse-1.1/text-to-video",
  "input": {
    "prompt": "A paper boat drifts down a rain-soaked street at dusk, neon signs reflecting in the water, slow tracking shot at ground level",
    "duration_seconds": 5,
    "resolution": "720p"
  }
}'

La respuesta trae un taskId al instante. Consulta el resultado con GET /api/v1/jobs/recordInfo o añade callBackUrl para recibir un aviso.

GET /api/v1/jobs/recordInfo
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Imagen a video

alibaba/happyhorse-1.1/image-to-video

Precio

OpciónCréditos (por segundo generado)Dólares
720p21$0.21
1080p27$0.27

Parámetros

CampoTipoValor predeterminadoValores admitidosPara qué sirve
promptObligatoriostring—hasta 2500 caracteresDescribe the scene, action, camera movement, and timing.
image_urlObligatoriostring (uri)——Image used as the first video frame.
resolutionOpcionalstring720p720p, 1080pOutput video resolution.
duration_secondsOpcionalinteger5de 3 a 15Output duration in seconds. Any integer from 3 to 15 is accepted; longer clips cost proportionally more.
seedOpcionalinteger—de 0 a 2147483647Random seed for controlled comparisons. Omit it to let each run pick its own.

Solicitud de ejemplo

Esta solicitud funciona tal cual; los campos que no envíes usan su valor predeterminado. Antes, guarda tu clave en POPNOW_API_KEY.

El ejemplo usa archivos de muestra de PopNow en image_url. Cámbialos por tus propios enlaces HTTPS públicos, archivos subidos o recursos guardados.

POST /api/v1/jobs/createTask
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: $(uuidgen)" \
  -d '{
  "model": "alibaba/happyhorse-1.1/image-to-video",
  "input": {
    "prompt": "He lands softly on the rooftop, laughs and turns toward the camera while the balloons sway in the evening breeze; slow push-in",
    "image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
    "duration_seconds": 5,
    "resolution": "720p"
  }
}'

La respuesta trae un taskId al instante. Consulta el resultado con GET /api/v1/jobs/recordInfo o añade callBackUrl para recibir un aviso.

GET /api/v1/jobs/recordInfo
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Referencias a video

alibaba/happyhorse-1.1/reference-to-video

Precio

OpciónCréditos (por segundo generado)Dólares
720p21$0.21
1080p27$0.27

Parámetros

CampoTipoValor predeterminadoValores admitidosPara qué sirve
promptObligatoriostring—hasta 2500 caracteresDescribe the scene, action, camera movement, and timing.
reference_image_urlsObligatorioarray<string (uri)>—hasta 9 elementosReference images in the order used by the prompt.
aspect_ratioOpcionalstring16:916:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21, 21:9Output aspect ratio.
resolutionOpcionalstring720p720p, 1080pOutput video resolution.
duration_secondsOpcionalinteger5de 3 a 15Output duration in seconds. Any integer from 3 to 15 is accepted; longer clips cost proportionally more.
seedOpcionalinteger—de 0 a 2147483647Random seed for controlled comparisons. Omit it to let each run pick its own.

Solicitud de ejemplo

Esta solicitud funciona tal cual; los campos que no envíes usan su valor predeterminado. Antes, guarda tu clave en POPNOW_API_KEY.

El ejemplo usa archivos de muestra de PopNow en reference_image_urls. Cámbialos por tus propios enlaces HTTPS públicos, archivos subidos o recursos guardados.

POST /api/v1/jobs/createTask
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: $(uuidgen)" \
  -d '{
  "model": "alibaba/happyhorse-1.1/reference-to-video",
  "input": {
    "prompt": "The man from the reference image jogs across a sunlit rooftop at golden hour and smiles at the camera; smooth tracking shot",
    "reference_image_urls": [
      "https://media.popnow.ai/influencer/examples/ava.webp"
    ],
    "duration_seconds": 5,
    "resolution": "720p"
  }
}'

La respuesta trae un taskId al instante. Consulta el resultado con GET /api/v1/jobs/recordInfo o añade callBackUrl para recibir un aviso.

GET /api/v1/jobs/recordInfo
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Siguientes pasos

En esta página