Вход

Поиск статических кадров из 5489 фильмов по освещению, объективу, ракурсу, цвету и настроению.

готов к вызову Работает Удалённый · Streamable HTTP Без авторизации Веб и поиск ИИ и модели Официальный реестр · 8 просмотров

Что умеет

Поиск статических кадров из 5489 фильмов по освещению, объективу, ракурсу, цвету и настроению.

Перевод каталога (LLM) · показать оригинал автора

Film stills from 5,489 films, searchable by lighting, lens character, shot size, colour and mood.

Подключение

Удалённый сервер: клиент обращается по адресу, код на вашей машине не запускается.

Claude Desktop

claude_desktop_config.json

Cursor

~/.cursor/mcp.json

Windsurf

~/.codeium/windsurf/mcp_config.json

Вставьте блок mcpServers в файл конфигурации своего клиента. Ключи не входят в файл: вместо SET_LOCALLY подставьте свои значения.

{
    "mcpServers": {
        "ai-framethrower-framethrower": {
            "url": "https://framethrower.ai/api/mcp"
        }
    }
}

Вызов без установки — через шлюз

Агент вызывает инструменты этого сервера через https://www.n2j.ru/mcphub/mcp: hub_call_tool {"server":"ai-framethrower-framethrower","tool":"…","arguments":{…}} Ключ не нужен, но сервер N2J ограничивает частоту анонимных вызовов.

https://framethrower.ai/api/mcp

Инструменты

17 схем · ≈ 7 318 условных токенов

search_frames

Search the FrameThrower cinematography reference library by concept, mood, color, composition, or scene. Returns reference frames with film/credits metadata, a preview image and a link to view on FrameThrower. For the full-resolution file or the precomputed depth map, call get frame image with the frame id.

Показать схему аргументов
{
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
        "query"
    ],
    "properties": {
        "limit": {
            "type": "number",
            "maximum": 40,
            "minimum": 1
        },
        "query": {
            "type": "string",
            "description": "Natural-language description, e.g. \"neon-lit rainy street at night\""
        },
        "enhance": {
            "type": "boolean",
            "description": "Smart search, on by default: rewrites short queries (\"bear\") into the descriptive language the frames were indexed with, like the website. Set false to search the exact text."
        }
    }
}

find_by_craft

Find frames by specific cinematography craft attributes — lens character, shot size, visual style, setting, time of day, director, or year range. All optional; combine to narrow. Use this to refine a search precisely.

Показать схему аргументов
{
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "properties": {
        "lens": {
            "type": "string",
            "description": "e.g. \"anamorphic\", \"spherical\", \"vintage_soft\""
        },
        "limit": {
            "type": "number",
            "maximum": 40,
            "minimum": 1
        },
        "setting": {
            "type": "string",
            "description": "\"interior\" or \"exterior\""
        },
        "director": {
            "type": "string"
        },
        "year_max": {
            "type": "number"
        },
        "year_min": {
            "type": "number"
        },
        "shot_size": {
            "type": "string",
            "description": "e.g. \"closeup\", \"wide\", \"medium\""
        },
        "time_of_day": {
            "type": "string",
            "description": "e.g. \"night\", \"day\""
        },
        "visual_style": {
            "type": "string"
        }
    }
}

find_similar

Find frames visually/semantically similar to a given frame id (from a prior result). Use this to pull more references like one the user shortlisted.

Показать схему аргументов
{
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
        "frameId"
    ],
    "properties": {
        "limit": {
            "type": "number",
            "maximum": 40,
            "minimum": 1
        },
        "frameId": {
            "type": "string"
        }
    }
}

get_frame_details

Get the full metadata, a preview image and the FrameThrower link for a single frame id. For the full-resolution file or the depth map (camera geometry for image generation), call get frame image.

Показать схему аргументов
{
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
        "frameId"
    ],
    "properties": {
        "frameId": {
            "type": "string"
        }
    }
}

get_frame_image

One frame's image at a paid size, as a link valid for an hour: "full" = the original full-resolution file (5 credits), "large" = 1280px (2), "depth" = the precomputed depth map, ControlNet-ready (2). Search results show a preview only — use this when the user wants the actual image for a deck, document, download or an image-generation pipeline.

