curl --request POST \
  --url https://api.evolink.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "wan2.7-text-to-video",
  "prompt": "A small kitten running under the moonlight",
  "aspect_ratio": "16:9",
  "duration": 5
}
'

{
  "created": 1757169743,
  "id": "task-unified-1757169743-7cvnl5zw",
  "model": "wan2.7-text-to-video",
  "object": "video.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 120
  },
  "type": "video",
  "usage": {
    "billing_rule": "per_call",
    "credits_reserved": 5,
    "user_group": "default"
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or expired token",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": "insufficient_quota",
    "message": "Insufficient quota. Please top up your account.",
    "type": "insufficient_quota"
  }
}

{
  "error": {
    "code": "model_access_denied",
    "message": "Token does not have access to model: wan2.7-text-to-video",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests, please try again later",
    "type": "rate_limit_error"
  }
}

{
  "error": {
    "code": "internal_error",
    "message": "Internal server error",
    "type": "api_error"
  }
}

Wan2.7

Wan2.7 Text to Video

WAN2.7 (wan2.7-text-to-video) model supports text-to-video generation, producing fluent videos from textual prompts
Multi-shot narrative: Control shot structure via natural language in prompt
- Single shot: state “generate a single-shot video” in the prompt
- Multi shot: use “generate a multi-shot video” or timestamped shot lists (e.g. “Shot 1 [0-3s] wide angle: rainy night street”)
- Default: when unspecified, the model interprets prompt content on its own
Audio handling:
- With audio_urls: the model uses the provided audio as the driving source
- Without audio_urls: the model auto-generates background music or sound effects matching the visual content
Asynchronous processing mode, use the returned task ID to query status
Generated video links are valid for 24 hours, please save them promptly

POST

videos

generations

curl --request POST \
  --url https://api.evolink.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "wan2.7-text-to-video",
  "prompt": "A small kitten running under the moonlight",
  "aspect_ratio": "16:9",
  "duration": 5
}
'

{
  "created": 1757169743,
  "id": "task-unified-1757169743-7cvnl5zw",
  "model": "wan2.7-text-to-video",
  "object": "video.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 120
  },
  "type": "video",
  "usage": {
    "billing_rule": "per_call",
    "credits_reserved": 5,
    "user_group": "default"
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or expired token",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": "insufficient_quota",
    "message": "Insufficient quota. Please top up your account.",
    "type": "insufficient_quota"
  }
}

{
  "error": {
    "code": "model_access_denied",
    "message": "Token does not have access to model: wan2.7-text-to-video",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests, please try again later",
    "type": "rate_limit_error"
  }
}

{
  "error": {
    "code": "internal_error",
    "message": "Internal server error",
    "type": "api_error"
  }
}

Authorizations

Authorization

string

header

required

All APIs require Bearer Token authentication

Get your API Key:

Visit the API Key management page to obtain your API Key

Add to request headers:

Authorization: Bearer YOUR_API_KEY

Body

application/json

model

enum<string>

required

Model name, must be wan2.7-text-to-video

Available options:

wan2.7-text-to-video

Example:

"wan2.7-text-to-video"

prompt

string

required

Text prompt for video generation. Supports both Chinese and English; each character/letter counts as 1, with overflow auto-truncated. Maximum length: 5000 characters

Multi-shot narrative: Control shot structure via natural language

Single shot: state "generate a single-shot video" in the prompt
Multi shot: use "generate a multi-shot video" or timestamped shot lists (e.g. "Shot 1 [0-3s]")

Maximum string length: 5000

Example:

"A small kitten running under the moonlight"

negative_prompt

string

Negative prompt describing what should not appear in the video. Supports both Chinese and English. Maximum length 500 characters; overflow is auto-truncated

Maximum string length: 500

Example:

"Blurry, low quality"

audio_urls

string<uri>[]

Driving audio URL array (optional). Currently supports only 1 element

Behavior:

Provided: the model uses this audio as the driving source
Omitted: the model auto-generates background music or sound effects matching the visual content

Format requirements:

Supported formats: wav, mp3
Duration range: 2 ~ 30 seconds
File size: up to 15MB

Truncation handling:

If audio length exceeds duration, the first N seconds are extracted and the rest discarded
If audio length is shorter than the video duration, the remaining portion is silent. For example: if audio is 3s and video duration is 5s, the first 3s have sound and the last 2s are silent

Required array length: 1 element

Example:

["https://example.com/audio.mp3"]

quality

enum<string>

default:720p

Video quality, defaults to 720p

Options:

720p: Standard definition, standard price, this is the default
1080p: High definition, higher price

Available options:

720p,

1080p

Example:

"720p"

aspect_ratio

enum<string>

default:16:9

Video aspect ratio, defaults to 16:9

Output resolution per quality tier:

Quality	16:9	9:16	1:1	4:3	3:4
720p	1280×720	720×1280	960×960	1104×832	832×1104
1080p	1920×1080	1080×1920	1440×1440	1648×1248	1248×1648

Available options:

16:9,

9:16,

1:1,

4:3,

3:4

Example:

"16:9"

duration

number

default:5

Video duration in seconds, range 2-15

Note:

Any integer value between 2~15 seconds is supported
Final billing is based on the actual generated video duration

Required range: 2 <= x <= 15

Example:

5

seed

integer

Random seed, defaults to random

Notes:

Range: 1 ~ 2147483647
Fixing the seed reduces variation when iterating on prompts and improves reproducibility

Required range: 1 <= x <= 2147483647

Example:

42

prompt_extend

boolean

default:false

Whether to enable intelligent prompt rewriting. When enabled, a large model will optimize the prompt, which significantly improves results for simple or insufficiently descriptive prompts.

Note: Default is false. Omitting the field or sending false will not trigger rewriting; explicitly send true to enable.

Example:

false

callback_url

string<uri>

HTTPS callback URL for task completion

Callback Timing:

Triggered when task is completed, failed, or cancelled
Sent after billing confirmation

Security Restrictions:

Only HTTPS protocol is supported
Callbacks to internal IP addresses are prohibited (127.0.0.1, 10.x.x.x, 172.16-31.x.x, 192.168.x.x, etc.)
URL length must not exceed 2048 characters

Callback Mechanism:

Timeout: 10 seconds
Up to 3 retries after failure (retries at 1/2/4 seconds after failure)
Callback response format is consistent with the task query API response
2xx status codes are considered successful, other status codes trigger retries

Example:

"https://your-domain.com/webhooks/video-task-completed"

Response

Video task created successfully

created

integer

Task creation timestamp

Example:

1757169743

string

Task ID

Example:

"task-unified-1757169743-7cvnl5zw"

model

string

Actual model name used

Example:

"wan2.7-text-to-video"

object

enum<string>

Specific task type

Available options:

video.generation.task

progress

integer

Task progress percentage (0-100)

Required range: 0 <= x <= 100

Example:

0

status

enum<string>

Task status

Available options:

pending,

processing,

completed,

failed

Example:

"pending"

task_info

object

Detailed video task information

Show child attributes

type

enum<string>

Task output type

Available options:

text,

image,

audio,

video

Example:

"video"

usage

object

Usage and billing information

Show child attributes

Hailuo-2.3-Fast Video Generation Wan2.7 Image to Video

Image Series

Video Series

Audio Series

Text Series

Account Management

Task Management

File Management

Wan2.7 Text to Video

Authorizations

All APIs require Bearer Token authentication

Body

Response