alibaba/happyhorse-1.1/image-to-video

image-vers-vidéo

HappyHorse 1.1 Image-to-Video API by Alibaba

alibaba/happyhorse-1.1/image-to-video

Image-to-video

Animates a first-frame image into video with optional prompt guidance, 480P, 720P, or 1080P output, and durations from 3 to 15 seconds.

Comparer les modèles

HappyHorse 1.1 Image-to-Video est développé par Alibaba. Atlas Cloud (exploité par Atlas Cloud AI LLC) en fournit l’accès mais n’en est pas propriétaire. Toutes les marques appartiennent à leurs détenteurs respectifs.

Entrée

Prompt

Image *

Vous pouvez glisser-déposer le fichier ou cliquer pour télécharger

MAX:1

Résolution

Durée

Graine

Sortie

Inactif

Les vidéos générées apparaîtront ici

Configurez vos paramètres et cliquez sur exécuter pour commencer

Votre requête coûtera $0.07 par exécution. Avec $10, vous pouvez exécuter ce modèle environ 142 fois.

Vous pouvez continuer avec :

Seedance 2.0 Kling v3 Vidu Wan2.7

Paramètres

Exemple de code
import requests
import time

# Step 1: Start video generation
generate_url = "https://api.atlascloud.ai/api/v1/model/generateVideo"
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer $ATLASCLOUD_API_KEY"
}
data = {
    "model": "alibaba/happyhorse-1.1/image-to-video",  # Required. Model name. options: alibaba/happyhorse-1.1/image-to-video
    "image": "example_value",  # Required. First-frame image URL
    "prompt": "A beautiful sunset over the ocean with gentle waves",  # Optional text prompt to guide the motion, style, or scene details
    "resolution": "1080p",  # Output video resolution. options: 480p | 720p | 1080p
    "duration": 5,  # Video duration in seconds. (min: 3, max: 15)
    "seed": -1,  # Random seed for video generation. (min: -1, max: 2147483647)
}

generate_response = requests.post(generate_url, headers=headers, json=data)
generate_result = generate_response.json()
prediction_id = generate_result["data"]["id"]

# Step 2: Poll for result
poll_url = f"https://api.atlascloud.ai/api/v1/model/prediction/{prediction_id}"

def check_status():
    while True:
        response = requests.get(poll_url, headers={"Authorization": "Bearer $ATLASCLOUD_API_KEY"})
        result = response.json()

        if result["data"]["status"] in ["completed", "succeeded"]:
            print("Generated video:", result["data"]["outputs"][0])
            return result["data"]["outputs"][0]
        elif result["data"]["status"] == "failed":
            raise Exception(result["data"]["error"] or "Generation failed")
        else:
            # Still processing, wait 2 seconds
            time.sleep(2)

video_url = check_status()

Installer

Installez le package requis pour votre langage.

pip install requests

Authentification

Toutes les requêtes API nécessitent une authentification via une clé API. Vous pouvez obtenir votre clé API depuis le tableau de bord Atlas Cloud.

export ATLASCLOUD_API_KEY="your-api-key-here"

En-têtes HTTP

import os

API_KEY = os.environ.get("ATLASCLOUD_API_KEY")
headers = {
    "Content-Type": "application/json",
    "Authorization": f"Bearer {API_KEY}"
}

Protégez votre clé API

N'exposez jamais votre clé API dans du code côté client ou dans des dépôts publics. Utilisez plutôt des variables d'environnement ou un proxy backend.

Soumettre une requête

import requests

url = "https://api.atlascloud.ai/api/v1/model/generateVideo"
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer $ATLASCLOUD_API_KEY"
}
data = {
    "model": "your-model",
    "prompt": "A beautiful landscape"
}

response = requests.post(url, headers=headers, json=data)
print(response.json())

Soumettre une requête

Soumettez une requête de génération asynchrone. L'API renvoie un identifiant de prédiction que vous pouvez utiliser pour vérifier le statut et récupérer le résultat.

POST/api/v1/model/generateVideo

Corps de la requête

import requests

url = "https://api.atlascloud.ai/api/v1/model/generateVideo"
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer $ATLASCLOUD_API_KEY"
}

data = {
    "model": "alibaba/happyhorse-1.1/image-to-video",
    "prompt": "A beautiful sunset over the ocean with gentle waves"
}

response = requests.post(url, headers=headers, json=data)
result = response.json()

