BRASILTradução de apoio para consulta. Código e identificadores técnicos preservados. Consultar referência original ↗
Wan 2.7 -- Recuperar resultado de texto para vídeo
Verifique wan2.7 status da tarefa de vídeo
Pesquise o status da tarefa e baixe o vídeo quando estiver pronto.
Estratégia de votação
- Salve o
task_idde enviar resposta. - Pesquise este endpoint a cada 15 segundos até
task_statuséSUCCEEDEDouFAILED. - Baixe o vídeo de
video_urldentro de 24 horas -- o URL expira depois disso.
OpenAPI
openapi: 3.1.0
info:
title: Wan 2.7 Text-to-Video API
description: Generate videos from text using the Wan 2.7 model. Submit a task asynchronously, then poll `GET /tasks/{task_id}` for the result.
version: 1.0.0
servers:
- url: https://maas.qwencloudapi.com/api/v1
description: Singapore
security:
- BearerAuth: []
paths:
/tasks/{task_id}:
get:
operationId: getWan27TextToVideoTaskStatus
summary: Query task result
description: Poll the status of a submitted task and retrieve the video URL on completion.
parameters:
- name: task_id
in: path
required: true
description: Task ID from the POST response.
schema:
type: string
responses:
"200":
description: Task status retrieved successfully
content:
application/json:
schema:
$ref: "#/components/schemas/Wan27TaskStatusResponse"
examples:
SUCCEEDED:
summary: Task succeeded
value:
request_id: caa62a12-8841-41a6-8af2-xxxxxx
output:
task_id: eff1443c-ccab-4676-aad3-xxxxxx
task_status: SUCCEEDED
submit_time: 2025-09-29 14:18:52.331
scheduled_time: 2025-09-29 14:18:59.290
end_time: 2025-09-29 14:23:39.407
orig_prompt: An epic and cute scene. A small, adorable cartoon kitten general, wearing exquisitely detailed golden armor and a slightly oversized helmet, stands bravely on a cliff.
video_url: https://dashscope-result-sh.oss-accelerate.aliyuncs.com/xxx.mp4?Expires=xxx
usage:
duration: 10
input_video_duration: 0
output_video_duration: 10
video_count: 1
ratio: 16:9
SR: 720
FAILED:
summary: Task failed
value:
request_id: e5d70b02-ebd3-98ce-9fe8-759d7d7b107d
output:
task_id: 86ecf553-d340-4e21-af6e-a0c6a421c010
task_status: FAILED
code: InvalidParameter
message: The size does not match xxxxxx
RUNNING:
summary: Task running
value:
request_id: c1209113-8437-424f-a386-xxxxxx
output:
task_id: 86ecf553-d340-4e21-af6e-a0c6a421c010
task_status: RUNNING
submit_time: 2025-09-29 14:18:52.331
scheduled_time: 2025-09-29 14:18:59.290
UNKNOWN:
summary: Task expired
value:
request_id: a4de7c32-7057-9f82-8581-xxxxxx
output:
task_id: 502a00b1-19d9-4839-a82f-xxxxxx
task_status: UNKNOWN
"400":
description: Invalid request parameters
content:
application/json:
schema:
$ref: "#/components/schemas/DashScopeErrorResponse"
x-codeSamples:
- lang: curl
label: cURL - Query task result
source: |-
# Replace {task_id} with the actual task ID from the submit response
curl -X GET 'https://maas.qwencloudapi.com/api/v1/tasks/{task_id}' \
-H "Authorization: Bearer $DASHSCOPE_API_KEY"
components:
securitySchemes:
BearerAuth:
type: http
scheme: bearer
description: DashScope API Key. Get one from the [QwenCloud console](https://home.qwencloud.com/api-keys).
schemas:
Wan27TextToVideoRequest:
type: object
required:
- model
- input
properties:
model:
type: string
description: "Model identifier. Supported values: `wan2.7-t2v`, `wan2.7-t2v-2026-06-12`."
enum:
- wan2.7-t2v
- wan2.7-t2v-2026-06-12
example: wan2.7-t2v
input:
type: object
required:
- prompt
description: Input content for video generation.
properties:
prompt:
type: string
description: "Describe the video you want. Supports Chinese and English, up to 5,000 characters (auto-truncated if exceeded). For multi-shot videos, describe each shot with timestamps: `Shot 1 [0-3 seconds] wide shot: ...`."
example: A kitten running in the moonlight.
negative_prompt:
type: string
description: Describe what to exclude from the video (e.g., `low quality, blurry, extra fingers`). Supports Chinese and English, up to 500 characters (auto-truncated if exceeded).
example: low resolution, error, worst quality, low quality, deformed, extra fingers, bad proportions
audio_url:
type: string
format: uri
description: Audio file URL for lip-sync and action-to-audio alignment. The model matches mouth movements and actions to the audio track. Supports WAV and MP3 via HTTP/HTTPS, 2-30 seconds, up to 15 MB. Audio longer than `duration` is truncated; audio shorter than the video leaves the remainder silent. If omitted, the model generates matching background music or sound effects automatically.
parameters:
$ref: "#/components/schemas/Wan27TextToVideoParameters"
Wan27TextToVideoParameters:
type: object
description: Video generation parameters.
properties:
resolution:
type: string
description: |-
Video clarity tier. Higher resolution costs more.
Actual output dimensions depend on `ratio`:
- **720P**: 16:9=1280x720, 9:16=720x1280, 1:1=960x960, 4:3=1104x832, 3:4=832x1104
- **1080P**: 16:9=1920x1080, 9:16=1080x1920, 1:1=1440x1440, 4:3=1648x1248, 3:4=1248x1648
enum:
- 720P
- 1080P
default: 1080P
ratio:
type: string
description: "Aspect ratio of the generated video. Default: `16:9`."
enum:
- 16:9
- 9:16
- 1:1
- 4:3
- 3:4
default: 16:9
duration:
type: integer
description: Video duration in seconds (integer, 2-15). Longer videos cost more -- billing is per second.
minimum: 2
maximum: 15
default: 5
prompt_extend:
type: boolean
description: Rewrite the prompt using a Large Language Model before generation. Improves results for short or vague prompts but adds latency. Set to `false` to use your prompt verbatim.
default: true
watermark:
type: boolean
description: Add an "AI Generated" watermark in the lower-right corner.
default: false
seed:
type: integer
description: Seed for reproducible results. Same seed + same parameters produces similar (not identical) output.
minimum: 0
maximum: 2147483647
AsyncTaskSubmitResponse:
type: object
description: Response from an asynchronous task submission.
properties:
request_id:
type: string
description: Unique request identifier for tracing and troubleshooting.
example: 4909100c-7b5a-9f92-bfe5-xxxxxx
output:
type: object
properties:
task_id:
type: string
description: Task ID for polling status. Use with `GET /tasks/{task_id}`.
example: 0385dc79-5ff8-4d82-bcb6-xxxxxx
task_status:
type: string
description: Initial task status, typically `PENDING`.
enum:
- PENDING
- RUNNING
- SUCCEEDED
- FAILED
Wan27TaskStatusResponse:
type: object
description: Task status response for wan2.7 text-to-video.
properties:
request_id:
type: string
description: Request ID for troubleshooting. Include this when contacting support.
example: caa62a12-8841-41a6-8af2-xxxxxx
output:
type: object
properties:
task_id:
type: string
description: Task ID. Queryable for 24 hours after submission.
example: eff1443c-ccab-4676-aad3-xxxxxx
task_status:
type: string
description: "Task lifecycle: `PENDING` -> `RUNNING` -> `SUCCEEDED` or `FAILED`. `CANCELED` if manually stopped. `UNKNOWN` if expired."
enum:
- PENDING
- RUNNING
- SUCCEEDED
- FAILED
- CANCELED
- UNKNOWN
submit_time:
type: string
description: When the task was submitted (UTC+8, `YYYY-MM-DD HH:mm:ss.SSS`).
example: 2025-09-29 14:18:52.331
scheduled_time:
type: string
description: When the task started executing (UTC+8, `YYYY-MM-DD HH:mm:ss.SSS`).
example: 2025-09-29 14:18:59.290
end_time:
type: string
description: When the task finished (UTC+8, `YYYY-MM-DD HH:mm:ss.SSS`). Only present for `SUCCEEDED` or `FAILED` tasks.
example: 2025-09-29 14:23:39.407
orig_prompt:
type: string
description: Your original prompt text before any rewriting by `prompt_extend`.
video_url:
type: string
format: uri
description: URL of the generated video (MP4, H.264 encoding). Only present when `task_status` is `SUCCEEDED`. **Valid for 24 hours** -- download promptly.
example: https://dashscope-result-sh.oss-accelerate.aliyuncs.com/xxx.mp4?Expires=xxx
code:
type: string
description: Error code. Only present when `task_status` is `FAILED`.
message:
type: string
description: Error message. Only present when `task_status` is `FAILED`.
usage:
type: object
description: Resource consumption. Only present when `task_status` is `SUCCEEDED`.
properties:
duration:
type: number
description: Billable video duration in seconds. Equals `output_video_duration`.
input_video_duration:
type: integer
description: Always `0` for text-to-video (no input video).
output_video_duration:
type: integer
description: Output video duration in seconds. Matches the requested `duration`.
video_count:
type: integer
description: Number of videos generated. Always `1`.
ratio:
type: string
description: Aspect ratio used (e.g., `16:9`). Matches the requested `ratio`.
SR:
type: integer
description: Resolution tier used (e.g., `720` for 720P, `1080` for 1080P). Matches the requested `resolution`.
DashScopeErrorResponse:
type: object
description: DashScope API error response.
properties:
request_id:
type: string
description: Unique request identifier for tracing and support.
code:
type: string
description: Machine-readable error code (e.g., `InvalidParameter`, `Throttling`, `Unauthorized`).
example: InvalidParameter
message:
type: string
description: Human-readable error message.
example: Invalid model name