alibaba/happyhorse-1.0/image-to-video

Hình ảnh-Video

HappyHorse 1.0 Image-to-Video API by Alibaba

alibaba/happyhorse-1.0/image-to-video

Image-to-video

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

So sánh mô hình

HappyHorse 1.0 Image-to-Video do Alibaba phát triển. Atlas Cloud (vận hành bởi Atlas Cloud AI LLC) cung cấp quyền truy cập vào mô hình này và không sở hữu mô hình. Mọi thương hiệu đều thuộc về chủ sở hữu tương ứng.

Đầu vào

Lời nhắc

Hình ảnh *

Bạn có thể kéo thả tệp vào đây hoặc nhấp để tải lên

MAX:1

Độ phân giải

Thời lượng

Seed

Đầu ra

Nhàn rỗi

Video đã tạo của bạn sẽ xuất hiện ở đây

Cấu hình tham số và nhấp Chạy để bắt đầu tạo

Mỗi lần chạy có giá $0.14. Với $10, bạn có thể chạy khoảng 71 lần.

Bạn có thể tiếp tục với:

Seedance 2.0 Kling v3 Vidu Wan2.7

Tham số

Ví dụ mã
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.0/image-to-video",  # Required. Model name. options: alibaba/happyhorse-1.0/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: 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()

Cài đặt

Cài đặt gói cần thiết cho ngôn ngữ lập trình của bạn.

pip install requests

Xác thực

Tất cả các yêu cầu API đều cần xác thực thông qua khóa API. Bạn có thể lấy khóa API từ bảng điều khiển Atlas Cloud.

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

HTTP Headers

import os

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

Bảo mật khóa API của bạn

Không bao giờ để lộ khóa API trong mã phía máy khách hoặc kho lưu trữ công khai. Thay vào đó, hãy sử dụng biến môi trường hoặc proxy phía máy chủ.

Gửi yêu cầu

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())

Gửi yêu cầu

Gửi một yêu cầu tạo nội dung không đồng bộ. API trả về một prediction ID mà bạn có thể dùng để kiểm tra trạng thái và lấy kết quả.

POST/api/v1/model/generateVideo

Nội dung yêu cầu

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.0/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']}")

Phản hồi

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

Kiểm tra trạng thái

Truy vấn (poll) endpoint prediction để kiểm tra trạng thái hiện tại của yêu cầu.

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

Ví dụ truy vấn

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)

Giá trị trạng thái

processingYêu cầu vẫn đang được xử lý.

completedQuá trình tạo đã hoàn tất. Kết quả đầu ra đã sẵn sàng.

succeededQuá trình tạo thành công. Kết quả đầu ra đã sẵn sàng.

failedTạo nội dung thất bại. Hãy kiểm tra trường error.

Phản hồi hoàn tất

{
  "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ải tệp lên

Tải tệp lên bộ nhớ Atlas Cloud và nhận URL mà bạn có thể sử dụng trong các yêu cầu API của mình. Sử dụng multipart/form-data để tải lên.

POST/api/v1/model/uploadMedia

Ví dụ tải lên

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}")

Phản hồi

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

Input Schema

Các tham số sau được chấp nhận trong nội dung yêu cầu.

Tổng cộng: 6Bắt buộc: 2Tùy chọn: 4

modelstringrequired

Model name.

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

alibaba/happyhorse-1.0/image-to-video

imagestringrequired

First-frame image URL. Supported formats are JPEG, JPG, PNG, BMP, and WEBP. Use an image at least 300 px on the shorter side, no larger than 10 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"

720p1080p

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

Ví dụ nội dung yêu cầu

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

Output Schema

API trả về phản hồi prediction kèm theo các URL đầu ra đã tạo.

codeinteger

messagestring

dataunknown

Ví dụ phản hồi