Показать схему аргументов
{
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
        "frameId"
    ],
    "properties": {
        "size": {
            "enum": [
                "full",
                "large",
                "depth"
            ],
            "type": "string",
            "description": "default full"
        },
        "frameId": {
            "type": "string"
        }
    }
}

search_commercials

Find whole COMMERCIALS (TV / online spots) in FrameThrower's ads library by idea, story or brief ("two rival neighbours outdo each other at Christmas", "a product demo told as a heist") and/or by facts: brand, director, agency, production company, DP, editor, award show and level, year, industry, market, tone, genre, structure, season. Without a query it lists matching spots, award winners first. Returns each spot with brand, title, year, credits, best award, logline, a still and a link to watch it.

Показать схему аргументов
{
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "properties": {
        "dp": {
            "type": "string",
            "description": "Director of photography"
        },
        "sort": {
            "enum": [
                "relevance",
                "awards",
                "newest",
                "oldest"
            ],
            "type": "string"
        },
        "tone": {
            "type": "string",
            "description": "funny, heartwarming, epic, emotional, absurd, dark, inspiring…"
        },
        "brand": {
            "type": "string",
            "description": "Advertiser, e.g. \"Nike\", \"Guinness\""
        },
        "genre": {
            "type": "string",
            "description": "comedy, drama, documentary, action…"
        },
        "limit": {
            "type": "number",
            "maximum": 30,
            "minimum": 1
        },
        "music": {
            "type": "string",
            "description": "Composer / track / music house"
        },
        "query": {
            "type": "string",
            "description": "The idea / story in plain words. Leave out to just filter."
        },
        "agency": {
            "type": "string",
            "description": "Creative agency, e.g. \"Wieden+Kennedy\""
        },
        "editor": {
            "type": "string"
        },
        "format": {
            "type": "string",
            "description": "live_action, animation_2d, animation_3d, stop_motion, cgi, mixed"
        },
        "market": {
            "type": "string",
            "description": "Country code: US, UK, FR, DE, BR, JP…"
        },
        "offset": {
            "type": "number",
            "maximum": 1000,
            "minimum": 0
        },
        "person": {
            "type": "string",
            "description": "Anyone credited, any role"
        },
        "season": {
            "type": "string",
            "description": "halloween, christmas, black friday, thanksgiving, new year, valentines, easter, mothers day, fathers day, back to school, summer, spring, pride, super bowl"
        },
        "awarded": {
            "type": "boolean",
            "description": "true = won or shortlisted at an award show"
        },
        "director": {
            "type": "string"
        },
        "industry": {
            "type": "string",
            "description": "Ad category: Auto, Beer, Spirits, Drinks, Food & QSR, Retail, Tech, Telecom, Finance & Insurance, Fashion & Luxury, Beauty & Personal care, Sport, Travel, Gaming, Health & Pharma, Media & Entertainment, Public service & NGO, Home, FMCG"
        },
        "year_max": {
            "type": "number"
        },
        "year_min": {
            "type": "number"
        },
        "celebrity": {
            "type": "boolean"
        },
        "min_award": {
            "enum": [
                "grand_prix",
                "gold",
                "silver",
                "bronze",
                "shortlist"
            ],
            "type": "string",
            "description": "Best award at least this level"
        },
        "structure": {
            "type": "string",
            "description": "narrative, montage, vignettes, problem_solution, demo…"
        },
        "award_show": {
            "type": "string",
            "description": "One of: Cannes Lions, Clio Awards, D&AD, Epica, AICP Awards, London International Awards, British Arrows, The One Show, El Ojo de Iberoamérica, Eurobest, Creative Circle, Effie Awards, Ciclope, Spikes Asia, ANDY Awards, ADC Awards, DGA Awards, Kinsale Sharks, shots Awards, New York Festivals, Webby Awards, Emmy (Outstanding Commercial), IPA Effectiveness Awards, AdFest, Dubai Lynx, ADC Europe, Young Director Award"
        },
        "award_year": {
            "type": "number"
        },
        "production": {
            "type": "string",
            "description": "Production company, e.g. \"MJZ\", \"Smuggler\""
        },
        "max_duration": {
            "type": "number",
            "description": "seconds"
        },
        "min_duration": {
            "type": "number"
        }
    }
}

search_commercial_shots