print(f"Prediction ID: {result['data']['id']}")
print(f"Status: {result['data']['status']}")

Réponse

{
  "code": 200,
  "data": {
    "id": "pred_abc123",
    "status": "processing",
    "model": "model-name",
    "created_at": "2025-01-01T00:00:00Z"
  }
}

Vérifier le statut

Interrogez le point de terminaison de prédiction pour vérifier le statut actuel de votre requête.

GET/api/v1/model/prediction/{prediction_id}

Exemple d'interrogation

import requests
import time

prediction_id = "pred_abc123"
url = f"https://api.atlascloud.ai/api/v1/model/prediction/{prediction_id}"
headers = { "Authorization": "Bearer $ATLASCLOUD_API_KEY" }

while True:
    response = requests.get(url, headers=headers)
    result = response.json()
    status = result["data"]["status"]
    print(f"Status: {status}")

    if status in ["completed", "succeeded"]:
        output_url = result["data"]["outputs"][0]
        print(f"Output URL: {output_url}")
        break
    elif status == "failed":
        print(f"Error: {result['data'].get('error', 'Unknown')}")
        break

    time.sleep(3)

Valeurs de statut

processingLa requête est encore en cours de traitement.

completedLa génération est terminée. Les résultats sont disponibles.

succeededLa génération a réussi. Les résultats sont disponibles.

failedLa génération a échoué. Vérifiez le champ d'erreur.

Réponse terminée

{
  "data": {
    "id": "pred_abc123",
    "status": "completed",
    "outputs": [
      "https://storage.atlascloud.ai/outputs/result.mp4"
    ],
    "metrics": {
      "predict_time": 45.2
    },
    "created_at": "2025-01-01T00:00:00Z",
    "completed_at": "2025-01-01T00:00:10Z"
  }
}

Téléverser des fichiers

Téléversez des fichiers vers le stockage Atlas Cloud et obtenez une URL utilisable dans vos requêtes API. Utilisez multipart/form-data pour le téléversement.

POST/api/v1/model/uploadMedia

Exemple de téléversement

import requests

url = "https://api.atlascloud.ai/api/v1/model/uploadMedia"
headers = { "Authorization": "Bearer $ATLASCLOUD_API_KEY" }

with open("image.png", "rb") as f:
    files = {"file": ("image.png", f, "image/png")}
    response = requests.post(url, headers=headers, files=files)

result = response.json()
download_url = result["data"]["download_url"]
print(f"File URL: {download_url}")

Réponse

{
  "data": {
    "download_url": "https://storage.atlascloud.ai/uploads/abc123/image.png",
    "file_name": "image.png",
    "content_type": "image/png",
    "size": 1024000
  }
}

Schema d'entrée

Les paramètres suivants sont acceptés dans le corps de la requête.

Total: 6Requis: 2Optionnel: 4

modelstringrequired

Model name.

Default: "alibaba/happyhorse-1.1/image-to-video"

alibaba/happyhorse-1.1/image-to-video

imagestringrequired

First-frame image URL. Supported formats are JPEG, JPG, PNG, and WEBP. Use an image at least 300 px wide and 300 px high, no larger than 20 MB, and with an aspect ratio between 1:2.5 and 2.5:1.

promptstring

Optional text prompt to guide the motion, style, or scene details. Maximum length is 2500 characters.

resolutionstring

Output video resolution.

Default: "1080p"

480p720p1080p

durationinteger

Video duration in seconds.

Default: 5Min: 3Max: 15

seedinteger

Random seed for video generation. Use -1 for a random seed.

Default: -1Min: -1Max: 2147483647

Exemple de corps de requête

{
  "model": "alibaba/happyhorse-1.1/image-to-video",
  "image": "example_image",
  "resolution": "1080p",
  "duration": 5,
  "seed": -1
}

Schema de sortie

L'API renvoie une réponse de prédiction avec les URL des résultats générés.

codeinteger

messagestring

dataunknown

Exemple de réponse

{
  "id": "pred_abc123",
  "status": "completed",
  "model": "model-name",
  "outputs": [
    "https://storage.atlascloud.ai/outputs/result.mp4"
  ],
  "metrics": {
    "predict_time": 45.2
  },
  "created_at": "2025-01-01T00:00:00Z",
  "completed_at": "2025-01-01T00:00:10Z"
}

Atlas Cloud Skills

