List image templates

GET

https://api.empiriolabs.ai/v1/images/templates

GET

/v1/images/templates

$ curl https://api.empiriolabs.ai/v1/images/templates \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/json"

200Retrieved

1 {
2   "object": "list",
3   "template_count": 1,
4   "data": [
5     {
6       "slug": "baseball-stadium",
7       "display_name": "Stadium",
8       "category": "viral",
9       "description": "A dynamic template that places your image or video inside a bustling baseball stadium scene, perfect for sports highlights and fan engagement.",
10       "recommended_model": "kling-o3",
11       "supported_models": [
12         "kling-o3",
13         "kling-o4"
14       ],
15       "default_params": {
16         "aspect_ratio": "16:9",
17         "duration": 5
18       },
19       "required_inputs": {
20         "image": true,
21         "video": true,
22         "min_images": 1,
23         "max_images": 1,
24         "text_allowed": true
25       },
26       "metadata": {
27         "cover_position": "center",
28         "suggested_prompt": "Highlight your favorite baseball moment in a packed stadium",
29         "picker_label": "Baseball Stadium Scene"
30       },
31       "cover_image_url": "https://cdn.empiriolabs.ai/templates/baseball-stadium/cover.jpg",
32       "preview_video_url": "https://cdn.empiriolabs.ai/templates/baseball-stadium/preview.mp4",
33       "modality": "video",
34       "is_featured": true,
35       "display_order": 1,
36       "updated_at": "2024-01-15T09:30:00Z"
37     }
38   ]
39 }

Returns active templates for /v1/images/generations. The response shape matches GET /v1/templates, filtered to modality: "image" by default.

Authentication

AuthorizationBearer

Pass your EmpirioLabs API key as a bearer token. The Anthropic-style x-api-key header is also accepted on every endpoint.

Query parameters

categorystringOptional

Filter to a single category.

modelstringOptional

Only return templates whose supported_models list contains this model slug.

featuredbooleanOptional

Set to true to filter to featured templates only.

Response

List of image templates.

objectstringOptional

template_countintegerOptional

datalist of objectsOptional