Find individual SHOTS inside commercials by what is in the frame ("hand pouring beer in slow motion", "car drifting at night in the rain", "family laughing at a kitchen table"), with shot tags (size, angle, setting, time of day, lighting, mood, people, product / logo visible) and any commercial-level filter (brand, director, agency, award show, year…). Each shot has its still, its tags and a link to the exact moment; with clips: true, also a short clip of just that shot.

Показать схему аргументов
{
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
        "query"
    ],
    "properties": {
        "dp": {
            "type": "string",
            "description": "Director of photography"
        },
        "mood": {
            "type": "string"
        },
        "spot": {
            "type": "string",
            "description": "Only inside this commercial (its id, e.g. AD-0505)"
        },
        "brand": {
            "type": "string",
            "description": "Advertiser, e.g. \"Nike\", \"Guinness\""
        },
        "clips": {
            "type": "boolean",
            "description": "true = also return a short clip of each shot (1 credit per clip on top of the call). Ask only when the user wants to see the shots move."
        },
        "limit": {
            "type": "number",
            "maximum": 30,
            "minimum": 1
        },
        "query": {
            "type": "string",
            "description": "What the shot shows, as a description of one frame"
        },
        "agency": {
            "type": "string",
            "description": "Creative agency, e.g. \"Wieden+Kennedy\""
        },
        "market": {
            "type": "string",
            "description": "Country code: US, UK, FR, DE, BR, JP…"
        },
        "people": {
            "type": "string",
            "description": "women, men, kids, teens, adults, seniors (comma-separated = all of them)"
        },
        "season": {
            "type": "string",
            "description": "halloween, christmas, black friday, thanksgiving, new year, valentines, easter, mothers day, fathers day, back to school, summer, spring, pride, super bowl"
        },
        "awarded": {
            "type": "boolean",
            "description": "true = won or shortlisted at an award show"
        },
        "setting": {
            "type": "string",
            "description": "interior, exterior, studio_void or virtual_cg"
        },
        "director": {
            "type": "string"
        },
        "industry": {
            "type": "string",
            "description": "Ad category: Auto, Beer, Spirits, Drinks, Food & QSR, Retail, Tech, Telecom, Finance & Insurance, Fashion & Luxury, Beauty & Personal care, Sport, Travel, Gaming, Health & Pharma, Media & Entertainment, Public service & NGO, Home, FMCG"
        },
        "lighting": {
            "type": "string",
            "description": "natural, high_key, low_key, silhouette, chiaroscuro"
        },
        "per_spot": {
            "type": "number",
            "maximum": 20,
            "minimum": 1,
            "description": "Max shots from one commercial (default 3)"
        },
        "year_max": {
            "type": "number"
        },
        "year_min": {
            "type": "number"
        },
        "min_award": {
            "enum": [
                "grand_prix",
                "gold",
                "silver",
                "bronze",
                "shortlist"
            ],
            "type": "string",
            "description": "Best award at least this level"
        },
        "shot_size": {
            "type": "string",
            "description": "extreme_closeup, closeup, medium_closeup, medium, medium_wide, full, wide, extreme_wide, insert"
        },
        "award_show": {
            "type": "string",
            "description": "One of: Cannes Lions, Clio Awards, D&AD, Epica, AICP Awards, London International Awards, British Arrows, The One Show, El Ojo de Iberoamérica, Eurobest, Creative Circle, Effie Awards, Ciclope, Spikes Asia, ANDY Awards, ADC Awards, DGA Awards, Kinsale Sharks, shots Awards, New York Festivals, Webby Awards, Emmy (Outstanding Commercial), IPA Effectiveness Awards, AdFest, Dubai Lynx, ADC Europe, Young Director Award"
        },
        "production": {
            "type": "string",
            "description": "Production company, e.g. \"MJZ\", \"Smuggler\""
        },
        "time_of_day": {
            "type": "string",
            "description": "day, night, golden_hour, dusk, dawn…"
        },
        "camera_angle": {
            "type": "string",
            "description": "eye_level, low_angle, high_angle, overhead, aerial, pov, worms_eye, dutch"
        },
        "logo_visible": {
            "type": "boolean"
        },
        "text_on_screen": {
            "type": "boolean"
        },
        "black_and_white": {
            "type": "boolean"
        },
        "product_visible": {
            "type": "boolean"
        }
    }
}

get_commercial

