Tapercraft — VHS Label Maker

{'type': 'object', 'required': ['format'], 'properties': {'text': {'type': 'object', 'properties': {'year': {'type': 'string'}, 'title': {'type': 'string'}, 'budget': {'type': 'string'}, 'origin': {'type': 'string'}, 'rating': {'type': 'string'}, 'revenue': {'type': 'string'}, 'runtime': {'type': 'string'}, 'tagline': {'type': 'string'}, 'texsOrg': {'type': 'string'}, 'writers': {'type': 'string'}, 'composer': {'type': 'string'}, 'director': {'type': 'string'}, 'overview': {'type': 'string'}, 'producer': {'type': 'string'}, 'starring': {'type': 'string'}, 'seasonEpisode': {'type': 'string'}}, 'description': 'Overrides for the fetched metadata (video formats only — on audio formats these come back as unsupported). Omit a field to keep the provider value.', 'additionalProperties': False}, 'style': {'type': 'object', 'properties': {'font': {'type': 'string', 'description': 'Font family for the whole design (on audio formats, every text section). Curated: Futura, Arial, Times New Roman, Impact, Courier New, Roboto Flex, Bebas Neue, League Gothic, Sofia Sans Extra Condensed, Nunito Sans, Stint Ultra Condensed, EB Garamond…'}, 'finish': {'enum': ['worn', 'clean', 'plain'], 'type': 'string', 'description': "'worn' (default) fills the back panel with the title's stills and adds a worn-paper texture; 'clean' is stills without the texture; 'plain' skips both. Video formats and jcard only (on jcard 'worn' is the texture alone); other audio formats report it as unsupported."}, 'useLogo': {'type': 'boolean', 'description': "true paints the provider's logo artwork for the title; false renders your title as text. Defaults to false when you set text.title, so a title you set is visible."}, 'background': {'type': 'object', 'properties': {'color': {'type': 'string', 'description': '6-digit hex'}}, 'additionalProperties': False}, 'labelColor': {'type': 'string', 'description': 'Label / text color, 6-digit hex, e.g. #e8dcc0'}, 'productionLogos': {'type': 'array', 'items': {'type': 'string'}, 'maxItems': 4, 'description': 'Video formats: Classic Logo ids (list_decals → classicLogos, e.g. "rcacolumbia!") for the spine and studio slot, in order (#1 is the spine). As the whole selection they REPLACE the title\'s own studio logos; [] removes the studio slot.'}}, 'additionalProperties': False}, 'texts': {'type': 'array', 'items': {'type': 'object', 'required': ['text'], 'properties': {'x': {'type': 'number', 'maximum': 100, 'minimum': 0}, 'y': {'type': 'number', 'maximum': 100, 'minimum': 0}, 'font': {'type': 'string', 'description': 'Family name — a curated family or any Google font'}, 'side': {'enum': ['front', 'back'], 'type': 'string'}, 'size': {'type': 'number', 'maximum': 60, 'minimum': 0.5, 'description': 'Font size, percent of the sheet height (default 9)'}, 'text': {'type': 'string', 'description': 'The text; newlines allowed'}, 'align': {'enum': ['left', 'center', 'right'], 'type': 'string'}, 'color': {'type': 'string', 'description': '6-digit hex (default: the label colour)'}, 'width': {'type': 'integer', 'maximum': 100, 'minimum': 10, 'description': 'Percent of the sheet width (default 50)'}, 'italic': {'type': 'boolean'}, 'weight': {'type': 'integer', 'maximum': 900, 'minimum': 100}, 'allCaps': {'type': 'boolean'}, 'rotation': {'type': 'integer', 'maximum': 360, 'minimum': -360}, 'lineHeight': {'type': 'number', 'maximum': 4, 'minimum': 0.5}, 'letterSpacing': {'type': 'number', 'maximum': 50, 'minimum': -20, 'description': 'px'}}, 'additionalProperties': False}, 'maxItems': 24, 'description': "Free text blocks placed on the label (the designer's Text tab). x/y are the block's center in percent of the sheet; width is the percent of the sheet width the block spans (text wraps); size is the font size as percent of the sheet height."}, 'decals': {'type': 'array', 'items': {'type': 'object', 'properties': {'x': {'type': 'number', 'maximum': 100, 'minimum': 0, 'description': 'Center, percent of the sheet width (default 50)'}, 'y': {'type': 'number', 'maximum': 100, 'minimum': 0, 'description': 'Center, percent of the sheet height (default 50)'}, 'id': {'type': 'string', 'description': 'A decal id from list_decals (e.g. "rcacolumbia!", "04-rounded-rectangle")'}, 'ref': {'type': 'string', 'pattern': '^upload:', 'description': 'An upload ref, instead of id'}, 'side': {'enum': ['front', 'back'], 'type': 'string', 'description': 'Two-sided formats only'}, 'color': {'type': 'string', 'description': '6-digit hex for colorize (default: the label colour)'}, 'layer': {'enum': ['over', 'under', 'background'], 'type': 'string', 'description': "'over' (default), 'under' the label's text and pictures, or 'background'"}, 'scale': {'type': 'integer', 'maximum': 900, 'minimum': 10, 'description': "The designer's size unit (100 = natural width ÷ 4 layout units); use instead of width"}, 'width': {'type': 'number', 'maximum': 200, 'minimum': 1, 'description': 'Rendered width as percent of the sheet width (formats with placement.decals.layoutWidthUnits)'}, 'stretch': {'type': 'integer', 'maximum': 1000, 'minimum': 10, 'description': 'Horizontal stretch, percent of the natural aspect'}, 'colorize': {'enum': ['tint', 'solid'], 'type': 'string', 'description': "Paint the decal one colour: 'tint' keeps its shading, 'solid' flattens it"}, 'rotation': {'type': 'integer', 'maximum': 360, 'minimum': -360}}, 'additionalProperties': False}, 'maxItems': 24, 'description': "Stickers, graphics, shapes and the user's own images placed on the label. Each entry names a catalog decal by id (list_decals) OR an upload by ref (upload_image; needs the API key). x/y are percent of the sheet (center-anchored; see describe_format → placement for the coordinate space and the size units). Size with `width` (percent of the sheet width) where describe_format accepts it, else `scale`."}, 'format': {'enum': ['slipcover', 'side-load-vhs', 'doublevhs', 'betamax', 'compact-tape', 'bluray-cover', 'bluray-slipcover', 'dvd-cover', 'steelcase', 'clamshell', 'polycase', 'cardbox', 'disc', 'cassette', 'cassingle', 'jcard', 'cd', 'cd-tray', 'cd-insert', 'vinyl-label', 'vinyl-jacket', 'vinyl-sleeve', 'minidisc-label', 'minidisc-full-labels', 'minidisc-jcard', 'minidisc-cover', 'minidisc-tray'], 'type': 'string', 'description': 'Which packaging format'}, 'images': {'type': 'object', 'properties': {'logo': {'type': 'string', 'pattern': '^upload:', 'description': "A custom studio / production logo (video formats). It replaces the title's own studio logos on the spine and back panel. Upload a transparent PNG."}, 'panels': {'type': 'object', 'description': 'Per-panel images keyed by the panel key describe_format reports (e.g. front, back, spine1). Unknown keys come back as unsupported.', 'additionalProperties': {'oneOf': [{'type': 'string', 'pattern': '^upload:'}, {'type': 'object', 'required': ['ref'], 'properties': {'fit': {'enum': ['fit', 'fill', 'stretch'], 'type': 'string'}, 'ref': {'type': 'string'}, 'opacity': {'type': 'number', 'maximum': 100, 'minimum': 0}}, 'additionalProperties': False}]}}, 'background': {'oneOf': [{'type': 'string', 'pattern': '^upload:'}, {'type': 'object', 'required': ['ref'], 'properties': {'fit': {'enum': ['fit', 'fill', 'stretch'], 'type': 'string'}, 'ref': {'type': 'string'}, 'opacity': {'type': 'number', 'maximum': 100, 'minimum': 0}}, 'additionalProperties': False}], 'description': 'One image over the whole sheet (all panels).'}}, 'description': "The user's own artwork by upload ref (from upload_image). Needs the API key that owns the uploads. Single-surface formats only (describe_format → singleSurface). Each value is a ref string or { ref, fit, opacity }.", 'additionalProperties': False}, 'layout': {'type': 'object', 'properties': {'hide': {'type': 'array', 'items': {'enum': ['poster', 'rating', 'texsOrg', 'overview', 'labelOverview', 'fbiWarning', 'rules', 'pullquote', 'pullquoteCredit', 'spineMeta', 'barcode', 'qrCode', 'spineLogo', 'title', 'tagline', 'year', 'origin', 'runtime', 'starring', 'director', 'budget', 'revenue', 'movieId', 'seasonEpisode', 'writers', 'composer', 'producer', 'productionLogos'], 'type': 'string'}, 'description': "Fields to hide on the design (video formats). 'poster' removes the cover art so a panel image or decal can carry the front."}, 'spine2': {'type': 'object', 'required': ['title'], 'properties': {'title': {'enum': ['text', 'logo'], 'type': 'string', 'description': "Turns on Dual Spine and gives the second spine its own title: 'text' prints the title as text there, 'logo' paints the provider's wordmark. The first spine keeps style.useLogo / text.title. Formats with a second spine only (slipcover, doublevhs, betamax, compact-tape, bluray-slipcover, cardbox); elsewhere reported unsupported."}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'content': {'type': 'object', 'required': ['type'], 'properties': {'id': {'type': 'string', 'description': 'TMDB id (movie/tv) or iTunes collection id (album), if already known'}, 'type': {'enum': ['movie', 'tv', 'album'], 'type': 'string'}, 'query': {'type': 'string'}}, 'description': 'What the design is of. Provide a query, or an id from search_content. Video formats take movie/tv; audio formats (cassette, jcard, cd*, vinyl*, minidisc*) take album. For audio, the album alone builds the complete design — cover art, tracklist sides, QR code — and style.font / labelColor / background restyle it.', 'additionalProperties': False}}, 'additionalProperties': False}

{'type': 'object', 'required': ['designId'], 'properties': {'designId': {'type': 'string'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['uploadId'], 'properties': {'uploadId': {'type': 'string', 'description': 'The id (or upload:<id> ref) to remove'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['format'], 'properties': {'format': {'enum': ['slipcover', 'side-load-vhs', 'doublevhs', 'betamax', 'compact-tape', 'bluray-cover', 'bluray-slipcover', 'dvd-cover', 'steelcase', 'clamshell', 'polycase', 'cardbox', 'disc', 'cassette', 'cassingle', 'jcard', 'cd', 'cd-tray', 'cd-insert', 'vinyl-label', 'vinyl-jacket', 'vinyl-sleeve', 'minidisc-label', 'minidisc-full-labels', 'minidisc-jcard', 'minidisc-cover', 'minidisc-tray'], 'type': 'string', 'description': 'A slug from list_formats'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['designId'], 'properties': {'output': {'enum': ['png', 'pdf', 'preview'], 'type': 'string', 'description': "'preview' to see the design, 'png' (default) or 'pdf' for the print file"}, 'designId': {'type': 'string', 'description': 'From save_design or list_designs'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {}, 'additionalProperties': False}

{'type': 'object', 'required': ['type', 'id'], 'properties': {'id': {'type': 'string', 'description': 'TMDB id from search_content'}, 'type': {'enum': ['movie', 'tv'], 'type': 'string'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['designId'], 'properties': {'designId': {'type': 'string', 'description': 'From list_designs or save_design'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['jobId'], 'properties': {'jobId': {'type': 'string'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'query': {'type': 'string', 'description': 'Case-insensitive match on decal id / name'}, 'category': {'type': 'string', 'description': 'One category id (e.g. "priceTags", "oldDistributors", "shapes")'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Default 25'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {}, 'additionalProperties': False}

{'type': 'object', 'properties': {'limit': {'type': 'integer', 'maximum': 200, 'minimum': 1, 'description': 'Default 50'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['format'], 'properties': {'name': {'type': 'string', 'description': 'Design name shown on the dashboard (max 120 chars)'}, 'text': {'type': 'object', 'properties': {'year': {'type': 'string'}, 'title': {'type': 'string'}, 'budget': {'type': 'string'}, 'origin': {'type': 'string'}, 'rating': {'type': 'string'}, 'revenue': {'type': 'string'}, 'runtime': {'type': 'string'}, 'tagline': {'type': 'string'}, 'texsOrg': {'type': 'string'}, 'writers': {'type': 'string'}, 'composer': {'type': 'string'}, 'director': {'type': 'string'}, 'overview': {'type': 'string'}, 'producer': {'type': 'string'}, 'starring': {'type': 'string'}, 'seasonEpisode': {'type': 'string'}}, 'description': 'Overrides for the fetched metadata (video formats only — on audio formats these come back as unsupported). Omit a field to keep the provider value.', 'additionalProperties': False}, 'style': {'type': 'object', 'properties': {'font': {'type': 'string', 'description': 'Font family for the whole design (on audio formats, every text section). Curated: Futura, Arial, Times New Roman, Impact, Courier New, Roboto Flex, Bebas Neue, League Gothic, Sofia Sans Extra Condensed, Nunito Sans, Stint Ultra Condensed, EB Garamond…'}, 'finish': {'enum': ['worn', 'clean', 'plain'], 'type': 'string', 'description': "'worn' (default) fills the back panel with the title's stills and adds a worn-paper texture; 'clean' is stills without the texture; 'plain' skips both. Video formats and jcard only (on jcard 'worn' is the texture alone); other audio formats report it as unsupported."}, 'useLogo': {'type': 'boolean', 'description': "true paints the provider's logo artwork for the title; false renders your title as text. Defaults to false when you set text.title, so a title you set is visible."}, 'background': {'type': 'object', 'properties': {'color': {'type': 'string', 'description': '6-digit hex'}}, 'additionalProperties': False}, 'labelColor': {'type': 'string', 'description': 'Label / text color, 6-digit hex, e.g. #e8dcc0'}, 'productionLogos': {'type': 'array', 'items': {'type': 'string'}, 'maxItems': 4, 'description': 'Video formats: Classic Logo ids (list_decals → classicLogos, e.g. "rcacolumbia!") for the spine and studio slot, in order (#1 is the spine). As the whole selection they REPLACE the title\'s own studio logos; [] removes the studio slot.'}}, 'additionalProperties': False}, 'texts': {'type': 'array', 'items': {'type': 'object', 'required': ['text'], 'properties': {'x': {'type': 'number', 'maximum': 100, 'minimum': 0}, 'y': {'type': 'number', 'maximum': 100, 'minimum': 0}, 'font': {'type': 'string', 'description': 'Family name — a curated family or any Google font'}, 'side': {'enum': ['front', 'back'], 'type': 'string'}, 'size': {'type': 'number', 'maximum': 60, 'minimum': 0.5, 'description': 'Font size, percent of the sheet height (default 9)'}, 'text': {'type': 'string', 'description': 'The text; newlines allowed'}, 'align': {'enum': ['left', 'center', 'right'], 'type': 'string'}, 'color': {'type': 'string', 'description': '6-digit hex (default: the label colour)'}, 'width': {'type': 'integer', 'maximum': 100, 'minimum': 10, 'description': 'Percent of the sheet width (default 50)'}, 'italic': {'type': 'boolean'}, 'weight': {'type': 'integer', 'maximum': 900, 'minimum': 100}, 'allCaps': {'type': 'boolean'}, 'rotation': {'type': 'integer', 'maximum': 360, 'minimum': -360}, 'lineHeight': {'type': 'number', 'maximum': 4, 'minimum': 0.5}, 'letterSpacing': {'type': 'number', 'maximum': 50, 'minimum': -20, 'description': 'px'}}, 'additionalProperties': False}, 'maxItems': 24, 'description': "Free text blocks placed on the label (the designer's Text tab). x/y are the block's center in percent of the sheet; width is the percent of the sheet width the block spans (text wraps); size is the font size as percent of the sheet height."}, 'decals': {'type': 'array', 'items': {'type': 'object', 'properties': {'x': {'type': 'number', 'maximum': 100, 'minimum': 0, 'description': 'Center, percent of the sheet width (default 50)'}, 'y': {'type': 'number', 'maximum': 100, 'minimum': 0, 'description': 'Center, percent of the sheet height (default 50)'}, 'id': {'type': 'string', 'description': 'A decal id from list_decals (e.g. "rcacolumbia!", "04-rounded-rectangle")'}, 'ref': {'type': 'string', 'pattern': '^upload:', 'description': 'An upload ref, instead of id'}, 'side': {'enum': ['front', 'back'], 'type': 'string', 'description': 'Two-sided formats only'}, 'color': {'type': 'string', 'description': '6-digit hex for colorize (default: the label colour)'}, 'layer': {'enum': ['over', 'under', 'background'], 'type': 'string', 'description': "'over' (default), 'under' the label's text and pictures, or 'background'"}, 'scale': {'type': 'integer', 'maximum': 900, 'minimum': 10, 'description': "The designer's size unit (100 = natural width ÷ 4 layout units); use instead of width"}, 'width': {'type': 'number', 'maximum': 200, 'minimum': 1, 'description': 'Rendered width as percent of the sheet width (formats with placement.decals.layoutWidthUnits)'}, 'stretch': {'type': 'integer', 'maximum': 1000, 'minimum': 10, 'description': 'Horizontal stretch, percent of the natural aspect'}, 'colorize': {'enum': ['tint', 'solid'], 'type': 'string', 'description': "Paint the decal one colour: 'tint' keeps its shading, 'solid' flattens it"}, 'rotation': {'type': 'integer', 'maximum': 360, 'minimum': -360}}, 'additionalProperties': False}, 'maxItems': 24, 'description': "Stickers, graphics, shapes and the user's own images placed on the label. Each entry names a catalog decal by id (list_decals) OR an upload by ref (upload_image; needs the API key). x/y are percent of the sheet (center-anchored; see describe_format → placement for the coordinate space and the size units). Size with `width` (percent of the sheet width) where describe_format accepts it, else `scale`."}, 'format': {'enum': ['slipcover', 'side-load-vhs', 'doublevhs', 'betamax', 'compact-tape', 'bluray-cover', 'bluray-slipcover', 'dvd-cover', 'steelcase', 'clamshell', 'polycase', 'cardbox', 'disc', 'cassette', 'cassingle', 'jcard', 'cd', 'cd-tray', 'cd-insert', 'vinyl-label', 'vinyl-jacket', 'vinyl-sleeve', 'minidisc-label', 'minidisc-full-labels', 'minidisc-jcard', 'minidisc-cover', 'minidisc-tray'], 'type': 'string', 'description': 'Which packaging format'}, 'images': {'type': 'object', 'properties': {'logo': {'type': 'string', 'pattern': '^upload:', 'description': "A custom studio / production logo (video formats). It replaces the title's own studio logos on the spine and back panel. Upload a transparent PNG."}, 'panels': {'type': 'object', 'description': 'Per-panel images keyed by the panel key describe_format reports (e.g. front, back, spine1). Unknown keys come back as unsupported.', 'additionalProperties': {'oneOf': [{'type': 'string', 'pattern': '^upload:'}, {'type': 'object', 'required': ['ref'], 'properties': {'fit': {'enum': ['fit', 'fill', 'stretch'], 'type': 'string'}, 'ref': {'type': 'string'}, 'opacity': {'type': 'number', 'maximum': 100, 'minimum': 0}}, 'additionalProperties': False}]}}, 'background': {'oneOf': [{'type': 'string', 'pattern': '^upload:'}, {'type': 'object', 'required': ['ref'], 'properties': {'fit': {'enum': ['fit', 'fill', 'stretch'], 'type': 'string'}, 'ref': {'type': 'string'}, 'opacity': {'type': 'number', 'maximum': 100, 'minimum': 0}}, 'additionalProperties': False}], 'description': 'One image over the whole sheet (all panels).'}}, 'description': "The user's own artwork by upload ref (from upload_image). Needs the API key that owns the uploads. Single-surface formats only (describe_format → singleSurface). Each value is a ref string or { ref, fit, opacity }.", 'additionalProperties': False}, 'layout': {'type': 'object', 'properties': {'hide': {'type': 'array', 'items': {'enum': ['poster', 'rating', 'texsOrg', 'overview', 'labelOverview', 'fbiWarning', 'rules', 'pullquote', 'pullquoteCredit', 'spineMeta', 'barcode', 'qrCode', 'spineLogo', 'title', 'tagline', 'year', 'origin', 'runtime', 'starring', 'director', 'budget', 'revenue', 'movieId', 'seasonEpisode', 'writers', 'composer', 'producer', 'productionLogos'], 'type': 'string'}, 'description': "Fields to hide on the design (video formats). 'poster' removes the cover art so a panel image or decal can carry the front."}, 'spine2': {'type': 'object', 'required': ['title'], 'properties': {'title': {'enum': ['text', 'logo'], 'type': 'string', 'description': "Turns on Dual Spine and gives the second spine its own title: 'text' prints the title as text there, 'logo' paints the provider's wordmark. The first spine keeps style.useLogo / text.title. Formats with a second spine only (slipcover, doublevhs, betamax, compact-tape, bluray-slipcover, cardbox); elsewhere reported unsupported."}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'content': {'type': 'object', 'required': ['type'], 'properties': {'id': {'type': 'string', 'description': 'TMDB id (movie/tv) or iTunes collection id (album), if already known'}, 'type': {'enum': ['movie', 'tv', 'album'], 'type': 'string'}, 'query': {'type': 'string'}}, 'description': 'What the design is of. Provide a query, or an id from search_content. Video formats take movie/tv; audio formats (cassette, jcard, cd*, vinyl*, minidisc*) take album. For audio, the album alone builds the complete design — cover art, tracklist sides, QR code — and style.font / labelColor / background restyle it.', 'additionalProperties': False}}, 'additionalProperties': False}

{'type': 'object', 'required': ['type', 'query'], 'properties': {'type': {'enum': ['movie', 'tv', 'album'], 'type': 'string', 'description': 'movie, tv, or album'}, 'query': {'type': 'string', 'description': 'Title to search for, e.g. "Predator 1987" or "Michael Jackson Thriller"'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['data', 'mimeType'], 'properties': {'data': {'type': 'string', 'description': 'Base64 of the image bytes (no data: prefix needed; one is tolerated)'}, 'name': {'type': 'string', 'description': 'A filename or label shown in the library, e.g. "predator-front.png"'}, 'mimeType': {'enum': ['image/jpeg', 'image/jpg', 'image/png', 'image/webp', 'image/gif', 'image/avif', 'image/heic', 'image/heif', 'image/bmp', 'image/tiff'], 'type': 'string', 'description': 'e.g. image/png'}}, 'additionalProperties': False}