Atlas Cloud Skills intègre plus de 400 modèles d'IA directement dans votre assistant de codage IA. Une seule commande pour installer, puis utilisez le langage naturel pour générer des images, des vidéos et discuter avec des LLM.

Clients pris en charge

Claude Code

OpenAI Codex

Gemini CLI

Cursor

Windsurf

VS Code

Trae

GitHub Copilot

Cline

Roo Code

Amp

Goose

Replit

40+ clients pris en charge

Installer

npx skills add AtlasCloudAI/atlas-cloud-skills

Configurer la clé API

Obtenez votre clé API depuis le tableau de bord Atlas Cloud et définissez-la comme variable d'environnement.

export ATLASCLOUD_API_KEY="your-api-key-here"

Fonctionnalités

Une fois installé, vous pouvez utiliser le langage naturel dans votre assistant IA pour accéder à tous les modèles Atlas Cloud.

Génération d'imagesGénérez des images avec des modèles comme Nano Banana 2, Z-Image, et plus encore.

Création de vidéosCréez des vidéos à partir de texte ou d'images avec Kling, Vidu, Veo, etc.

Chat LLMDiscutez avec Qwen, DeepSeek et d'autres grands modèles de langage.

Téléversement de médiasTéléversez des fichiers locaux pour l'édition d'images et les workflows image-vers-vidéo.

En savoir plus

github.com/AtlasCloudAI/atlas-cloud-skills

Serveur MCP

Le serveur MCP Atlas Cloud connecte votre IDE avec plus de 400 modèles d'IA via le Model Context Protocol. Compatible avec tout client compatible MCP.

Clients pris en charge

Cursor

VS Code

Windsurf

Claude Code

OpenAI Codex

Gemini CLI

Cline

Roo Code

100+ clients pris en charge

Installer

npx -y atlascloud-mcp

Configuration

Ajoutez la configuration suivante au fichier de paramètres MCP de votre IDE.

{
  "mcpServers": {
    "atlascloud": {
      "command": "npx",
      "args": [
        "-y",
        "atlascloud-mcp"
      ],
      "env": {
        "ATLASCLOUD_API_KEY": "your-api-key-here"
      }
    }
  }
}

Outils disponibles

atlas_generate_imageGénérez des images à partir de prompts textuels.

atlas_generate_videoCréez des vidéos à partir de texte ou d'images.

atlas_chatDiscutez avec de grands modèles de langage.

atlas_list_modelsParcourez plus de 400 modèles d'IA disponibles.

atlas_quick_generateCréation de contenu en une étape avec sélection automatique du modèle.

atlas_upload_mediaTéléversez des fichiers locaux pour les workflows API.

En savoir plus

github.com/AtlasCloudAI/mcp-server

Schéma API

{
  "info": {
    "title": "AtlasCloud API",
    "version": "1.0.0",
    "description": "The AtlasCloud API."
  },
  "openapi": "3.0.0",
  "paths": {
    "/api/v1/model/generateImage": {
      "post": {
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Input"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PredictionResponse"
                }
              }
            },
            "description": "The request status."
          }
        }
      },
      "x-api-name": "model_run"
    },
    "/api/v1/model/prediction/{request_id}": {
      "get": {
        "parameters": [
          {
            "in": "path",
            "name": "request_id",
            "required": true,
            "schema": {
              "description": "Request ID",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PredictionResponse"
                }
              }
            },
            "description": "Result of the request."
          }
        }
      },
      "x-api-name": "model_result"
    }
  },
  "components": {
    "schemas": {
      "Input": {
        "type": "object",
        "properties": {
          "model": {
            "type": "string",
            "description": "Model name.",
            "default": "alibaba/happyhorse-1.1/image-to-video",
            "enum": [
              "alibaba/happyhorse-1.1/image-to-video"
            ]
          },
          "image": {
            "description": "First-frame image URL. Supported formats are JPEG, JPG, PNG, and WEBP. Use an image at least 300 px wide and 300 px high, no larger than 20 MB, and with an aspect ratio between 1:2.5 and 2.5:1.",
            "type": "string"
          },
          "prompt": {
            "description": "Optional text prompt to guide the motion, style, or scene details. Maximum length is 2500 characters.",
            "type": "string"
          },
          "resolution": {
            "default": "1080p",
            "description": "Output video resolution.",
            "enum": [
              "480p",
              "720p",
              "1080p"
            ],
            "type": "string"
          },
          "duration": {
            "default": 5,
            "minimum": 3,
            "maximum": 15,
            "description": "Video duration in seconds.",
            "type": "integer"
          },
          "seed": {
            "default": -1,
            "minimum": -1,
            "maximum": 2147483647,
            "description": "Random seed for video generation. Use -1 for a random seed.",
            "type": "integer"
          }
        },
        "required": [
          "model",
          "image"
        ],
        "x-order-properties": [
          "model",
          "image",
          "prompt",
          "resolution",
          "duration",
          "seed"
        ]
      },
      "PredictionResponse": {
        "type": "object",
        "properties": {
          "code": {
            "type": "integer"
          },
          "message": {
            "type": "string"
          },
          "data": {
            "$ref": "#/components/schemas/PredictionData"
          }
        }
      },
      "PredictionData": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Unique ID of the generation task."
          },
          "model": {
            "type": "string",
            "description": "Model used for the generation."
          },
          "outputs": {
            "type": "array",
            "description": "Generated video results. Each item is a video URL.",
            "items": {
              "type": "string"
            }
          },
          "urls": {
            "type": "object",
            "properties": {
              "get": {
                "type": "string"
              }
            }
          },
          "status": {
            "type": "string",
            "description": "Current task status, such as created, processing, completed, unknown, or failed."
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "error": {
            "type": "string",
            "description": "Error message returned when the task fails."
          }
        }
      }
    }
  },
  "servers": [
    {
      "url": "https://api.atlascloud.ai"
    }
  ]
}

