creative_add_template
ChatGPTMy templates: the user's own template images (attached = images, links = image_urls) for a templates card. For the suggested-templates card pass clarify_job_id = its pick clarifyJobId; for a browse templates card pass its use_case_id. Stores them and shows them on that card first and selected; the user then presses Create.
creative_add_template__app
ChatGPTCard-only copy of creative_add_template (the card can't call tools that take files). Never call it yourself — use creative_add_template.
creative_asks
ChatGPTUse 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__app
ChatGPTCard-only copy of creative_asks (the card can't call tools that take files). Never call it yourself — use creative_asks.
creative_brand
ChatGPTShow the user's saved brand kits on a card. Pass name to focus one kit. Use when the user asks about their brand, colors or logo. The card only sets the default kit; a saved kit is edited on the web, not on the card.
creative_brand_asset
ChatGPTPut an image into a brand kit slot or clear a slot: field logos, assets (product images) or refs (reference images), 4 slots each (slot 0-3; omit slot to use the first empty one). image_url is a link to the image; clear removes the slot's image.
creative_brand_default
ChatGPTMake one brand kit the default for new images (the previous default stops being default). Identify it by kit_id or name.
creative_brand_delete
ChatGPTDelete one brand kit with its images. The first call only shows a confirmation card (nothing is deleted); the card's Delete button confirms. In a client without cards, pass confirm after the user says yes.
creative_brand_draft_logo
ChatGPTAdd logos (or product images, field assets) the user attached (images) or linked (image_urls) to a brand draft on the card (draft_id from the card), max 4 each. Returns the draft card for review; nothing is saved yet.
creative_brand_draft_logo__app
ChatGPTCard-only copy of creative_brand_draft_logo (the card can't call tools that take files). Never call it yourself — use creative_brand_draft_logo.
creative_brand_extract
ChatGPTUse 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_save
ChatGPTCreate 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_catalog
ChatGPTList 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_clarify
ChatGPTUse 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__app
ChatGPTCard-only copy of creative_clarify (the card can't call tools that take files). Never call it yourself — use creative_clarify.
creative_edit
ChatGPTUse 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__app
ChatGPTCard-only copy of creative_edit (the card can't call tools that take files). Never call it yourself — use creative_edit.
creative_generate
ChatGPTDraw the images of an open card: one per template or original when 2+ (max 4); with 0-1, count images (default 1). At most 5 are in progress at once. For a new image request use creative_clarify. The first call returns a confirmation card; the images are drawn once the user confirms it. Card buttons call this; when the user answers a card in chat, pass that card's generate values unchanged plus their answers keyed by question label (+ template_ids they chose). Set ratio whenever the user names a ratio, size or orientation. One call per card, never two in one turn.
creative_help
ChatGPTUse this when the user mentions Creative Studio without a clear task, or asks what it is, how it works, how to start, or about their AI allowance. Shows a short intro with ways to start (describe an image, formats and templates, past images, brand kit). For the list of formats or styles, or when you need a use_case_id or style id, use creative_catalog. Do not use when they ask to make, edit or find an image: use the matching tool.
creative_image
ChatGPTOne 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_job_status
ChatGPTProgress / 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_library
ChatGPTThe 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_delete
ChatGPTDelete 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_open_web
ChatGPTLink 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_regenerate
ChatGPTUse 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_suggest_templates
ChatGPTThe 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_templates
ChatGPTBrowse ready-made image templates, filtered by format (use_case_id), group, keywords (query, matched by meaning in any language), style and colors. Returns instantly. Use when the user wants to see, search or be suggested image templates or design ideas — suggestions too, when no image round is open; on the card they select 1-4 (or add their own), may write the image's content, and create. Split a message that mixes both: query = what to look for, description = the content, also content given earlier (e.g. "wedding card for Lan & Minh, 20/11 at Hoa Sen" → query "wedding card", description "Lan & Minh, 20/11 at Hoa Sen").