The full breakdown of one commercial by id: idea, logline, tagline, product, audience, every credit by role (director, agency, production company, DP, editor, music, post, sound, VFX), every award (show, year, level, category), craft numbers (shots, average shot length, cuts per minute, when the product / brand / emotional peak / end card land), the script with timings, and the shot list (caption, tags and still per shot; with clips: true, each shot's clip too).

Показать схему аргументов
{
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
        "id"
    ],
    "properties": {
        "id": {
            "type": "string",
            "description": "Commercial id, e.g. AD-0505"
        },
        "clips": {
            "type": "boolean",
            "description": "true = also return a short clip of each shot (1 credit per clip on top of the call). Ask only when the user wants to see the shots move."
        },
        "shots": {
            "type": "boolean",
            "description": "Include the shot list (default true)"
        },
        "stills": {
            "type": "boolean",
            "description": "Include each shot's still image (1 credit per shot). Leave off unless the user wants to see the shots."
        }
    }
}

similar_commercials

Commercials like a given one — by STORY (similar idea, tropes and tone) or by LOOK (similar shots: light, framing, palette). Accepts the same filters as search commercials to narrow (e.g. only award winners, only another brand).

Показать схему аргументов
{
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
        "id"
    ],
    "properties": {
        "by": {
            "enum": [
                "story",
                "look"
            ],
            "type": "string",
            "description": "default story"
        },
        "id": {
            "type": "string",
            "description": "Commercial id, e.g. AD-0505"
        },
        "tone": {
            "type": "string",
            "description": "funny, heartwarming, epic, emotional, absurd, dark, inspiring…"
        },
        "brand": {
            "type": "string",
            "description": "Advertiser, e.g. \"Nike\", \"Guinness\""
        },
        "limit": {
            "type": "number",
            "maximum": 20,
            "minimum": 1
        },
        "awarded": {
            "type": "boolean",
            "description": "true = won or shortlisted at an award show"
        },
        "industry": {
            "type": "string",
            "description": "Ad category: Auto, Beer, Spirits, Drinks, Food & QSR, Retail, Tech, Telecom, Finance & Insurance, Fashion & Luxury, Beauty & Personal care, Sport, Travel, Gaming, Health & Pharma, Media & Entertainment, Public service & NGO, Home, FMCG"
        },
        "year_max": {
            "type": "number"
        },
        "year_min": {
            "type": "number"
        },
        "min_award": {
            "enum": [
                "grand_prix",
                "gold",
                "silver",
                "bronze",
                "shortlist"
            ],
            "type": "string",
            "description": "Best award at least this level"
        }
    }
}

similar_commercial_shots

More shots that look like the given shot ids (from earlier results or a shot list) — the refine loop: "more like 2". Takes the same shot tags and commercial filters to steer.

Показать схему аргументов
{
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
        "shot_ids"
    ],
    "properties": {
        "mood": {
            "type": "string"
        },
        "tone": {
            "type": "string",
            "description": "funny, heartwarming, epic, emotional, absurd, dark, inspiring…"
        },
        "brand": {
            "type": "string",
            "description": "Advertiser, e.g. \"Nike\", \"Guinness\""
        },
        "clips": {
            "type": "boolean",
            "description": "true = also return a short clip of each shot (1 credit per clip on top of the call). Ask only when the user wants to see the shots move."
        },
        "limit": {
            "type": "number",
            "maximum": 30,
            "minimum": 1
        },
        "people": {
            "type": "string",
            "description": "women, men, kids, teens, adults, seniors (comma-separated = all of them)"
        },
        "awarded": {
            "type": "boolean",
            "description": "true = won or shortlisted at an award show"
        },
        "setting": {
            "type": "string",
            "description": "interior, exterior, studio_void or virtual_cg"
        },
        "industry": {
            "type": "string",
            "description": "Ad category: Auto, Beer, Spirits, Drinks, Food & QSR, Retail, Tech, Telecom, Finance & Insurance, Fashion & Luxury, Beauty & Personal care, Sport, Travel, Gaming, Health & Pharma, Media & Entertainment, Public service & NGO, Home, FMCG"
        },
        "lighting": {
            "type": "string",
            "description": "natural, high_key, low_key, silhouette, chiaroscuro"
        },
        "shot_ids": {
            "type": "array",
            "items": {
                "type": "string"
            },
            "maxItems": 10,
            "minItems": 1
        },
        "year_max": {
            "type": "number"
        },
        "year_min": {
            "type": "number"
        },
        "min_award": {
            "enum": [
                "grand_prix",
                "gold",
                "silver",
                "bronze",
                "shortlist"
            ],
            "type": "string",
            "description": "Best award at least this level"
        },
        "shot_size": {
            "type": "string",
            "description": "extreme_closeup, closeup, medium_closeup, medium, medium_wide, full, wide, extreme_wide, insert"
        },
        "time_of_day": {
            "type": "string",
            "description": "day, night, golden_hour, dusk, dawn…"
        },
        "camera_angle": {
            "type": "string",
            "description": "eye_level, low_angle, high_angle, overhead, aerial, pov, worms_eye, dutch"
        },
        "logo_visible": {
            "type": "boolean"
        },
        "text_on_screen": {
            "type": "boolean"
        },
        "black_and_white": {
            "type": "boolean"
        },
        "product_visible": {
            "type": "boolean"
        }
    }
}

