curl --request POST \
  --url https://api.modellix.ai/api/v1/vidu/template-story \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "story": "love_story",
  "images": [
    "https://example.com/couple.jpg"
  ]
}
'

{
  "code": 0,
  "message": "success",
  "data": {
    "status": "pending",
    "task_id": "task-vidu-story-001",
    "model_id": "vidu/template-story",
    "get_result": {
      "method": "GET",
      "url": "https://api.modellix.ai/api/v1/tasks/task-vidu-story-001"
    }
  }
}

{
  "code": 400,
  "message": "Invalid parameters: parameter 'first_frame_image' is required"
}

{
  "code": 401,
  "message": "Authentication failed: invalid API key"
}

{
  "code": 429,
  "message": "Rate limit exceeded: 100 requests per minute, retry after 60 seconds"
}

{
  "code": 500,
  "message": "Internal server error"
}

Vidu Template Story

[Core Function] Vidu Template Story is a narrative video generation model. [Strengths] It excels at placing user-provided character images into predefined, structured narrative templates (like ‘love_story’ or ‘monkey_king’) to automatically generate a cohesive short film. [Best For] Highly recommended for: creating instant themed short stories, personalized entertainment videos, and viral social media narrative trends. [Limitations] Do NOT use this model if the user wants completely custom motion or a unique storyline not covered by the available templates. It restricts creativity to the predefined story structure. [Routing] Use this only when the user explicitly requests to put their characters into a specific story template.

POST

vidu

template-story

curl --request POST \
  --url https://api.modellix.ai/api/v1/vidu/template-story \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "story": "love_story",
  "images": [
    "https://example.com/couple.jpg"
  ]
}
'

{
  "code": 0,
  "message": "success",
  "data": {
    "status": "pending",
    "task_id": "task-vidu-story-001",
    "model_id": "vidu/template-story",
    "get_result": {
      "method": "GET",
      "url": "https://api.modellix.ai/api/v1/tasks/task-vidu-story-001"
    }
  }
}

{
  "code": 400,
  "message": "Invalid parameters: parameter 'first_frame_image' is required"
}

{
  "code": 401,
  "message": "Authentication failed: invalid API key"
}

{
  "code": 429,
  "message": "Rate limit exceeded: 100 requests per minute, retry after 60 seconds"
}

{
  "code": 500,
  "message": "Internal server error"
}

Authorizations

Authorization

string

header

required

API Key authentication. Format: Bearer YOUR_API_KEY.

Body

application/json

Vidu template story request.

story

enum<string>

required

Story template type

Available options:

love_story,

workday_feels,

monkey_king,

pigsy,

monk_tang,

one_shot

Example:

"love_story"

images

string[]

required

Character or scene images as URLs or base64 data URIs

Minimum array length: 1

Minimum string length: 1

Example:

["https://example.com/character.jpg"]

Response

Task submitted successfully

code

integer

required

Response code, 0 indicates success

Example:

0

message

string

required

Response message

Example:

"success"

data

object

required

Detailed data about the submitted asynchronous task.

Show child attributes

Model API

Common API

File API

Vidu Template Story

Authorizations

Body

Response