Account tools

Use these tools to list models, check your credit balance, and view generation history.

#Available models and pricing

A live list of enabled models and their prices (synced to the database) is in Available models. Disabled models are hidden there and in get_models.

get_models returns all available models with their price in credits and typical generation time. Use it to choose a model and confirm cost before generating.

• Pricing: Each model includes cost_per_generation (credits).
• Estimated time: Each model includes estimated_time_seconds (typical generation duration). You get both cost and estimated duration in one call; no separate estimation tool needed for a per-model estimate.
• Use listed models only: When calling generate_media or generate_music, use a model_id from the get_models response. Using a model not in that list may result in an error.

Filter by model_type (image, video, or music) to get models for a specific capability. See Media tools, Music tools, and Ads tools for per-tool model usage.

#get_models

Returns available AI models with costs and capabilities. Call this before generating to choose the right model and confirm cost.

Parameters:

Response: A list of models. Each entry typically includes:

• model_id - Use this in generate_media or generate_music. Only use IDs returned here.
• display_name, provider
• model_type (image, video, music)
• cost_per_generation (credits)
• estimated_time_seconds (typical generation duration)
• generation_types (e.g. text-to-image, image-to-video)
• requires_input_media, input_media_types (e.g. one image)
• capabilities (aspect ratios, durations, quality levels, etc.)

Use this to decide which model to use and whether you need to pass source_media_urls for media.

#get_balance

Returns your current Kubeez credit balance.

Parameters: None (uses your authenticated account).

Response: Your available credits (and optionally last updated). Check this before starting expensive generations.

#get_generations

Returns your latest 20 generations (media) with optional filters (e.g. to list recent jobs and their output or source links). For a specific generation, use get_generation_status (media) or get_music_status (music) with that generation_id.

Parameters:

Response: Up to 20 generations with IDs, prompts, models, status, timestamps, and output details.

See Limitations for rate limits.