commercials_profile

The track record of a brand, director, agency, production company, DP, editor or composer in FrameThrower's ads library: how many spots, which years, who they work with (clients, agencies, directors, production companies), awards by show, typical tones and genres, their best and most recent work — and, for directors / agencies / production companies with a public page, the researched profile (description, founded, HQ, website).

Показать схему аргументов
{
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
        "kind",
        "name"
    ],
    "properties": {
        "kind": {
            "enum": [
                "brand",
                "director",
                "agency",
                "production",
                "dp",
                "editor",
                "edit_house",
                "post",
                "music",
                "sound",
                "vfx"
            ],
            "type": "string",
            "description": "brand, director, agency, production, dp, editor, edit_house, post, music, sound or vfx"
        },
        "name": {
            "type": "string"
        }
    }
}

commercials_stats

Count and rank the ads library: how many commercials match a filter, broken down by any of brand, director, agency, production, dp, editor, music, industry, market, year, genre, structure, format, tone, trope, award show, season. E.g. "which agencies won the most Cannes Lions for car ads since 2015" = fields [agency], award show Cannes Lions, industry Auto, year min 2015.

Показать схему аргументов
{
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
        "fields"
    ],
    "properties": {
        "dp": {
            "type": "string",
            "description": "Director of photography"
        },
        "tone": {
            "type": "string",
            "description": "funny, heartwarming, epic, emotional, absurd, dark, inspiring…"
        },
        "brand": {
            "type": "string",
            "description": "Advertiser, e.g. \"Nike\", \"Guinness\""
        },
        "genre": {
            "type": "string",
            "description": "comedy, drama, documentary, action…"
        },
        "limit": {
            "type": "number",
            "maximum": 50,
            "minimum": 1
        },
        "music": {
            "type": "string",
            "description": "Composer / track / music house"
        },
        "agency": {
            "type": "string",
            "description": "Creative agency, e.g. \"Wieden+Kennedy\""
        },
        "editor": {
            "type": "string"
        },
        "fields": {
            "type": "array",
            "items": {
                "enum": [
                    "brand",
                    "director",
                    "agency",
                    "production",
                    "dp",
                    "editor",
                    "edit_house",
                    "post",
                    "music",
                    "sound",
                    "vfx",
                    "industry",
                    "market",
                    "language",
                    "year",
                    "genre",
                    "structure",
                    "format",
                    "tone",
                    "trope",
                    "award_show",
                    "award_year",
                    "season",
                    "collection"
                ],
                "type": "string"
            },
            "maxItems": 6,
            "minItems": 1
        },
        "format": {
            "type": "string",
            "description": "live_action, animation_2d, animation_3d, stop_motion, cgi, mixed"
        },
        "market": {
            "type": "string",
            "description": "Country code: US, UK, FR, DE, BR, JP…"
        },
        "person": {
            "type": "string",
            "description": "Anyone credited, any role"
        },
        "season": {
            "type": "string",
            "description": "halloween, christmas, black friday, thanksgiving, new year, valentines, easter, mothers day, fathers day, back to school, summer, spring, pride, super bowl"
        },
        "awarded": {
            "type": "boolean",
            "description": "true = won or shortlisted at an award show"
        },
        "director": {
            "type": "string"
        },
        "industry": {
            "type": "string",
            "description": "Ad category: Auto, Beer, Spirits, Drinks, Food & QSR, Retail, Tech, Telecom, Finance & Insurance, Fashion & Luxury, Beauty & Personal care, Sport, Travel, Gaming, Health & Pharma, Media & Entertainment, Public service & NGO, Home, FMCG"
        },
        "year_max": {
            "type": "number"
        },
        "year_min": {
            "type": "number"
        },
        "celebrity": {
            "type": "boolean"
        },
        "min_award": {
            "enum": [
                "grand_prix",
                "gold",
                "silver",
                "bronze",
                "shortlist"
            ],
            "type": "string",
            "description": "Best award at least this level"
        },
        "structure": {
            "type": "string",
            "description": "narrative, montage, vignettes, problem_solution, demo…"
        },
        "award_show": {
            "type": "string",
            "description": "One of: Cannes Lions, Clio Awards, D&AD, Epica, AICP Awards, London International Awards, British Arrows, The One Show, El Ojo de Iberoamérica, Eurobest, Creative Circle, Effie Awards, Ciclope, Spikes Asia, ANDY Awards, ADC Awards, DGA Awards, Kinsale Sharks, shots Awards, New York Festivals, Webby Awards, Emmy (Outstanding Commercial), IPA Effectiveness Awards, AdFest, Dubai Lynx, ADC Europe, Young Director Award"
        },
        "award_year": {
            "type": "number"
        },
        "production": {
            "type": "string",
            "description": "Production company, e.g. \"MJZ\", \"Smuggler\""
        },
        "max_duration": {
            "type": "number",
            "description": "seconds"
        },
        "min_duration": {
            "type": "number"
        }
    }
}

