List Templates
Query parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
limit | integer | 50 | Number of templates to return (max 100) |
offset | integer | 0 | Pagination offset |
category | string | — | Filter by template category |
Request
Response
Response fields
Template object
| Field | Type | Description |
|---|---|---|
id | string | Unique template identifier |
title | string | Display name |
description | string or null | Brief description |
category | string | Template category |
duration_sec | number or null | Target video duration in seconds |
input_variables | array | List of input variable definitions |
prompt_template | string or null | Text template with {{key}} tokens |
Input variable object
| Field | Type | Description |
|---|---|---|
key | string | Unique variable identifier (used in prompt template) |
label | string | Human-readable label |
type | string | text, image, or video |
required | boolean | Whether the input must be provided |
placeholder | string | Suggested placeholder text (optional) |
description | string | Help text for the variable (optional) |
default_value | string | Default S3 key or URL for image/video variables (optional) |
max_length | number | Maximum text length (optional) |
min_length | number | Minimum text length (optional) |
slot | string | Generation slot mapping (optional) |
Pagination object
| Field | Type | Description |
|---|---|---|
offset | number | Current offset |
limit | number | Requested limit |
has_more | boolean | Whether more results exist beyond this page |

