# Tool catalog Use this as routing guidance. Tool availability varies by client; never recite the catalog to the user or invent a missing tool. ## Models and generation | Tool | Use | | ------------------ | ------------------------------------------------------------------------------------------------------------------------- | | `list_models` | Discover current image, video, speech, and audio models. Filter by category. | | `get_model_params` | Read the chosen model's actual schema, defaults, enums, and extra fields. | | `generate_image` | Generate an image or edit a source supplied as `image_url`. Additional model-specific references normally go in `extras`. | | `generate_video` | Generate, animate, extend, retake, reframe, edit, or drive video according to model capability and `operation`. | | `generate_speech` | Generate speech. Supports model-specific voices, delivery controls, reference audio, and Characters. | | `generate_music` | Generate scores, music beds, stings, jingles, themes, or songs with ElevenLabs Music. | | `generate_sound_effect` | Generate sound effects, ambience, Foley, transitions, impacts, or textures with ElevenLabs. | Use `list_models` before relying on a remembered model ID. Use `get_model_params` before sending `extras`, reference arrays, resolution, duration, or operation-specific fields. Route speech to `generate_speech`, music to `generate_music`, and sound effects to `generate_sound_effect`. For a model comparison, call `generate_image` once per selected model with the same prompt and settings, then present the results together. ## Curated examples | Tool | Use | | ----------------- | -------------------------------------------------------------------------------------------------------- | | `search_examples` | Browse lean summaries and previews. Filter by query, output type, exact model ID, tags, and page cursor. | | `get_example` | Load one selected example's complete agent-ready prompt and generation hints by ID or slug. | Use `creativeclaw-find-examples` when the user asks for examples, inspiration, style directions, alternatives, or a close starting point. Do not search automatically before every generation. Tags are conjunctive: every supplied tag must match. After selection, load one example, adapt its generation prompt to the user's subject, and keep the owning generation workflow in control. ## Deterministic HTML rendering | Tool | Use | | ------------------- | -------------------------------------------------------------------------------------------------------------- | | `render_html_image` | Render a deterministic HTML/CSS layout to a PNG via Chromium. | | `render_html_video` | Queue a HyperFrames-backed HTML/CSS/JS motion render; resolve the final video URL with `check_job`. | | `create_template` | Save a reusable parameterized HTML or generative layout. | | `render_template` | Render a saved template with provided values. | The image and video renderers are explicit-only choices. Use them only when the user asks for HTML/CSS, HyperFrames, code-driven rendering, supplies HTML, or explicitly accepts the method. A generic poster, social card, overlay, intro, or outro request is not sufficient by itself. ## Themes | Tool | Use | | -------------- | ----------------------------------------------------------------------------------------------------- | | `list_themes` | Discover theme names and the default theme. | | `get_theme` | Fetch the default or named theme, including structured data and reference images. | | `update_theme` | Open the visual editor with `interactive: true`, or directly create/update data and reference images. | | `delete_theme` | Remove a theme only when explicitly requested. | For conversational setup or edits, prefer `update_theme({ interactive: true })`. For exact programmatic changes, fetch first and send the smallest direct update. Theme `data` shallow-merges; `images` replaces the full reference-image array. ## Assets and imports | Tool | Use | | ----------------------------------- | ------------------------------------------------------------------------------------------------------ | | `search_assets` | Find recent or matching media by type, query, tags, exact name, or source. | | `update_asset` | Set a unique name, replace tags, or update a description. | | `delete_asset` | Soft-delete an asset only when explicitly requested. | | `load_image` | Display an image URL inline when exposed. | | `import_chatgpt_media` | Convert one native ChatGPT attachment into a durable Creative Claw asset when exposed. | | `import_media` | Open the picker when the user still needs to choose a file. | | `get_upload_url` + `confirm_upload` | Upload local bytes from clients that can perform an HTTP PUT. | | `upload_asset` | Copy a public, directly downloadable URL into the library. Requires `url`, `content_type`, and `type`. | Read `platform-upload.md` before choosing an import route. ## Characters and films | Tool | Use | | ----------------------------------------- | ------------------------------------------------------------------------------------------------- | | `manage_character` | Create or update a visual persona with a description and reference image. | | `clone_voice` | Create or replace a consented ElevenLabs voice clone attached to an existing Character. | | `list_characters` | Find reusable Characters and IDs. | | `delete_character` | Remove a Character only when explicitly requested. | | `create_film_project` | Create a multi-shot Film project. | | `update_film_project` | Save script, shots, storyboards, clips, audio, and approval state. | | `get_film_project` / `list_film_projects` | Inspect Film projects. | | `assemble_film` | Concatenate every approved shot clip into a first cut and optionally overlay one project narration track. | ## Media processing | Tool | Use | | ------------------- | ----------------------------------------------------------------------------------------- | | `remove_background` | Remove an image or video background. | | `upscale_media` | Upscale image or video. | | `trim_video` | Cut a time range. | | `scale_video` | Resize, crop, or pad video. | | `add_subtitles` | Burn captions into video. | | `extract_frames` | Extract one or more still frames from video. | | `merge_media` | Concatenate videos or audio, or combine an audio track with video. | | `transcribe` | Produce a timed transcript from audio, video, or a public YouTube URL. | | `isolate_audio` | Remove noise, music, and reverb from a voice recording. Queued; resolve with `check_job`. | ## Account and billing Use `manage_account` to view the connected account, balances, recent generations and credit activity, including charges and refunds. Open `overview` for the balance, `activity` for a specific generation's recorded cost, or `settings` for generation preferences. Its account-page link provides user-operated purchase and subscription management; calling this read-only tool does not change billing. Read [account guidance](workflows/account.md) to match jobs to charges, distinguish gross charges/refunds/net cost, and handle missing or older records. Use `estimate_generation` for future quotes, not proof of what a past generation cost. A balance question alone is not a feedback submission request. ## Jobs and credits | Tool | Use | | --------------------- | -------------------------------------------------------------------- | | `check_job` | Resolve queued work by `job_id` when a completed result is required. | | `estimate_generation` | Estimate one planned generation, check the current balance, and return affordable H3 alternatives when needed. The final cost is confirmed after generation finishes. | | `get_credits_balance` | Check balance and usage when exposed. | | `get_credits_link` | Return a user-operated top-up link when exposed. | ## Product feedback | Tool | Use | | ----------------- | ------------------------------------------------------------------------------------------------------------ | | `submit_feedback` | Report a bug, missing feature or model, confusing flow, generation-quality issue, or explicit user praise. | Use `source: "agent"` for friction observed during a task and `source: "user"` when relaying the user's own feedback. Send one concise, specific report only when the user asks or approves; a complaint or account question alone is not authorization. Completed playable video generations are charged even if the user is disappointed. Feedback helps improve future generations and does not itself trigger a refund. For critical issues, users can also contact support@creativeclaw.co. Read [feedback guidance](workflows/feedback.md) before reporting. ## Metadata conventions - Use concise unique names such as `acme-launch-hero-v2`. - Use lowercase stable tags such as `acme`, `launch-2026`, `approved`, `reference`, `character-mira`. - `update_asset.tags` replaces the current tag array; include every tag that should remain. - Search before generating a duplicate and before assigning a name that must be unique.