search_animation_frames

Find frames in FrameThrower's ANIMATION library — animated series and films only, never live-action (mostly anime, plus Western animation; the whole of every title, not a sample) for a scene, a moment or a CHARACTER LOOK, described in plain words: "a girl on a rooftop at dusk watching the city lights", "two kids running through a summer field", "a tall man with a scarred face and a long black coat, rain". Narrow by title, genre, theme, style (80s cel, watercolour, neon night…), studio, movie/series and year. Each frame has a caption of what is in it, a 640px still for looking at, the full-size

Показать схему аргументов
{
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
        "query"
    ],
    "properties": {
        "kind": {
            "enum": [
                "movie",
                "series"
            ],
            "type": "string"
        },
        "nsfw": {
            "type": "boolean",
            "description": "false = leave out frames flagged as adult (included by default)"
        },
        "clips": {
            "type": "boolean",
            "description": "true = also return each frame's clip and sequence videos (1 credit per video on top of the call). Ask only when the user wants to see it move."
        },
        "genre": {
            "type": "string",
            "description": "AniList genre: Action, Adventure, Comedy, Drama, Fantasy, Horror, Mecha, Mystery, Psychological, Romance, Sci-Fi, Slice of Life, Sports, Supernatural, Thriller… (several, comma-separated = all)"
        },
        "limit": {
            "type": "number",
            "maximum": 24,
            "minimum": 1,
            "description": "default 12"
        },
        "query": {
            "type": "string",
            "description": "The scene or character in plain words, as a description of one frame"
        },
        "style": {
            "type": "string",
            "description": "The title's look, read off its frames (several, comma-separated = all): hand-drawn cel, digital 2D, 3D CGI, cel-shaded 3D, stop motion, mixed 2D/3D, 70s look, 80s look, 90s look, 2000s look, modern look, pastel, muted, vivid, dark, warm, cool, monochrome, clean lines, thick outlines, sketchy lines, painterly, watercolour, flat minimal, detailed backgrounds, film grain, realistic proportions, moe big-eyed, chibi, western cartoon, gritty mature, bishonen, soft natural light, dramatic light rays, glow and bloom, neon, high-contrast shadows"
        },
        "theme": {
            "type": "string",
            "description": "AniList theme tag: Cyberpunk, Post-Apocalyptic, Iyashikei, Coming of Age, Time Travel, Magic, Space, Urban Fantasy…"
        },
        "title": {
            "type": "string",
            "description": "Only inside this series / film (slug or name)"
        },
        "offset": {
            "type": "number",
            "maximum": 200,
            "minimum": 0
        },
        "studio": {
            "type": "string",
            "description": "Animation studio, e.g. \"Studio Ghibli\", \"Madhouse\", \"Kyoto Animation\", \"MAPPA\""
        },
        "year_max": {
            "type": "number"
        },
        "year_min": {
            "type": "number"
        },
        "per_title": {
            "type": "number",
            "maximum": 24,
            "minimum": 1,
            "description": "Max frames from one title (default 3)"
        },
        "exclude_titles": {
            "type": "array",
            "items": {
                "type": "string"
            },
            "description": "Slugs to leave out (e.g. titles already used)"
        }
    }
}

