For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
WebsiteModelsPricingGet Started
DocumentationAPI Reference
DocumentationAPI Reference
  • API Reference
      • GETList all templates
      • GETGet a template
      • GETList video templates
      • GETGet a video template
      • GETList image templates
      • GETGet an image template
Logo
WebsiteModelsPricingGet Started
API ReferenceTemplates

Get an image template

GET
https://api.empiriolabs.ai/v1/images/templates/:slug
GET
/v1/images/templates/:slug
$curl https://api.empiriolabs.ai/v1/images/templates/background-swap \
>     -H "Authorization: Bearer <token>" \
>     -H "Content-Type: application/json"
1{
2  "slug": "background-swap",
3  "display_name": "Background Swap",
4  "category": "edit",
5  "description": "Swap the background of an image seamlessly with AI-powered segmentation and replacement.",
6  "recommended_model": "empirio-background-v1",
7  "supported_models": [
8    "empirio-background-v1",
9    "kling-o3",
10    "vision-transformer-v2"
11  ],
12  "default_params": {
13    "aspect_ratio": "4:3",
14    "duration": 0
15  },
16  "required_inputs": {
17    "image": true,
18    "video": false,
19    "min_images": 1,
20    "max_images": 1,
21    "text_allowed": false
22  },
23  "metadata": {
24    "cover_position": "center",
25    "suggested_prompts": [
26      "Replace background with a beach scene",
27      "Change background to a city skyline at night"
28    ],
29    "picker_label": "Choose your new background"
30  },
31  "cover_image_url": "https://cdn.empiriolabs.ai/templates/background-swap/cover.jpg",
32  "preview_video_url": null,
33  "modality": "image",
34  "is_featured": true,
35  "display_order": 3,
36  "updated_at": "2024-04-10T14:45:00Z"
37}
Was this page helpful?
Previous

Generate a video

Next
Built with

Authentication

AuthorizationBearer

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

Path parameters

slugstringRequired

Response

Template detail.
slugstring
display_namestring
categoryenum
descriptionstring
recommended_modelstring
supported_modelslist of strings
default_paramsmap from strings to any
required_inputsobject
metadatamap from strings to any

Template-level UI hints (cover positioning, suggested prompts, picker labels). Fields are customer-safe.

cover_image_urlstring or null
preview_video_urlstring or null
modalityenum
Allowed values:
is_featuredboolean
display_orderinteger
updated_atdatetime

Errors

404
Not Found Error