Template de Prompt pour LLM

# alibaba/happyhorse-1.1/image-to-video

> Animates a first-frame image into video with optional prompt guidance, 480P, 720P, or 1080P output, and durations from 3 to 15 seconds.


## Overview

- **Submit endpoint (POST)**: `https://api.atlascloud.ai/api/v1/model/generateVideo` — start an async generation; returns a `prediction_id`
- **Poll endpoint (GET)**: `https://api.atlascloud.ai/api/v1/model/prediction/{prediction_id}` — poll this until the prediction finishes
- **Model ID**: `alibaba/happyhorse-1.1/image-to-video`


## API Information

This model can be used via our HTTP API or more conveniently via our client libraries.
See the input and output schema below, as well as the usage examples.


### Input Schema

The API accepts the following input parameters:

- **`model`** (`string`, _required_):
  Model name.
  - Default: `"alibaba/happyhorse-1.1/image-to-video"`
  - Options: "alibaba/happyhorse-1.1/image-to-video"

- **`image`** (`string`, _required_):
  First-frame image URL. Supported formats are JPEG, JPG, PNG, and WEBP. Use an image at least 300 px wide and 300 px high, no larger than 20 MB, and with an aspect ratio between 1:2.5 and 2.5:1.

- **`prompt`** (`string`, _optional_):
  Optional text prompt to guide the motion, style, or scene details. Maximum length is 2500 characters.

- **`resolution`** (`string`, _optional_):
  Output video resolution.
  - Default: `"1080p"`
  - Options: "480p", "720p", "1080p"

- **`duration`** (`integer`, _optional_):
  Video duration in seconds.
  - Default: `5`
  - Min: 3
  - Max: 15

- **`seed`** (`integer`, _optional_):
  Random seed for video generation. Use -1 for a random seed.
  - Default: `-1`
  - Min: -1
  - Max: 2147483647



**Required Parameters Example**:

```json
{
  "model": "alibaba/happyhorse-1.1/image-to-video",
  "image": ""
}
```


**Full Example**:

```json
{
  "model": "alibaba/happyhorse-1.1/image-to-video",
  "image": "",
  "prompt": "",
  "resolution": "1080p",
  "duration": 5,
  "seed": -1
}
```


### Output Schema

The API returns the following output format:


- **`code`** (`integer`, _optional_):

- **`message`** (`string`, _optional_):

- **`data`** (`string`, _optional_):



**Example Response**:

```json
{
  "code": 0,
  "message": "",
  "data": null
}
```


## Usage Examples

### cURL