similar_animation_frames

More ANIMATION frames (animation library only) like ones the user already has — frame ids from earlier results ("more like 2"), or ANY IMAGE: a generated frame on their canvas, an upload, a sketch (pass an http(s) URL or a data: URL, e.g. data:image/png;base64,… for a local file). by = look (composition, drawing and rendering — the default), colour (the palette) or content (what is in it). Same filters as search animation frames; other titles: true keeps it to titles other than the seed frames'.

Показать схему аргументов
{
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "properties": {
        "by": {
            "enum": [
                "look",
                "colour",
                "content"
            ],
            "type": "string"
        },
        "kind": {
            "enum": [
                "movie",
                "series"
            ],
            "type": "string"
        },
        "nsfw": {
            "type": "boolean",
            "description": "false = leave out frames flagged as adult (included by default)"
        },
        "clips": {
            "type": "boolean",
            "description": "true = also return each frame's clip and sequence videos (1 credit per video on top of the call). Ask only when the user wants to see it move."
        },
        "genre": {
            "type": "string",
            "description": "AniList genre: Action, Adventure, Comedy, Drama, Fantasy, Horror, Mecha, Mystery, Psychological, Romance, Sci-Fi, Slice of Life, Sports, Supernatural, Thriller… (several, comma-separated = all)"
        },
        "image": {
            "type": "string",
            "description": "An image URL or data: URL — any image, ours or not"
        },
        "limit": {
            "type": "number",
            "maximum": 24,
            "minimum": 1
        },
        "style": {
            "type": "string",
            "description": "The title's look, read off its frames (several, comma-separated = all): hand-drawn cel, digital 2D, 3D CGI, cel-shaded 3D, stop motion, mixed 2D/3D, 70s look, 80s look, 90s look, 2000s look, modern look, pastel, muted, vivid, dark, warm, cool, monochrome, clean lines, thick outlines, sketchy lines, painterly, watercolour, flat minimal, detailed backgrounds, film grain, realistic proportions, moe big-eyed, chibi, western cartoon, gritty mature, bishonen, soft natural light, dramatic light rays, glow and bloom, neon, high-contrast shadows"
        },
        "theme": {
            "type": "string",
            "description": "AniList theme tag: Cyberpunk, Post-Apocalyptic, Iyashikei, Coming of Age, Time Travel, Magic, Space, Urban Fantasy…"
        },
        "title": {
            "type": "string",
            "description": "Only inside this series / film (slug or name)"
        },
        "studio": {
            "type": "string",
            "description": "Animation studio, e.g. \"Studio Ghibli\", \"Madhouse\", \"Kyoto Animation\", \"MAPPA\""
        },
        "year_max": {
            "type": "number"
        },
        "year_min": {
            "type": "number"
        },
        "frame_ids": {
            "type": "array",
            "items": {
                "type": "string"
            },
            "maxItems": 10,
            "description": "Frame ids from earlier results (or \"slug:label\")"
        },
        "per_title": {
            "type": "number",
            "maximum": 24,
            "minimum": 1
        },
        "other_titles": {
            "type": "boolean"
        },
        "exclude_titles": {
            "type": "array",
            "items": {
                "type": "string"
            },
            "description": "Slugs to leave out (e.g. titles already used)"
        }
    }
}

find_animation_titles

Find animated SERIES and FILMS (animation library only — mostly anime, plus Western animation) that fit what the user is making — by a story brief in plain words ("a quiet coming-of-age story about two sisters in a seaside town, bittersweet, summer"), by a title it should be like (like: "Akira"), by a LOOK (an image or frame ids — titles whose frames look like it), and/or by genre, theme, style, studio, movie/series and year. Signals combine. Returns each title with studio, director, genres, themes, its look, a synopsis, a poster, and for a look search the frames that matched.

