Creative Studio

Delete the user's images. version_ids: up to 100 ids in one call, each from a tool result (creative_library items' versionId, or an image card). all=true: every image in their library (with use_case_id: only that format), for "delete all my images". One call shows one confirmation card listing the images; nothing is deleted until its Delete button. Pass confirm only in a client without cards, after the user says yes.

creative_library_delete

Use this when the user wants to change part of an image (text, colors, an object) and keep the rest. Edits (keeps the frame; no brand kit) one of the user's images — by its code (image_code, e.g. CARD-13: pass the code the user typed verbatim; never guess a version_id), or by version_id — or ONE photo they attached (images) or linked (image_urls). instruction = their words about the change, verbatim. Without confirm it only returns a confirm card (nothing is drawn); the card's button confirms. A changed request = call again with the new words. For a fresh redraw (new content or a new ratio) use creative_regenerate.

creative_edit

Card-only copy of creative_edit (the card can't call tools that take files). Never call it yourself — use creative_edit.

creative_edit__app

Use this when the user wants to set up a brand kit, or sends their website for one. Drafts a brand kit from the user's website (name, colors, logos, product images) — or, with manual, an empty draft to fill by hand. Nothing is saved: the user reviews and edits the draft on the card, then saves. If the site is slow (>12 s), blocked or unreadable, it opens a manual draft with the reason. Pass from_job_id = the questions card's asksJobId when the user is in the middle of creating an image.

creative_brand_extract

List the image formats (use cases such as hiring poster, promo banner, product shot) grouped by Office / Marketing / E-commerce, plus the visual styles, with their ids. Use when the user asks which formats or styles exist, or to see the list, or before creative_templates when you need a use_case_id or style id. Not for the user's own images: creative_library gives the formats they have. For what Creative Studio is or how to start, use creative_help.

creative_catalog

Progress / result of images being created, by job_ids from an earlier result; without job_ids, the images being created right now. Cards follow their own jobs — call only when the user asks.

creative_job_status

The user's created images, newest first, optionally filtered by format (use_case_id), with how many images each format has. Paged. Use when the user asks to see their images, recent designs or images of one kind.

creative_library

One of the user's images by its code (image_code, e.g. CARD-13) or version_id: the image, its other versions in the same project, and a download link for the original. Use only when the user names an image code or asks to see, compare or download an existing image. A request to make an image (make, create, design), in any language, is creative_clarify, even if a similar image already exists in this chat.

creative_image

Link to a Creative Studio web screen for things done on the web: home (create an image, pick a format or template), gallery (all images, edit, delete, download), brand (create or edit brand kits), image (open one image in the editor; needs version_id).

creative_open_web

Use this when the user wants a finished image redrawn, with or without changes: redraws one of the user's Creative Studio images from its saved setup (format, answers, template, brand kit, ratio) as new versions of it — not a photo they attached. A change that keeps the rest (replace a title, remove text, recolor one object) is creative_edit. The image by its code (image_code, e.g. CARD-13, verbatim) or version_id; changes = their words, verbatim (optional); ratio overrides the saved one. The first call returns a confirmation card; the redraw starts once the user confirms it.

creative_regenerate

Create a brand kit or change one (name, website, colors, default). From a draft card: draft_id plus the user's edits (name, full colors list with roles, logo_indexes / asset_indexes of the draft images kept, is_default); save=false = use for this image only (not saved; create tools then take brand "draft"). Max 5 kits. On an existing kit (kit_id) only what you pass changes.

creative_brand_save

Make one brand kit the default for new images (the previous default stops being default). Identify it by kit_id or name.

creative_brand_default

Use this when the user picked templates on a templates card and wants images from them (the card's Create buttons call it themselves); without picked templates use creative_clarify. Pass template_ids (up to 4, incl. own:… ids) and the first one's use_case_id, the user's words verbatim (description), every image they attached (images) or pasted as a link (image_urls), brand, ratio whenever they name a ratio, size or orientation, and count when they say how many images. Shows a questions card (missing photos or text become questions); when nothing is unclear it just waits for Create. asks_job_id is only for the card.

creative_asks

Card-only copy of creative_asks (the card can't call tools that take files). Never call it yourself — use creative_asks.

creative_asks__app

Use this when the user asks to make a new marketing, office or e-commerce image from a description and/or photos (templates picked on a card go to creative_asks instead). Several images with different content ("one post about A, one about B") = ONE call: whole request as description, count = number of images. Not for text only (captions, post copy), video, general art or illustrations, questions about Creative Studio, or finding their images or templates. Pass their words verbatim (description), photos (images), pasted links (image_urls), a named format (use_case_id), brand, and ratio whenever they name a ratio, size or orientation.

creative_clarify

Card-only copy of creative_clarify (the card can't call tools that take files). Never call it yourself — use creative_clarify.

creative_clarify__app

The next step of an open creative_clarify round — not a way to search templates: when the user asks to see or look for templates themselves, use creative_templates. Pass the questions card's suggest values unchanged plus the user's answers keyed by question label. The service picks keywords, styles and colors and shows a templates card with a short reason; the user selects 1-4 templates (their own templates first) and presses Create, or creates without a template. pick_job_id is only for the card to fetch a pending result.

creative_suggest_templates