```bash
# Step 1: Start generation (async)
curl -X POST "https://api.atlascloud.ai/api/v1/model/generateVideo" \
  -H "Authorization: Bearer $ATLASCLOUD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "alibaba/happyhorse-1.1/image-to-video",
  "image": "",
  "prompt": "",
  "resolution": "1080p",
  "duration": 5,
  "seed": -1
}'

# Response will contain: {"code": 200, "data": {"id": "prediction_id", "status": "processing"}}

# Step 2: Poll for result (replace {prediction_id} with the id returned above)
curl -X GET "https://api.atlascloud.ai/api/v1/model/prediction/{prediction_id}" \
  -H "Authorization: Bearer $ATLASCLOUD_API_KEY"

# Keep polling until status is "completed", "succeeded" or "failed"
# When completed, outputs will contain the generated content URL(s)
```

## Additional Resources

### Documentation

- [Model Playground](https://www.atlascloud.ai/models/alibaba/happyhorse-1.1/image-to-video)

A classic white sports car races across an endless salt flat at golden hour. Fine dust trails swirl behind the tires as the vehicle glides effortlessly across the vast landscape. The camera begins with an ultra-wide aerial shot, emphasizing the immense emptiness surrounding the car. It then transitions into a low-angle tracking shot beside the wheels, capturing spinning rims and flying dust particles in slow motion. Warm sunset light reflects across the sleek bodywork while long shadows stretch over the textured ground. The horizon glows with soft orange and blue gradients, creating a minimalist cinematic composition. Motion blur, dynamic camera movement, atmospheric dust, dramatic scale, luxury automotive commercial, cinematic lighting, ultra realistic, IMAX cinematography, Porsche commercial style, 8K.

Chargement...

Alibaba HappyHorse 1.1 Image-to-Video

Alibaba HappyHorse 1.1 Image-to-Video animates a single first-frame image into a short video clip, with optional prompt guidance, two output resolutions, and support for durations from 3 to 15 seconds.

What makes it stand out?

Simple first-frame workflow: Start from one image URL and turn it into motion.
Prompt-guided animation: Add a prompt when you want more control over action, style, or atmosphere.
Two output resolutions: Generate at 720P or 1080P.
Practical input constraints: Works with common image formats up to 20 MB.

Designed For

Teams turning still artwork, concept frames, or product renders into motion clips.
Creators producing short animated shots from posters, illustrations, or key art.
Storyboard and previsualization workflows that need a lightweight first-frame animation path.

How to Use

Provide an image URL to use as the first frame.
Add a prompt if you want to steer motion, pacing, or scene detail.
Choose 720P or 1080P based on your quality target.
Set a duration between 3 and 15 seconds.
Use a fixed seed when you want a more repeatable result.

HappyHorse 1.1 Image-to-Video API by Alibaba

Entrée

Sortie

Paramètres

Exemple de code

Installer

Authentification

En-têtes HTTP

Soumettre une requête

Soumettre une requête

Corps de la requête

Réponse

Vérifier le statut

Exemple d'interrogation

Valeurs de statut

Réponse terminée

Téléverser des fichiers

Exemple de téléversement

Réponse

Schema d'entrée

Exemple de corps de requête

Schema de sortie

Exemple de réponse

Atlas Cloud Skills

Clients pris en charge

Installer

Configurer la clé API

Fonctionnalités

Serveur MCP

Clients pris en charge

Installer

Configuration

Outils disponibles

Schéma API

Template de Prompt pour LLM

Alibaba HappyHorse 1.1 Image-to-Video

What makes it stand out?

Designed For

How to Use

Découvrir des modèles similaires

HappyHorse-1.1 Reference-to-video

HappyHorse-1.1 Text-to-video

HappyHorse-1.0 Image-to-video

HappyHorse-1.0 Text-to-video

HappyHorse-1.0 Video-edit

HappyHorse-1.0 Reference-to-video

Wan-2.7 Text-to-video

Wan-2.7 Image-to-video

Wan-2.7 Reference-to-video

Wan-2.7 Video-edit

Wan-2.2 Image-to-video

Wan-2.2 Image-to-video Lora

Wan-2.6 Image-to-video Flash

Wan-2.6 Video-to-video

Wan-2.6 Image-to-video

Wan-2.6 Text-to-video

Une seule API pour toute l'IA multimédia.

Entrée

Sortie

Paramètres

Exemple de code

Installer

Authentification

En-têtes HTTP

Soumettre une requête

Soumettre une requête

Corps de la requête

Réponse

Vérifier le statut

Exemple d'interrogation

Valeurs de statut

Réponse terminée

Téléverser des fichiers

Exemple de téléversement

Réponse

Schema d'entrée

Exemple de corps de requête

Schema de sortie

Exemple de réponse

Atlas Cloud Skills