Intégration API Hailuo Standard
Utilisez Hailuo Standard via Rivya Public API v1 avec le model id hailuo-standard, les entrées prises en charge, les paramètres, les règles Files API, les crédits et des exemples de réponse.
hailuo-standard
text, file
Requis pour les modes avec référence
30
Vidéo
FIXED
1500 caractères
Contrat de requête
Envoyez l'ID du modèle au niveau supérieur. Les contrôles propres au modèle vont dans params.
| Clé | Type | Obligatoire | Par défaut | Description |
|---|---|---|---|---|
| model | string | Oui | hailuo-standard | Utilisez hailuo-standard comme ID de modèle API. |
| prompt | string | Oui | - | Maximum 1500 caractères pour ce modèle. |
| params | object | Non | - | Objet de paramètres propre au modèle. Consultez les lignes ci-dessous pour les clés autorisées. |
| client_request_id | string | Non | - | ID côté client facultatif pour tracer les requêtes dans votre système. |
Paramètres du modèle
| Clé | Type | Obligatoire | Par défaut | Plage | Options | Description |
|---|---|---|---|---|---|---|
| duration | select | Non | 6 | - | 6, 10 | Durée |
| resolution | select | Non | 512P | - | 512P, 768P | Résolution |
| prompt_optimizer | select | Non | false | - | false, true | Permet à Hailuo de réécrire et d'optimiser votre prompt avant la génération. Désactivez-le lorsque vous voulez que la génération reste plus proche de votre formulation brute. |
Règle d'importation
Importez d'abord les fichiers de référence, puis placez l'URL renvoyée et le durationToken dans params.referenceMediaItems.
Images de référence: Le mode image accepte jusqu'à 2 images, et la deuxième devient la dernière image.
2
image
Les références vidéo et audio doivent inclure durationToken depuis /api/v1/files lorsqu'une vérification de durée est requise.
| kind | Taille max. | Types MIME |
|---|---|---|
| image | 10 MB | image/jpeg, image/png, image/webp |
Requête minimale
{
"model": "hailuo-standard",
"prompt": "A cinematic product reveal with smooth camera movement",
"params": {
"duration": "6",
"resolution": "512P",
"prompt_optimizer": "false"
}
}Requête avec fichier de référence
{
"model": "hailuo-standard",
"prompt": "A cinematic product reveal with smooth camera movement",
"params": {
"duration": "6",
"resolution": "512P",
"prompt_optimizer": "false",
"referenceMediaItems": [
{
"url": "https://cdn.example.com/reference-image.png",
"kind": "image",
"name": "reference-image.png",
"mimeType": "image/png"
}
]
}
}Réponse de création
L'endpoint de création renvoie un ID de tâche public. Interrogez l'endpoint de statut jusqu'à ce que la tâche réussisse ou échoue.
{
"id": "task_hailuo_standard_example",
"status": "queued",
"model": "hailuo-standard",
"reserved_credits": 30,
"final_credits": 0,
"created_at": "2026-05-11T00:00:00.000Z",
"updated_at": "2026-05-11T00:00:00.000Z",
"result": null,
"error": null
}Erreurs courantes
validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found
Certains modes exigent des importations de référence via Files API.