happyhorse-1.1-r2v API

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

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

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

Prompt : One continuous take, no cuts. Keep the woman in the crimson satin coat and the peeling carpet ribbons from the reference and move the event outdoors: she walks out of a revolving door onto a wet plaza and the patterned ribbons keep tearing up behind her, now lifting off the paving stones and streaming out across the square in a long coloured wake. The camera tracks backward ahead of her at waist height and cranes up as the wake spreads. One hard green sign light above the door, warm street lamps across the plaza. Real weight and inertia, satin and wet stone, no text.

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

{
  "model": "happyhorse-1.1-r2v",
  "prompt": "One continuous take, no cuts. Keep the woman in the crimson satin coat and the peeling carpet ribbons from the reference and move the event outdoors: she walks out of a revolving door onto a wet plaza and the patterned ribbons keep tearing up behind her, now lifting off the paving stones and streaming out across the square in a long coloured wake. The camera tracks backward ahead of her at waist height and cranes up as the wake spreads. One hard green sign light above the door, warm street lamps across the plaza. Real weight and inertia, satin and wet stone, 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-r2v",
    "input": {"prompt": "The person in [Image 1] picks up [Image 2].", "media": [{"type": "reference_image", "url": "https://example.com/person.jpg"}, {"type": "reference_image", "url": "https://example.com/object.jpg"}]},
    "parameters": {"resolution": "1080P", "ratio": "16:9", "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 R2V place 1 à 9 éléments reference_image dans input.media et les référence dans l’ordre à partir de l’invite.

Champ	Obligatoire	Remarques
model	Oui	happyhorse-1.1-r2v
input.prompt	Oui	Description textuelle ou instructions de référence, jusqu’à 5 000 caractères non chinois ou 2 500 caractères chinois
input.media[]	Oui	1 à 9 éléments reference_image ; URL publique ou Base64, inférieure à 20 Mo, côté court minimum de 400 px
parameters.resolution	Non	720P / 1080P, par défaut 1080P
parameters.ratio	Non	16:9 / 9:16 / 1:1 / 4:3 / 3:4 / 4:5 / 5:4 / 9:21 / 21:9, par défaut 16:9
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

R2V utilise 1 à 9 éléments reference_image et y fait référence dans un ordre rapide comme Image 1, Image 2, etc. Les invites sont limitées à 5 000 caractères non chinois ou 2 500 caractères chinois ; les images font moins de 20 Mo avec un côté court minimum de 400 px.

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.