典名词元DMTOKENSHome
API DocumentationThird-Party Tools Tutorial
AI Model APIVideoHappyHorse

Image-to-Video - Based on First Frame

POST/api/v1/video/generation

Header Parameters

Authorization*string

Format: Authorization: Bearer sk-xxxxxx

X-DashScope-Async*string

Configuration parameters for asynchronous processing. HTTP requests only support asynchronous mode and must be set to enable.

Request Body

application/json

model*string

Model name, fixed value: happyhorse-1.0-i2v

input*object

Basic input information, such as prompts.

prompt?string

Text prompt. Used to describe the desired video content to be generated. Supports input in any language, with a maximum length of 5,000 non-Chinese characters or 2,500 Chinese characters; any excess will be automatically truncated.

media ?array<object>

Input media list. Used to specify the images required for video generation.

[]?object
type*string

Media asset type, fixed value: first_frame (first frame)

url*string

Media asset URL.

parameters*object

Video processing parameters, such as setting video resolution and duration.

resolution?string

Video resolution, supported: 720P, 1080P (default). The model automatically scales based on the selected resolution level, and the aspect ratio of the output video approximately matches that of the first input frame.

duration?integer

Video duration in seconds, an integer in the range [3, 15], default 5.

watermark?string

Whether to add a watermark in the bottom-right corner of the video (text fixed as "Happy Horse"), default true

seed?string

Random seed, value range [0, 2147483647]. A fixed seed value improves the reproducibility of generated results.

Response Body

application/json

Success

TypeScript Definitions

Use the response body type in TypeScript.

code*integer

Status Code

data*object

Data Object

urls*array<string>

Result Set

[]?string
usage*object

Usage Information

images*integer

Image Count

seconds*integer

Video Duration in Seconds

input_tokens*integer

Input Token Count

total_tokens*integer

Total Token Count

output_tokens*integer

Output token count

expired*string

Validity Period

task_id*string

Task ID

task_status*string

Task Status

message*string

Status Information

request_id*string

Request ID

curl -X POST "https://api.ygw.ai/api/v1/video/generation" \  -H "Authorization: string" \  -H "X-DashScope-Async: string" \  -H "Content-Type: application/json" \  -d '{    "model": "string",    "input": {},    "parameters": {}  }'
{
  "code": 0,
  "data": {
    "urls": [
      "string"
    ],
    "usage": {
      "images": 0,
      "seconds": 0,
      "input_tokens": 0,
      "total_tokens": 0,
      "output_tokens": 0
    },
    "expired": "string",
    "task_id": "string",
    "task_status": "string"
  },
  "message": "string",
  "request_id": "string"
}