happyhorse-1.1-i2v API

Utilisez l’ID de modèle exact happyhorse-1.1-i2v. Le champ modèle doit correspondre exactement à cette page.

Exemple de sortiehappyhorse-1.1-i2vPOST /v1/videos5.2s

Paramètres : duration=5resolution=1080pratio=16:9Image d'entrée

Prompt : One continuous take, no cuts. The braided steam keeps thickening until the ribbons lock into one coral and ultraviolet serpent that uncoils along the ceiling, drops down past the stools and pours out through the open door into the rain, the cook in the orange jacket stepping back to let it pass. The camera holds at counter height, then tracks with the serpent to the doorway and tilts to watch it leave. One hard tungsten bulb overhead stays the only warm source. Real weight and inertia, visible density in the steam, no text.

Requête qui a produit cet échantillon, avec l'URL du média d'entrée remplacée

{
  "model": "happyhorse-1.1-i2v",
  "prompt": "One continuous take, no cuts. The braided steam keeps thickening until the ribbons lock into one coral and ultraviolet serpent that uncoils along the ceiling, drops down past the stools and pours out through the open door into the rain, the cook in the orange jacket stepping back to let it pass. The camera holds at counter height, then tracks with the serpent to the doorway and tilts to watch it leave. One hard tungsten bulb overhead stays the only warm source. Real weight and inertia, visible density in the steam, no text.",
  "seconds": "5",
  "duration": 5,
  "resolution": "1080p",
  "ratio": "16:9",
  "aspect_ratio": "16:9",
  "image": "https://example.com/input-image.png"
}

Authentification et point de terminaison

Utilisez une clé API Modelflare avec https://modelflare.dev/v1. Le point d’entrée de la passerelle est POST /v1/videos.

HTTP

Authorization: Bearer YOUR_MODELFLARE_API_KEY

Créer une tâche

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "happyhorse-1.1-i2v",
    "input": {"prompt": "The cat runs across the grass as the camera follows smoothly.", "media": [{"type": "first_frame", "url": "https://example.com/cat.png"}]},
    "parameters": {"resolution": "1080P", "duration": 5, "watermark": false}
  }'

Sondage et téléchargement

Enregistrez l’ID de la tâche. Sondez GET /v1/videos/{task_id} et téléchargez avec GET /v1/videos/{task_id}/content. Les URL des résultats peuvent expirer, alors transférez le fichier rapidement.

bash

curl https://modelflare.dev/v1/videos/TASK_ID \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY"

Demander des notes

HappyHorse utilise input.prompt ; choisissez la forme input.media qui correspond à l’ID du modèle t2v, i2v ou r2v.

Paramètres de requête

HappyHorse I2V place une image first_frame dans input.media.

Champ	Obligatoire	Remarques
model	Oui	happyhorse-1.1-i2v
input.prompt	Non	Description facultative des mouvements et de la caméra, jusqu’à 5 000 caractères non chinois ou 2 500 caractères chinois
input.media[]	Oui	Exactement un first_frame ; URL publique ou URL de données Base64, inférieure à 20 Mo, côtés minimum de 300 px et format d’image 1:2,5-2,5:1
parameters.resolution	Non	720P / 1080P, par défaut 1080P
parameters.ratio	Non	Non pris en charge ; la sortie suit le rapport d’image de la première image
parameters.duration	Non	3 à 15 secondes, par défaut 5
parameters.watermark	Non	S’il faut ajouter le filigrane HappyHorse
parameters.seed	Non	Graine facultative de 0 à 2 147 483 647

Limites d’entrée et de sortie

I2V utilise une image first_frame ; acceptez une URL publique ou une URL de données Base64 de moins de 20 Mo avec des côtés minimum de 300 px et un rapport hauteur/largeur de 1:2,5 à 2,5:1, et préservez approximativement le rapport d’entrée.

Erreurs et tâches ayant échoué

Les paramètres de modèle invalides renvoient un 4xx avec un ID de demande. Une tâche asynchrone peut également échouer une fois la création réussie ; utilisez error_code et error_message de la réponse au sondage comme raison finale de la tâche. Ne réessayez pas la même requête avec une forme JSON différente.

Portée prise en charge

Cette page couvre la génération et l’édition de modèles Modelflare. L’enrichissement de la recherche ou de la carte, la gestion de la voix et la gestion de la bibliothèque d’éléments sont des API de ressources en dehors de cette surface d’appel de modèle publique et ne sont pas des champs de requête obligatoires.

Tarification et facturation

Ce modèle utilise la facturation vidéo à la seconde. Consultez la page de tarification du modèle pour connaître le prix client actuel, le prix catalogue de référence et les spécifications complètes.

Note

Cette page documente l’interface publique de Modelflare ; les champs et limites indiqués ici sont le contrat en cours.