Показать схему аргументов
{
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "properties": {
        "kind": {
            "enum": [
                "movie",
                "series"
            ],
            "type": "string"
        },
        "like": {
            "type": "string",
            "description": "A title (name or slug) the results should be like in story"
        },
        "nsfw": {
            "type": "boolean",
            "description": "false = leave out frames flagged as adult (included by default)"
        },
        "brief": {
            "type": "string",
            "description": "The story, premise, mood or world in plain words"
        },
        "genre": {
            "type": "string",
            "description": "AniList genre: Action, Adventure, Comedy, Drama, Fantasy, Horror, Mecha, Mystery, Psychological, Romance, Sci-Fi, Slice of Life, Sports, Supernatural, Thriller… (several, comma-separated = all)"
        },
        "image": {
            "type": "string",
            "description": "An image URL or data: URL — titles that look like it"
        },
        "limit": {
            "type": "number",
            "maximum": 20,
            "minimum": 1,
            "description": "default 8"
        },
        "style": {
            "type": "string",
            "description": "The title's look, read off its frames (several, comma-separated = all): hand-drawn cel, digital 2D, 3D CGI, cel-shaded 3D, stop motion, mixed 2D/3D, 70s look, 80s look, 90s look, 2000s look, modern look, pastel, muted, vivid, dark, warm, cool, monochrome, clean lines, thick outlines, sketchy lines, painterly, watercolour, flat minimal, detailed backgrounds, film grain, realistic proportions, moe big-eyed, chibi, western cartoon, gritty mature, bishonen, soft natural light, dramatic light rays, glow and bloom, neon, high-contrast shadows"
        },
        "theme": {
            "type": "string",
            "description": "AniList theme tag: Cyberpunk, Post-Apocalyptic, Iyashikei, Coming of Age, Time Travel, Magic, Space, Urban Fantasy…"
        },
        "title": {
            "type": "string",
            "description": "Only inside this series / film (slug or name)"
        },
        "studio": {
            "type": "string",
            "description": "Animation studio, e.g. \"Studio Ghibli\", \"Madhouse\", \"Kyoto Animation\", \"MAPPA\""
        },
        "year_max": {
            "type": "number"
        },
        "year_min": {
            "type": "number"
        },
        "frame_ids": {
            "type": "array",
            "items": {
                "type": "string"
            },
            "maxItems": 10
        },
        "exclude_titles": {
            "type": "array",
            "items": {
                "type": "string"
            },
            "description": "Slugs to leave out (e.g. titles already used)"
        }
    }
}

get_animation_title

One anime series or film in depth, by slug or name: synopsis, studio and key credits, main characters, genres, themes, its look, the trailer, how many shots are indexed, titles with a similar look and a similar story, and sample frames spread across it (frames: 0–24, default 6).

Показать схему аргументов
{
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
        "title"
    ],
    "properties": {
        "clips": {
            "type": "boolean",
            "description": "true = also return each frame's clip and sequence videos (1 credit per video on top of the call). Ask only when the user wants to see it move."
        },
        "title": {
            "type": "string",
            "description": "Slug or name, e.g. \"akira-1988\" or \"Your Name\""
        },
        "frames": {
            "type": "number",
            "maximum": 24,
            "minimum": 0
        }
    }
}

get_animation_sequence

A frame in its sequence: the shots just before and after it in the same episode / film, in order, each with its still and caption — to see how a moment is built, or to lay a beat out across several canvas panels. With clips: true, each shot's clip plus the continuous "run" video that covers them (run url, with from/to seconds).

Показать схему аргументов
{
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
        "frame_id"
    ],
    "properties": {
        "after": {
            "type": "number",
            "maximum": 8,
            "minimum": 0,
            "description": "default 2"
        },
        "clips": {
            "type": "boolean",
            "description": "true = also return each frame's clip and sequence videos (1 credit per video on top of the call). Ask only when the user wants to see it move."
        },
        "before": {
            "type": "number",
            "maximum": 8,
            "minimum": 0,
            "description": "default 2"
        },
        "frame_id": {
            "type": "string",
            "description": "A frame id from earlier results (or \"slug:label\")"
        }
    }
}