{
  "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 tích hợp hơn 400 mô hình AI trực tiếp vào trợ lý lập trình AI của bạn. Một lệnh để cài đặt, sau đó sử dụng ngôn ngữ tự nhiên để tạo hình ảnh, video và trò chuyện với LLM.

Ứng dụng được hỗ trợ

Claude Code

OpenAI Codex

Gemini CLI

Cursor

Windsurf

VS Code

Trae

GitHub Copilot

Cline

Roo Code

Amp

Goose

Replit

40+ ứng dụng được hỗ trợ

Cài đặt

npx skills add AtlasCloudAI/atlas-cloud-skills

Thiết lập khóa API

Lấy khóa API từ bảng điều khiển Atlas Cloud và đặt nó làm biến môi trường.

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

Khả năng

Sau khi cài đặt, bạn có thể sử dụng ngôn ngữ tự nhiên trong trợ lý AI để truy cập tất cả các mô hình Atlas Cloud.

Tạo hình ảnhTạo hình ảnh với các mô hình như Nano Banana 2, Z-Image và nhiều hơn nữa.

Tạo videoTạo video từ văn bản hoặc hình ảnh với Kling, Vidu, Veo, v.v.

Trò chuyện LLMTrò chuyện với Qwen, DeepSeek và các mô hình ngôn ngữ lớn khác.

Tải lên phương tiệnTải tệp cục bộ lên để chỉnh sửa hình ảnh và quy trình chuyển hình ảnh sang video.

Tìm hiểu thêm

github.com/AtlasCloudAI/atlas-cloud-skills

MCP Server

Atlas Cloud MCP Server kết nối IDE của bạn với hơn 400 mô hình AI thông qua Model Context Protocol. Hoạt động với bất kỳ ứng dụng tương thích MCP nào.

Ứng dụng được hỗ trợ

Cursor

VS Code

Windsurf

Claude Code

OpenAI Codex

Gemini CLI

Cline

Roo Code

100+ ứng dụng được hỗ trợ

Cài đặt

npx -y atlascloud-mcp

Cấu hình

Thêm cấu hình sau vào tệp cài đặt MCP của IDE.

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

Công cụ khả dụng

atlas_generate_imageTạo hình ảnh từ mô tả văn bản.

atlas_generate_videoTạo video từ văn bản hoặc hình ảnh.

atlas_chatTrò chuyện với các mô hình ngôn ngữ lớn.

atlas_list_modelsDuyệt hơn 400 mô hình AI khả dụng.

atlas_quick_generateTạo nội dung một bước với khả năng tự động chọn mô hình tốt nhất.

atlas_upload_mediaTải tệp cục bộ lên cho quy trình API.

Tìm hiểu thêm

github.com/AtlasCloudAI/mcp-server

Schema API

{
  "info": {
    "title": "AtlasCloud API",
    "version": "1.0.0",
    "description": "The AtlasCloud API."
  },
  "openapi": "3.0.0",
  "paths": {
    "/api/v1/model/generateVideo": {
      "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.0/image-to-video",
            "enum": [
              "alibaba/happyhorse-1.0/image-to-video"
            ]
          },
          "image": {
            "description": "First-frame image URL. Supported formats are JPEG, JPG, PNG, BMP, and WEBP. Use an image at least 300 px on the shorter side, no larger than 10 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": [
              "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"
    }
  ]
}

Mẫu Prompt Thân thiện với LLM

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

> Animates a first-frame image into video with optional prompt guidance, 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.0/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.0/image-to-video"`
  - Options: "alibaba/happyhorse-1.0/image-to-video"

- **`image`** (`string`, _required_):
  First-frame image URL. Supported formats are JPEG, JPG, PNG, BMP, and WEBP. Use an image at least 300 px on the shorter side, no larger than 10 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: "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.0/image-to-video",
  "image": ""
}
```


**Full Example**:

```json
{
  "model": "alibaba/happyhorse-1.0/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.0/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.0/image-to-video)

A cinematic shot where the camera smoothly pulls back while tracking a fast-moving car, the character inside focused and intense, motion blur streaking along the environment, dynamic lighting, high-speed atmosphere, shallow depth of field, dramatic composition, 4K, film grain

Đang tải...

Alibaba HappyHorse 1.0 Image-to-Video

Alibaba HappyHorse 1.0 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 10 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.0 Image-to-Video API by Alibaba

Đầu vào

Đầu ra

Tham số

Ví dụ mã

Cài đặt

Xác thực

HTTP Headers

Gửi yêu cầu

Gửi yêu cầu

Nội dung yêu cầu

Phản hồi

Kiểm tra trạng thái

Ví dụ truy vấn

Giá trị trạng thái

Phản hồi hoàn tất

Tải tệp lên

Ví dụ tải lên

Phản hồi

Input Schema

Ví dụ nội dung yêu cầu

Output Schema

Ví dụ phản hồi

Atlas Cloud Skills

Ứng dụng được hỗ trợ

Cài đặt

Thiết lập khóa API

Khả năng

MCP Server

Ứng dụng được hỗ trợ

Cài đặt

Cấu hình

Công cụ khả dụng

Schema API

Mẫu Prompt Thân thiện với LLM

Alibaba HappyHorse 1.0 Image-to-Video

What makes it stand out?

Designed For

How to Use

Khám phá Các Mô hình Tương tự

Wan-3.0-Prime Reference-to-video

Wan-3.0-Prime Image-to-video

Wan-3.0-Prime Text-to-video

Wan-3.0 Reference-to-video

Wan-3.0 Image-to-video

Wan-3.0 Text-to-video

HappyHorse-1.1 Reference-to-video

HappyHorse-1.1 Image-to-video

HappyHorse-1.1 Text-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 Video-edit

Wan-2.7 Reference-to-video

Một API cho mọi AI đa phương tiện.

Đầu vào

Đầu ra

Tham số

Ví dụ mã

Cài đặt

Xác thực

HTTP Headers

Gửi yêu cầu

Gửi yêu cầu

Nội dung yêu cầu

Phản hồi

Kiểm tra trạng thái

Ví dụ truy vấn

Giá trị trạng thái

Phản hồi hoàn tất

Tải tệp lên

Ví dụ tải lên

Phản hồi

Input Schema

Ví dụ nội dung yêu cầu

Output Schema

Ví dụ phản hồi

Atlas Cloud Skills