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"
}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.
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
API Key authentication. Format: Bearer YOUR_API_KEY.
Body
Vidu template story request.
Story template type
love_story, workday_feels, monkey_king, pigsy, monk_tang, one_shot "love_story"
Character or scene images as URLs or base64 data URIs
11["https://example.com/character.jpg"]