> ## Documentation Index
> Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Create a Wan video
> Create a Wan text-to-video task through CometAPI with POST /v1/videos, then poll the task and download the completed MP4 file.
Use this endpoint to create a Wan text-to-video task. The API returns a task ID immediately, so store the returned `id` and poll the task until it reaches a terminal status.
`POST /v1/videos` uses `multipart/form-data`; pass scalar controls as form fields.
## Choose a model
| Model ID | Input mode |
| -------- | ------------- |
| `wan2.7` | Text-to-video |
| `wan2.6` | Text-to-video |
## Set duration and size
| Model ID | `seconds` | Default |
| -------- | ---------------- | ------------------------ |
| `wan2.7` | integer `2`-`15` | `5` seconds, `1920x1080` |
| `wan2.6` | `5`, `10`, `15` | `5` seconds, `1920x1080` |
Set `size` to one of the WxH values below for the target model.
### Wan 2.7 size values
| Resolution tier | Aspect ratio | `size` (`WxH`) |
| --------------- | ------------ | -------------- |
| `720p` | `16:9` | `1280x720` |
| | `9:16` | `720x1280` |
| `1080p` | `16:9` | `1920x1080` |
| | `9:16` | `1080x1920` |
| | `1:1` | `1440x1440` |
### Wan 2.6 size values
| Resolution tier | Aspect ratio | `size` (`WxH`) |
| --------------- | ------------ | -------------- |
| `720p` | `16:9` | `1280x720` |
| | `9:16` | `720x1280` |
| | `4:3` | `1088x832` |
| | `3:4` | `832x1088` |
| `1080p` | `16:9` | `1920x1080` |
| | `9:16` | `1080x1920` |
| | `1:1` | `1440x1440` |
| | `4:3` | `1632x1248` |
| | `3:4` | `1248x1632` |
## Task flow
Send the multipart form request and store the returned `id`.
Call [Retrieve a Wan video](./retrieve) until `status` is `completed`, `failed`, or `error`.
When the task is `completed`, call [Retrieve Wan video content](./retrieve-content) to download the MP4 file.
## OpenAPI
````yaml api/openapi/video/wan/post-create.openapi.json POST /v1/videos
openapi: 3.1.0
info:
title: Wan Video Create API
version: 1.0.0
description: >-
Create an asynchronous Wan text-to-video task through CometAPI. Save the
returned id, poll GET /v1/videos/{task_id}, and download the completed MP4
file.
servers:
- url: https://api.cometapi.com
security:
- bearerAuth: []
paths:
/v1/videos:
post:
summary: Create a Wan video task
description: Create a Wan text-to-video task. Send fields as multipart/form-data.
operationId: wan_create_video
requestBody:
required: true
content:
multipart/form-data:
schema:
$ref: '#/components/schemas/WanCreateRequest'
examples:
text_to_video:
summary: Text-to-video
value:
model: wan2.6
prompt: >-
A small robot walks through a bright greenhouse with smooth
camera movement.
seconds: '5'
size: 1280x720
responses:
'200':
description: >-
Task created. Store the returned id and poll GET
/v1/videos/{task_id}.
content:
application/json:
schema:
$ref: '#/components/schemas/WanVideoTask'
example:
id: task_example
task_id: task_example
object: video
model: wan2.6
status: queued
progress: 0
created_at: 1779938152
'400':
description: >-
The request is missing a required field or contains a value that the
selected model cannot use.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'401':
description: The API key is missing or invalid.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
security:
- bearerAuth: []
x-codeSamples:
- lang: Shell
label: Text-to-video
source: |-
curl https://api.cometapi.com/v1/videos \
-H "Authorization: Bearer $COMETAPI_KEY" \
-F model=wan2.6 \
-F 'prompt=A small robot walks through a bright greenhouse with smooth camera movement.' \
-F seconds=5 \
-F size=1280x720
- lang: Python
label: Text-to-video
source: |
import os
import requests
fields = [
("model", (None, "wan2.6")),
("prompt", (None, "A small robot walks through a bright greenhouse with smooth camera movement.")),
("seconds", (None, "5")),
("size", (None, "1280x720")),
]
response = requests.post(
"https://api.cometapi.com/v1/videos",
headers={"Authorization": "Bearer " + os.environ["COMETAPI_KEY"]},
files=fields,
timeout=120,
)
response.raise_for_status()
print(response.json())
- lang: JavaScript
label: Text-to-video
source: >
const form = new FormData();
form.append("model", "wan2.6");
form.append("prompt", "A small robot walks through a bright
greenhouse with smooth camera movement.");
form.append("seconds", "5");
form.append("size", "1280x720");
const response = await fetch("https://api.cometapi.com/v1/videos", {
method: "POST",
headers: { Authorization: `Bearer ${process.env.COMETAPI_KEY}` },
body: form,
});
const result = await response.json();
console.log(result);
components:
schemas:
WanCreateRequest:
type: object
required:
- model
- prompt
properties:
model:
type: string
description: Wan model ID for this endpoint.
enum:
- wan2.6
- wan2.7
example: wan2.6
prompt:
type: string
description: Text prompt that describes the video to generate.
example: >-
A small robot walks through a bright greenhouse with smooth camera
movement.
seconds:
type: string
description: >-
Requested clip duration in seconds. For wan2.6, use 5, 10, or 15.
For wan2.7, use an integer from 2 through 15. Default is 5.
example: '5'
size:
type: string
description: >-
Supported WxH size values. For wan2.6: 1280x720, 720x1280, 1088x832,
832x1088, 1920x1080, 1080x1920, 1440x1440, 1632x1248, 1248x1632. For
wan2.7: 1280x720, 720x1280, 1920x1080, 1080x1920, 1440x1440. Default
is 1920x1080.
example: 1280x720
additionalProperties: false
WanVideoTask:
type: object
required:
- id
- object
- model
- status
- progress
- created_at
properties:
id:
type: string
description: Task ID. Use this value with retrieve and content endpoints.
example: task_example
task_id:
type: string
description: Compatibility alias for id when present.
example: task_example
object:
type: string
description: Object type. Video tasks return video.
example: video
model:
type: string
description: Model ID used for the task.
example: wan2.6
status:
type: string
description: >-
Task lifecycle status. Poll until the value is completed, failed, or
error.
enum:
- queued
- in_progress
- completed
- failed
- error
example: queued
progress:
type: integer
minimum: 0
maximum: 100
description: Task progress as a coarse percentage.
example: 0
created_at:
type: integer
description: Task creation time as a Unix timestamp in seconds.
example: 1779938152
completed_at:
type: integer
description: >-
Task completion time as a Unix timestamp in seconds. This field
appears on completed tasks.
example: 1779938219
video_url:
type: string
description: Temporary video delivery URL. This field appears on completed tasks.
example:
error:
type: object
description: Failure details. This field appears when the task fails.
additionalProperties: true
additionalProperties: true
ErrorResponse:
description: Error body returned when a request cannot be created or the task fails.
type: object
additionalProperties: true
securitySchemes:
bearerAuth:
type: http
scheme: bearer
description: Bearer authentication. Use your CometAPI API key.
````