List Creative Studio models
Browse Creative Studio image and video models with public modelId, categories, media/setting parameters, supportsMultiReferenceMedia, and credit costs. creditsFrom is the minimum; creditsAtDefaults is the cost with schema defaults (duration, generate_audio, quality). ALWAYS call this before create_creative_generation when the user has not named a model. Filter with assetType=image or assetType=video based on the request. If the user gave multiple reference images/URLs and wants ONE combined output, filter for supportsMultiReferenceMedia=true models — do not plan one generation per image without asking first. Prefer Fast or Low Cost for quick drafts; Generation / higher-cost models for quality. After listing, present 2-3 concrete options with a one-line tradeoff each and let the user pick, unless they already specified a model or the request is fully unambiguous. Requires read scope.
List Creative Studio models
Tool name: list_creative_models
Required scope: read
Annotations: readOnlyHint: true, idempotentHint: true, openWorldHint: false.
Browse Creative Studio image and video models with public modelId, categories, media/setting parameters, supportsMultiReferenceMedia, and credit costs. creditsFrom is the minimum; creditsAtDefaults is the cost with schema defaults (duration, generate_audio, quality). ALWAYS call this before create_creative_generation when the user has not named a model. Filter with assetType=image or assetType=video based on the request. If the user gave multiple reference images/URLs and wants ONE combined output, filter for supportsMultiReferenceMedia=true models — do not plan one generation per image without asking first. Prefer Fast or Low Cost for quick drafts; Generation / higher-cost models for quality. After listing, present 2-3 concrete options with a one-line tradeoff each and let the user pick, unless they already specified a model or the request is fully unambiguous. Requires read scope.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
assetType | enum (image, video) | optional | Filter models by asset type. Use image for stills, video for clips. Omit to return both. |
category | string | optional | Optional category filter, for example Generation, Editing, Fast, Low Cost, or Image/Video Generation. |
Get credits
Credit balance (subscription and pay-per-use), the plan, when plan credits refill, and the credit packs the user can buy now. Call it when the user asks about credits or after a tool returns insufficient_credits, and relay its advice. Requires read scope.
Get Creative Studio model
Return the full parameter schema for one public modelId (required/optional settings, media inputs, enums, defaults, credit hints). Includes creditsFrom (minimum), creditsAtDefaults (schema defaults), and estimatedCredits when you pass parameters (duration, generate_audio, mode, resolution, etc.). Call after list_creative_models when you need exact parameter names or a quote before create_creative_generation, or to confirm a media parameter's maxItems when combining multiple reference images into one output. Requires read scope.