---
title: "Submit Wan 2.5 Text-to-Video Task"
method: POST
path: "/api/generate/submit"
tags: ["Wan 2.5"]
---

# Submit Wan 2.5 Text-to-Video Task

`POST /api/generate/submit`

Generate videos from text prompts with Wan 2.5

## Request body

- SubmitRequest
  - `model` 'wan2.5-text-to-video', required — Wan 2.5 text-to-video model identifier
  - `callback_url` string, uri — Webhook callback URL for result notifications
  - `input` object, required — Input parameters for generation
    - `prompt` string, required — Text prompt for video generation. Maximum length is 1,500 characters; longer text is automatically truncated by the upstream model.
    - `aspect_ratio` '832*480' | '480*832' | '1280*720' | '720*1280' | '1920*1080' | '1080*1920' — Output size preset used by the upstream model
    - `duration` 5 | 10 — Video duration in seconds
    - `audio` string — Optional audio setting string. Boolean values are not supported.
    - `negative_prompt` string — Optional negative prompt
    - `seed` integer — Optional random seed for reproducibility

## Response `200`

Task submitted successfully

- SubmitResponse
  - `code` integer, required — HTTP status code
  - `data` object, required
    - `task_id` string, required — Unique task identifier for status tracking
    - `status` 'not_started', required — Initial task status
    - `created_time` string, date-time, required — ISO 8601 timestamp when the task was created

---

[API](https://skmtc.net/poyo/apis/poyo-ai-hunyuan-3d-v3-1-api.md) · [All operations](https://skmtc.net/poyo/apis/poyo-ai-hunyuan-3d-v3-1-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/poyo/poyo-ai-hunyuan-3d-v3-1-api/revisions/4b46904b78eb/schema)