curl --request POST \
  --url https://api.evolink.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "happyhorse-1.1-image-to-video",
  "prompt": "Make the cat in the picture run on the grass",
  "image_urls": [
    "https://cdn.example.com/cat.png"
  ],
  "quality": "720p",
  "duration": 5
}
'

{
  "created": 1761313744,
  "id": "task-unified-1761313744-h1i2vcd9",
  "model": "happyhorse-1.1-image-to-video",
  "object": "video.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 2400,
    "video_duration": 5
  },
  "type": "video",
  "usage": {
    "billing_rule": "per_second",
    "credits_reserved": 607500,
    "user_group": "default"
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or expired token",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": "insufficient_quota",
    "message": "Insufficient quota. Please top up your account.",
    "type": "insufficient_quota"
  }
}

{
  "error": {
    "code": "model_access_denied",
    "message": "Token does not have access to model: happyhorse-1.1-image-to-video",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests, please try again later",
    "type": "rate_limit_error"
  }
}

{
  "error": {
    "code": "internal_error",
    "message": "Internal server error",
    "type": "api_error"
  }
}

HappyHorse 1.1

HappyHorse 1.1 Image-to-Video

HappyHorse 1.1 image-to-video, genere une video a partir d’une seule image de premiere frame
prompt est optionnel (lorsqu’il est omis, la premiere frame guide une interpretation libre)
Le rapport d’aspect de sortie est determine automatiquement par la premiere frame ; aspect_ratio n’est pas pris en charge
Mode de traitement asynchrone, utilisez l’ID de tache retourne pour consulter le statut
Les liens video generes sont valides pendant 24 heures, sauvegardez-les rapidement

POST

videos

generations

curl --request POST \
  --url https://api.evolink.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "happyhorse-1.1-image-to-video",
  "prompt": "Make the cat in the picture run on the grass",
  "image_urls": [
    "https://cdn.example.com/cat.png"
  ],
  "quality": "720p",
  "duration": 5
}
'

{
  "created": 1761313744,
  "id": "task-unified-1761313744-h1i2vcd9",
  "model": "happyhorse-1.1-image-to-video",
  "object": "video.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 2400,
    "video_duration": 5
  },
  "type": "video",
  "usage": {
    "billing_rule": "per_second",
    "credits_reserved": 607500,
    "user_group": "default"
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or expired token",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": "insufficient_quota",
    "message": "Insufficient quota. Please top up your account.",
    "type": "insufficient_quota"
  }
}

{
  "error": {
    "code": "model_access_denied",
    "message": "Token does not have access to model: happyhorse-1.1-image-to-video",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests, please try again later",
    "type": "rate_limit_error"
  }
}

{
  "error": {
    "code": "internal_error",
    "message": "Internal server error",
    "type": "api_error"
  }
}

Autorisations

Authorization

string

header

requis

Toutes les interfaces necessitent une authentification par Bearer Token

Obtenir une cle API :

Visitez la Page de gestion des cles API pour obtenir votre cle API

Ajouter dans l'en-tete de requete :

Authorization: Bearer YOUR_API_KEY

Corps

application/json

model

enum<string>

défaut:happyhorse-1.1-image-to-video

requis

Nom du modele de generation video

Options disponibles:

happyhorse-1.1-image-to-video

Exemple:

"happyhorse-1.1-image-to-video"

image_urls

string<uri>[]

requis

URL de l'image de premiere frame, obligatoire (le premier element du tableau est utilise comme premiere frame)

Exigences pour les images :

Formats pris en charge : JPEG, JPG, PNG, WEBP
Resolution : largeur et hauteur ≥ 300 px
Rapport d'aspect : 1:2.5 ~ 2.5:1
Taille du fichier : ≤ 10MB
Les URLs des images doivent etre accessibles publiquement (HTTP ou HTTPS) ; les liens OSS prives, intranet ou authentifies ne sont pas pris en charge

Required array length: 1 element

Exemple:

["https://cdn.example.com/cat.png"]

prompt

string

Prompt textuel, optionnel (lorsqu'il est omis, la premiere frame guide une interpretation libre)

Limites de longueur :

Chinois : jusqu'a 2500 caracteres
Non chinois : jusqu'a 5000 caracteres
Le contenu excedentaire est automatiquement tronque

Exemple:

"Make the cat in the picture run on the grass"

quality

enum<string>

défaut:720p

Niveau de resolution video, par defaut 720p

Options :

720p : clarte standard, valeur par defaut
1080p : clarte HD

Note de facturation : Le niveau de resolution affecte directement la facturation

Options disponibles:

720p,

1080p

Exemple:

"720p"

duration

integer

défaut:5

Duree de la video (secondes), par defaut 5 secondes

Plage :

Entier 3 ~ 15
La duree affecte directement la facturation

Plage requise: 3 <= x <= 15

Exemple:

5

seed

integer

Graine aleatoire, par defaut aleatoire

Details :

Plage : 1 ~ 2147483647
Une graine fixe reduit les variations dues aux parametres lors de l'iteration sur les prompts et ameliore la reproductibilite

Plage requise: 1 <= x <= 2147483647

Exemple:

42

callback_url

string<uri>

URL de rappel HTTPS apres l'achevement de la tache

Declenchement du rappel :

Declenche lorsque la tache est terminee, echouee ou annulee
Envoye apres la confirmation de la facturation

Restrictions de securite :

Seul le protocole HTTPS est pris en charge
Les rappels vers des adresses IP privees sont interdits (127.0.0.1, 10.x.x.x, 172.16-31.x.x, 192.168.x.x, etc.)
La longueur de l'URL ne doit pas depasser 2048 caracteres

Mecanisme de rappel :

Delai d'expiration : 10 secondes
Jusqu'a 3 tentatives apres un echec (respectivement 1/2/4 secondes apres l'echec)
Le format du corps de la reponse de rappel est identique au format de reponse de l'API de requete de tache
Un code de statut 2xx est considere comme un succes ; les autres codes declenchent des nouvelles tentatives

Exemple:

"https://your-domain.com/webhooks/video-task-completed"

Réponse

Tache de generation video creee avec succes

created

integer

Horodatage de creation de la tache

Exemple:

1761313744

string

ID de la tache

Exemple:

"task-unified-1761313744-h1i2vcd9"

model

string

Nom du modele effectivement utilise

Exemple:

"happyhorse-1.1-image-to-video"

object

enum<string>

Type specifique de la tache

Options disponibles:

video.generation.task

progress

integer

Pourcentage de progression de la tache (0-100)

Plage requise: 0 <= x <= 100

Exemple:

0

status

enum<string>

Statut de la tache

Options disponibles:

pending,

processing,

completed,

failed,

cancelled

Exemple:

"pending"

task_info

object

Informations detaillees de la tache video

Show child attributes

type

enum<string>

Type de sortie de la tache

Options disponibles:

text,

image,

audio,

video

Exemple:

"video"

usage

object

Informations d'utilisation et de facturation

Show child attributes

HappyHorse 1.1 Text-to-Video HappyHorse 1.1 Reference-to-Video

Série Image

Série Vidéo

Série Audio

Série Texte

Gestion du compte

Gestion des tâches

Gestion des fichiers

HappyHorse 1.1 Image-to-Video

Autorisations

Toutes les interfaces necessitent une authentification par Bearer Token

Corps

Réponse