---
title: "WAN 2.7 - Create video from text"
method: POST
path: "/v1/ai/text-to-video/wan-2-7"
tags: ["text-to-video"]
---

# WAN 2.7 - Create video from text

`POST /v1/ai/text-to-video/wan-2-7`

## Request

- Base URL: `https://api.magnific.com`
- URL: `https://api.magnific.com/v1/ai/text-to-video/wan-2-7`
- Auth: API key in header `x-magnific-api-key`

Generate a video from a text prompt using WAN 2.7. Supports configurable aspect ratios (16:9, 9:16, 1:1, 4:3, 3:4), resolutions (720P, 1080P), optional audio input, and duration from 2 to 15 seconds.

**Key features:**
- 720P and 1080P resolution support
- 5 aspect ratio options
- Optional audio-guided generation
- Automatic prompt expansion for richer output
- Duration range: 2-15 seconds

## Request body

- T2vRequest: Generate video from a text prompt using WAN 2.7. Supports configurable aspect ratios (16:9, 9:16, 1:1, 4:3, 3:4), resolutions (720P, 1080P), optional audio input, and duration from 2 to 15 seconds.
  - `webhook_url` string, uri: Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.
  - `prompt` string, required: Text description of the video to generate. Describe the scene, characters, motion, camera movements, lighting, and style in detail for best results. **Tips:** - Be specific about scenes and visual details - Describe camera movements (zoom, pan, tilt) - Mention lighting and atmosphere **Examples:** - Simple: "a cat sitting on a windowsill" - Detailed: "fluffy orange cat on wooden windowsill, looking at snow falling outside, soft warm lighting, cinematic slow camera pan"
  - `negative_prompt` string: Elements to avoid in the generated video. Use this to prevent unwanted artifacts or styles. **Examples:** "blurry, low quality, watermark, text, distortion, extra limbs"
  - `audio_url` string, uri: URL of an audio file to guide the video generation. If not provided, the model may auto-generate audio. **Supported formats:** WAV, MP3 **Duration:** 2-30 seconds **Maximum file size:** 15MB
  - `aspect_ratio` '16:9' | '9:16' | '1:1' | '4:3' | '3:4': Output video aspect ratio: - `16:9`: Landscape (widescreen) - `9:16`: Portrait (vertical, mobile-optimized) - `1:1`: Square - `4:3`: Standard landscape - `3:4`: Standard portrait
  - `resolution` '720P' | '1080P': Output video resolution: - `720P`: 720p HD (1280x720) - `1080P`: 1080p Full HD (1920x1080)
  - `duration` integer: Duration of the output video in seconds.
  - `seed` integer: Random seed for reproducible generation. Use the same seed with identical parameters to reproduce results. Leave unset for random seed.
  - `additional_settings` AdditionalSettings: Additional generation settings.
    - `prompt_extend` boolean: Enable automatic prompt expansion to enrich shorter prompts with additional detail for better video output.

## Response `200`

OK - The task exists and the status is returned

- InlineObject4
  - `data` TaskDetail1, required
    - `task_id` string, uuid, required: Task identifier
    - `status` 'CREATED' | 'IN_PROGRESS' | 'COMPLETED' | 'FAILED', required: Task status
    - `generated` string[], required

## Other responses

- `400`: Bad Request - The server could not understand the request due to invalid syntax.
- `401`: Unauthorized - The client must authenticate itself to get the requested response.
- `500`: Internal Server Error - The server has encountered a situation it doesn't know how to handle.
- `503`: Service Unavailable

---

[API](https://skmtc.dev/magnific/apis/magnific-api.md) · [All operations](https://skmtc.dev/magnific/apis/magnific-api/llms.txt) · [OpenAPI document](https://skmtc.dev/magnific/apis/magnific-api/revisions/60711fb082c7?raw)