> ## Documentation Index > Fetch the complete documentation index at: https://docs.aiid.edu.kg/llms.txt > Use this file to discover all available pages before exploring further. # Create video (HappyHorse and Wan) > This series supports OpenAI video generation formats (see the link [Video generation Sora compatible formats](/api-reference/en/video-generation-sora-compatible-format/create-video)). HappyHorse and the Wan video generation API, with public paths following the official DashScope protocol. HappyHorse supports `happyhorse-1.0`, `happyhorse-1.0-i2v`, `happyhorse-1.0-t2v`, `happyhorse-1.0-r2v`, and `happyhorse-1.0-video-edit`; Wan supports `wan-3.0`, `wan-3.0-480p`, and `wan-3.0-1080p`. Among them, `happyhorse-1.0` is an aggregated model and must be distinguished via `mode` into `t2v`, `i2v`, `r2v`, and `video_edit`. The three Wan models are fixed at 720P, 480P, and 1080P respectively, and support 2 to 30 seconds plus up to 10 image, 5 video, and 5 audio references. The public API keeps the official endpoint format; channel-specific prefixes are only concatenated internally when the gateway requests a specific upstream channel. Clients do not need to pass `X-DashScope-Async` explicitly; it is handled by the gateway or the official channel adapter layer. Provides the public request skeleton, task query structure, and recommended validation template for HappyHorse and Wan video generation formats; public paths follow the official DashScope endpoint format. Supported models: happyhorse-1.0, happyhorse-1.0-t2v, happyhorse-1.0-i2v, happyhorse-1.0-r2v, happyhorse-1.0-video-edit, wan-3.0, wan-3.0-480p, wan-3.0-1080p Unified request fields: - `model` (string, required): The external model name for HappyHorse or Wan. Wan supports `wan-3.0`, `wan-3.0-480p`, and `wan-3.0-1080p`; the HappyHorse aggregated model `happyhorse-1.0` must be used together with `mode`. - `mode` (string, optional): Aggregated model mode; common values are `t2v`, `i2v`, `r2v`, and `video_edit`. You can omit this for fixed submodels. - `input.prompt` (string, required): Prompt for video generation or editing. - `input.media` (array[object], optional): Multimedia input. Supports `first_frame`, `last_frame`, `reference_image`, `reference_video`, and `reference_audio`; Wan supports up to 10 images, 5 videos, and 5 audio files. - `parameters.duration` (integer, optional): Generation duration, in seconds. - `parameters.resolution` (string, optional): Output resolution. The three Wan models are fixed at `720P`, `480P`, and `1080P` respectively; common values for HappyHorse are `720P` and `1080P`. - `parameters.ratio` (string, optional): Output aspect ratio, commonly used for text-to-video and reference-to-video. - `parameters.watermark` (boolean, optional): Whether to add a watermark. - `parameters.seed` (integer, optional): Random seed. Common model/mode differences: - `HappyHorse 聚合模型`: Supports model happyhorse-1.0; the aggregated model uses mode to distinguish the final model. - `HappyHorse 文生视频`: Supports model happyhorse-1.0-t2v; official-format text-to-video. - `HappyHorse 首帧图生视频`: Supports model happyhorse-1.0-i2v; official-format first-frame image-to-video. - `HappyHorse 参考生视频`: Supports model happyhorse-1.0-r2v; official-format multi-reference image-to-video. - `HappyHorse 视频编辑`: Supports model happyhorse-1.0-video-edit; official-format video editing. - `Wan 3.0 720P`: Supported model wan-3.0; Wan 3.0 official-format multimodal reference video generation. - `Wan 3.0 480P`: Supported model wan-3.0-480p; Wan 3.0 official-format call fixed at 480P. - `Wan 3.0 1080P`: Supported model wan-3.0-1080p; Wan 3.0 official-format call fixed at 1080P. ## OpenAPI ````yaml api-reference/en/openapi.json POST /api/v1/services/aigc/video-generation/video-synthesis openapi: 3.0.0 info: title: Overseas Expansion Camp API Reference Documentation version: 1.0.0 description: Public AI Gateway API Reference servers: - url: https://api.aiid.edu.kg security: - BearerAuth: [] tags: - name: OpenAI format (Chat) - name: OpenAI Format (Responses) - name: Gemini Format for Image Generation - name: Image generationOpenAI DALL-E format - name: List models - name: Video generationHappyHorse and Wan - name: Video generation Kling format - name: Video generation Omni and Veo formats - name: Video generation Seedance - name: Video generation Sora compatible formats - name: Video generation Vidu - name: Music generation task format paths: /api/v1/services/aigc/video-generation/video-synthesis: post: tags: - Video generationHappyHorse and Wan summary: Create video (HappyHorse and Wan) description: >- This series supports OpenAI video generation formats (see the link [Video generation Sora compatible formats](/api-reference/en/video-generation-sora-compatible-format/create-video)). HappyHorse and the Wan video generation API, with public paths following the official DashScope protocol. HappyHorse supports `happyhorse-1.0`, `happyhorse-1.0-i2v`, `happyhorse-1.0-t2v`, `happyhorse-1.0-r2v`, and `happyhorse-1.0-video-edit`; Wan supports `wan-3.0`, `wan-3.0-480p`, and `wan-3.0-1080p`. Among them, `happyhorse-1.0` is an aggregated model and must be distinguished via `mode` into `t2v`, `i2v`, `r2v`, and `video_edit`. The three Wan models are fixed at 720P, 480P, and 1080P respectively, and support 2 to 30 seconds plus up to 10 image, 5 video, and 5 audio references. The public API keeps the official endpoint format; channel-specific prefixes are only concatenated internally when the gateway requests a specific upstream channel. Clients do not need to pass `X-DashScope-Async` explicitly; it is handled by the gateway or the official channel adapter layer. Provides the public request skeleton, task query structure, and recommended validation template for HappyHorse and Wan video generation formats; public paths follow the official DashScope endpoint format. Supported models: happyhorse-1.0, happyhorse-1.0-t2v, happyhorse-1.0-i2v, happyhorse-1.0-r2v, happyhorse-1.0-video-edit, wan-3.0, wan-3.0-480p, wan-3.0-1080p Unified request fields: - `model` (string, required): The external model name for HappyHorse or Wan. Wan supports `wan-3.0`, `wan-3.0-480p`, and `wan-3.0-1080p`; the HappyHorse aggregated model `happyhorse-1.0` must be used together with `mode`. - `mode` (string, optional): Aggregated model mode; common values are `t2v`, `i2v`, `r2v`, and `video_edit`. You can omit this for fixed submodels. - `input.prompt` (string, required): Prompt for video generation or editing. - `input.media` (array[object], optional): Multimedia input. Supports `first_frame`, `last_frame`, `reference_image`, `reference_video`, and `reference_audio`; Wan supports up to 10 images, 5 videos, and 5 audio files. - `parameters.duration` (integer, optional): Generation duration, in seconds. - `parameters.resolution` (string, optional): Output resolution. The three Wan models are fixed at `720P`, `480P`, and `1080P` respectively; common values for HappyHorse are `720P` and `1080P`. - `parameters.ratio` (string, optional): Output aspect ratio, commonly used for text-to-video and reference-to-video. - `parameters.watermark` (boolean, optional): Whether to add a watermark. - `parameters.seed` (integer, optional): Random seed. Common model/mode differences: - `HappyHorse 聚合模型`: Supports model happyhorse-1.0; the aggregated model uses mode to distinguish the final model. - `HappyHorse 文生视频`: Supports model happyhorse-1.0-t2v; official-format text-to-video. - `HappyHorse 首帧图生视频`: Supports model happyhorse-1.0-i2v; official-format first-frame image-to-video. - `HappyHorse 参考生视频`: Supports model happyhorse-1.0-r2v; official-format multi-reference image-to-video. - `HappyHorse 视频编辑`: Supports model happyhorse-1.0-video-edit; official-format video editing. - `Wan 3.0 720P`: Supported model wan-3.0; Wan 3.0 official-format multimodal reference video generation. - `Wan 3.0 480P`: Supported model wan-3.0-480p; Wan 3.0 official-format call fixed at 480P. - `Wan 3.0 1080P`: Supported model wan-3.0-1080p; Wan 3.0 official-format call fixed at 1080P. operationId: create__happyhorse_wan_task requestBody: required: true content: application/json: schema: type: object required: - model - input properties: model: type: string enum: - happyhorse-1.0 - happyhorse-1.0-t2v - happyhorse-1.0-i2v - happyhorse-1.0-r2v - happyhorse-1.0-video-edit - wan-3.0 - wan-3.0-480p - wan-3.0-1080p example: happyhorse-1.0-t2v description: >- HappyHorse or Wan public model name. Wan supports `wan-3.0`, `wan-3.0-480p`, and `wan-3.0-1080p`; the HappyHorse aggregated model `happyhorse-1.0` must be used with `mode`. mode: type: string enum: - t2v - i2v - r2v - video_edit description: >- Aggregated model mode. Common values are `t2v`, `i2v`, `r2v`, and `video_edit`. The fixed submodel is optional. input: type: object required: - prompt properties: prompt: type: string example: >- A white horse running through a neon city street, cinematic description: Prompt for video generation or editing. media: type: array items: type: object required: - type - url properties: type: type: string enum: - first_frame - last_frame - reference_image - reference_video - reference_audio - video - audio url: type: string format: uri description: >- Multimedia input. Supports `first_frame`, `last_frame`, `reference_image`, `reference_video`, and `reference_audio`; Wan supports up to 10 images, 5 videos, and 5 audio files. parameters: type: object properties: resolution: type: string enum: - 480P - 720P - 1080P example: 720P description: >- Output resolution. The three Wan models are fixed at `720P`, `480P`, and `1080P` respectively; the common values for HappyHorse are `720P` and `1080P`. ratio: type: string example: '16:9' description: >- Output aspect ratio, commonly used for text-to-video and reference-to-video. duration: type: integer example: 5 description: Generation duration in seconds. watermark: type: boolean description: Whether to add a watermark. seed: type: integer description: Random seed. examples: happyhorse_native_aggregate_t2v: summary: HappyHorse aggregated model value: model: happyhorse-1.0 mode: t2v input: prompt: >- A white horse running through a neon city street, cinematic parameters: resolution: 720P ratio: '16:9' duration: 5 happyhorse_native_t2v: summary: HappyHorse Text-to-Video value: model: happyhorse-1.0-t2v input: prompt: >- A white horse running through a neon city street, cinematic parameters: resolution: 720P ratio: '16:9' duration: 5 happyhorse_native_i2v: summary: HappyHorse First-frame image-to-video value: model: happyhorse-1.0-i2v input: prompt: The subject walks forward naturally media: - type: first_frame url: https://example.com/first-frame.jpg parameters: resolution: 720P duration: 5 happyhorse_native_r2v: summary: HappyHorse reference-generated video value: model: happyhorse-1.0-r2v input: prompt: >- Keep the character and product consistent in a cinematic shot media: - type: reference_image url: https://example.com/ref-1.jpg - type: reference_image url: https://example.com/ref-2.jpg parameters: resolution: 720P ratio: '16:9' duration: 5 happyhorse_native_video_edit: summary: HappyHorse Video Editing value: model: happyhorse-1.0-video-edit input: prompt: Change the jacket to a striped sweater media: - type: video url: https://example.com/input.mp4 - type: reference_image url: https://example.com/reference.jpg parameters: resolution: 720P wan_3_0_native: summary: Wan 3.0 720P value: model: wan-3.0 input: prompt: Keep the character consistent across all references media: - type: reference_image url: https://example.com/reference.jpg - type: reference_audio url: https://example.com/reference.mp3 parameters: resolution: 720P ratio: '16:9' duration: 10 wan_3_0_480p_native: summary: Wan 3.0 480P value: model: wan-3.0-480p input: prompt: Create a smooth transition media: - type: first_frame url: https://example.com/first.jpg - type: last_frame url: https://example.com/last.jpg parameters: resolution: 480P ratio: '16:9' duration: 10 wan_3_0_1080p_native: summary: Wan 3.0 1080P value: model: wan-3.0-1080p input: prompt: Generate a cinematic reference video media: - type: reference_video url: https://example.com/reference.mp4 parameters: resolution: 1080P ratio: '16:9' duration: 10 responses: '200': description: Task created successfully content: application/json: schema: type: object required: - id properties: id: type: string example: task_xxx output: type: object properties: task_id: type: string description: >- The task ID returned when creating a task, used to query the task. task_status: type: string description: >- Task status, common values `PENDING`, `RUNNING`, `SUCCEEDED`, `FAILED`. video_url: type: string description: >- The URL of the generated video after the task succeeds. usage: type: object properties: duration: type: string description: Generation duration in seconds. SR: type: string description: Output resolution levels. security: - BearerAuth: [] components: securitySchemes: BearerAuth: type: http scheme: bearer description: |- Use Bearer Token authentication. Format: `Authorization: Bearer sk-xxxxxx` ````