Compose a design
compose_designBuild a label design and return a URL the user opens to finish it. Designing and previewing are free; exporting a print-ready file requires a membership, so present the URL as a starting point the user completes in their browser. Fields listed in the response as "unsupported" were NOT applied — tell the user rather than reporting them as done. The user's own artwork goes in through images (upload it first with upload_image; needs an API key): images.background covers the whole sheet, images.panels.<key> one panel each (keys from describe_format), images.logo a custom studio logo. decals places catalog stickers / shapes / retro marks (ids from list_decals) or the user's uploads anywhere on the sheet, texts adds free text blocks, style.productionLogos picks the studio marks (style.productionLogoColorize: 'off' keeps their own colours), and layout.hide: ["poster"] clears the cover art — enough to rebuild a specific vintage cover. Without a key, compose from format + content and tell the user to drag images in after opening the URL.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"format": "<format>"
},
"name": "compose_design"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| obi | No | obi-strip only: the case the strip wraps (default vhs for movie/tv, game for game, 12" vinyl for an album) and the language its fields are filled in (default ja, as a real obi is printed). | |
| text | No | Overrides for the fetched metadata (video formats and obi-strip; on audio formats these come back as unsupported). Omit a field to keep the provider value. | |
| style | No | ||
| texts | No | 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 | No | 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 | Yes | Which packaging format | |
| images | No | 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 }. | |
| layout | No | ||
| content | No | What the design is of. Provide a query, or an id from search_content. Video formats take movie/tv/game; audio formats (cassette, jcard, cd*, vinyl*, minidisc*) take album; obi-strip takes any of them. For audio, the album alone builds the complete design — cover art, tracklist sides, QR code — and style.font / labelColor / background restyle it. |