Skip to main content
POST
Create video generation task (HappyHorse compatible protocol)
This endpoint is compatible with the HappyHorse protocol, and the request body follows the official Alibaba structure. The X-DashScope-Async header is not required because async semantics are built into the gateway. model must be a platform model identifier (e.g. wan2.7-t2v / wan2.7-i2v / wan2.7-r2v / wan2.7-videoedit), which the gateway rewrites to the channel model name after routing.

Request structure

The request body consists of three parts:
  • model: platform model identifier (required)
  • input: input content, including prompt and the media element list media (first_frame / reference_image / video to edit; accepts public URLs or base64 data)
  • parameters: generation parameters, including resolution (480P / 720P / 1080P), ratio (16:9 default / 9:16 / 1:1 / 4:3 / 3:4 / 5:4 / 4:5 / 9:21 / 21:9), duration, watermark, and seed

Authentication

Include the Authorization header in the format Bearer YOUR_API_KEY.

Supported video models

Quick example

A successful creation returns the task ID:

Next steps

Headers

Authorization
string
required

API Key token (Bearer sk-xxx)

Content-Type
string

Body

application/json
model
string
required

Platform model identifier (e.g. wan2.7-t2v / wan2.7-i2v / wan2.7-r2v / wan2.7-videoedit), rewritten to the channel model name by the gateway after routing

input
object

Input content (prompt and media elements)

parameters
object

Generation parameters

Response

200 - application/json
request_id
string

Gateway request ID

output
object

Task output