Référence API de HappyHorse 1.1

Une seule clé API PopNow suffit pour appeler HappyHorse 1.1 depuis votre code. Vous trouverez ici les identifiants de modèle à envoyer, chaque champ d’entrée accepté, le coût d’une requête en crédits et une requête à coller telle quelle dans un terminal.

Les descriptions des paramètres proviennent du schéma d’entrée du modèle et ne sont disponibles qu’en anglais.

En bref

Éditeur: Alibaba
Résultat: Vidéo
À partir de: 21 crédits par seconde produite ($0.21)
Identifiants de modèle: alibaba/happyhorse-1.1/text-to-video
alibaba/happyhorse-1.1/image-to-video
alibaba/happyhorse-1.1/reference-to-video

1 crédit = 0,01 $. À l’acceptation, une tâche réserve le montant maximal possible, puis facture la consommation réelle à la fin, arrondie au crédit supérieur ; le reste est libéré. Une tâche en échec n’est pas facturée. Pour connaître le montant exact avant de lancer, appelez POST /api/v1/jobs/quote.

Créer une vidéo

alibaba/happyhorse-1.1/text-to-video

Prix

Option	Crédits (par seconde produite)	Dollars US
`720p`	21	$0.21
`1080p`	27	$0.27

Paramètres

Champ	Type	Valeur par défaut	Valeurs admises	Rôle
`prompt`Obligatoire	`string`	—	jusqu’à 2 500 caractères	Describe the scene, action, camera movement, and timing.
`aspect_ratio`Facultatif	`string`	`16:9`	16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21, 21:9	Output aspect ratio.
`resolution`Facultatif	`string`	`720p`	720p, 1080p	Output video resolution.
`duration_seconds`Facultatif	`integer`	`5`	de 3 à 15	Output duration in seconds. Any integer from 3 to 15 is accepted; longer clips cost proportionally more.

Exemple de requête

Cette requête fonctionne telle quelle ; les champs omis gardent leur valeur par défaut. Placez d’abord votre clé dans 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 réponse contient tout de suite un taskId. Récupérez le résultat avec GET /api/v1/jobs/recordInfo, ou ajoutez callBackUrl pour être prévenu.

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"

Image vers vidéo

alibaba/happyhorse-1.1/image-to-video

Prix

Option	Crédits (par seconde produite)	Dollars US
`720p`	21	$0.21
`1080p`	27	$0.27

Paramètres

Champ	Type	Valeur par défaut	Valeurs admises	Rôle
`prompt`Obligatoire	`string`	—	jusqu’à 2 500 caractères	Describe the scene, action, camera movement, and timing.
`image_url`Obligatoire	`string (uri)`	—	—	Image used as the first video frame.
`resolution`Facultatif	`string`	`720p`	720p, 1080p	Output video resolution.
`duration_seconds`Facultatif	`integer`	`5`	de 3 à 15	Output duration in seconds. Any integer from 3 to 15 is accepted; longer clips cost proportionally more.
`seed`Facultatif	`integer`	—	de 0 à 2147483647	Random seed for controlled comparisons. Omit it to let each run pick its own.

Exemple de requête

Cette requête fonctionne telle quelle ; les champs omis gardent leur valeur par défaut. Placez d’abord votre clé dans POPNOW_API_KEY.

L’exemple utilise des fichiers d’exemple PopNow dans image_url. Remplacez-les par vos propres liens HTTPS publics, fichiers envoyés ou ressources enregistrées.

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 réponse contient tout de suite un taskId. Récupérez le résultat avec GET /api/v1/jobs/recordInfo, ou ajoutez callBackUrl pour être prévenu.

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"

Références vers vidéo

alibaba/happyhorse-1.1/reference-to-video

Prix

Option	Crédits (par seconde produite)	Dollars US
`720p`	21	$0.21
`1080p`	27	$0.27

Paramètres

Champ	Type	Valeur par défaut	Valeurs admises	Rôle
`prompt`Obligatoire	`string`	—	jusqu’à 2 500 caractères	Describe the scene, action, camera movement, and timing.
`reference_image_urls`Obligatoire	`array<string (uri)>`	—	jusqu’à 9 éléments	Reference images in the order used by the prompt.
`aspect_ratio`Facultatif	`string`	`16:9`	16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21, 21:9	Output aspect ratio.
`resolution`Facultatif	`string`	`720p`	720p, 1080p	Output video resolution.
`duration_seconds`Facultatif	`integer`	`5`	de 3 à 15	Output duration in seconds. Any integer from 3 to 15 is accepted; longer clips cost proportionally more.
`seed`Facultatif	`integer`	—	de 0 à 2147483647	Random seed for controlled comparisons. Omit it to let each run pick its own.

Exemple de requête

Cette requête fonctionne telle quelle ; les champs omis gardent leur valeur par défaut. Placez d’abord votre clé dans POPNOW_API_KEY.

L’exemple utilise des fichiers d’exemple PopNow dans reference_image_urls. Remplacez-les par vos propres liens HTTPS publics, fichiers envoyés ou ressources enregistrées.

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 réponse contient tout de suite un taskId. Récupérez le résultat avec GET /api/v1/jobs/recordInfo, ou ajoutez callBackUrl pour être prévenu.

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"

Référence API de HappyHorse 1.1

En bref

Créer une vidéo

Prix

Paramètres

Exemple de requête

Image vers vidéo

Prix

Paramètres

Exemple de requête

Références vers vidéo

Prix

Paramètres

Exemple de requête

Pour aller plus loin

Sur cette page