Skip to main content
Dreamstudio logo
  • Category: media generation
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 5
  • Triggers: 0
  • Slug: DREAMSTUDIO
  • Version: 20261014_00

Tools

Slug: DREAMSTUDIO_GENERATE_IMAGE_FROM_IMAGETool to generate a new image from an initial image and text prompts. Use after you have a reference image and want to transform it via text guidance.

Input Parameters

integer
Optional random seed for reproducible results
integer
Number of diffusion steps to run
integer
[DEPRECATED - DO NOT USE] Output dimensions are determined by init_image size. This parameter is ignored by the API.
integer
[DEPRECATED - DO NOT USE] Output dimensions are determined by init_image size. This parameter is ignored by the API.
integer
How many images to generate in one call
number
Guidance scale (how strongly to follow the prompt, 0-35)
string
required
Engine identifier for generation, e.g. ‘stable-diffusion-v1-5’ Validate via DREAMSTUDIO_LIST_ENGINES before calling; unsupported values cause failures.
string
required
Binary content of the input image to guide generation
array
required
List of prompt objects each with text and optional weight
number
Controls how much the original image is preserved (0-1). Required when init_image_mode=‘IMAGE_STRENGTH’.
string ("IMAGE_STRENGTH" | "STEP_SCHEDULE")
required
Guidance mode for how the init_image influences the result. ‘IMAGE_STRENGTH’ uses image_strength, ‘STEP_SCHEDULE’ uses step_schedule_start/end.
number
Optional end fraction for image influence in the schedule (0-1). Defaults to 1.0 if omitted.
number
Fraction at which to start image influence in the sampling schedule (0-1). Required when init_image_mode=‘STEP_SCHEDULE’.
string ("NONE" | "FAST_BLUE" | "FAST_GREEN" | "SIMPLE" | "SLOW" | "SLOWER" | "SLOWEST")
CLIP guidance presets supported by the DreamStudio image-to-image API.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DREAMSTUDIO_GENERATE_IMAGE_FROM_TEXTGenerate images from text prompts using Stability AI’s text-to-image models. Use when you need to create images from textual descriptions without a reference image. Supports multiple prompts with weights, configurable dimensions, and various generation parameters.

Input Parameters

integer
Random seed for reproducible generation. Use the same seed with same parameters to get identical results. If omitted, a random seed is used.
integer
Number of diffusion steps. More steps generally improve quality but take longer. Typical range: 30-50. If omitted, engine’s default is used.
integer
Width of generated image in pixels. Must be a multiple of 64. Constraints: For 768 engines: 589,824 ≤ height_width ≤ 1,048,576. For other engines: 262,144 ≤ height_width ≤ 1,048,576. If omitted, engine’s default width is used.
integer
Height of generated image in pixels. Must be a multiple of 64. Constraints: For 768 engines: 589,824 ≤ height_width ≤ 1,048,576. For other engines: 262,144 ≤ height_width ≤ 1,048,576. If omitted, engine’s default height is used.
string ("DDIM" | "DDPM" | "K_DPMPP_2M" | "K_DPMPP_2S_ANCESTRAL" | "K_DPM_2" | "K_DPM_2_ANCESTRAL" | "K_EULER" | "K_EULER_ANCESTRAL" | "K_HEUN" | "K_LMS")
Available sampler algorithms for image generation.
integer
Number of images to generate in a single request. Default is 1. Higher values consume more API credits.
number
Classifier-Free Guidance scale - how strictly to follow the text prompt. Higher values (7-15) follow prompt more closely, lower values (1-7) allow more creative freedom. If omitted, engine’s default is used.
string
required
Engine identifier for generation (e.g., ‘stable-diffusion-v1-5’, ‘stable-diffusion-xl-1024-v1-0’). Use DREAMSTUDIO_LIST_ENGINES to get available engines. Using invalid engine_id will cause the request to fail.
string
Organization ID to scope the request to. If not provided, uses the user’s default organization from their account.
array
required
List of text prompts with optional weights. At least one prompt is required.
string ("NONE" | "FAST_BLUE" | "FAST_GREEN" | "SIMPLE" | "SLOW" | "SLOWER" | "SLOWEST")
CLIP guidance presets for text-to-image generation.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DREAMSTUDIO_LIST_ENGINESList all available DreamStudio/Stability AI engines accessible with your API key. This action retrieves all AI models (engines) you can use for image generation and other tasks. Common engines include Stable Diffusion XL and various Stable Diffusion versions. Use this action to: - Discover which engines are available to your account - Get engine IDs needed for image generation requests - Check engine types and capabilities No parameters required - simply call to get the complete list of accessible engines. Using an unsupported engine_id in generation requests will cause failures; engines also vary in supported image sizes (typically capped near 1024x1024) and quality for specific tasks.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DREAMSTUDIO_USER_ACCOUNTRetrieves authenticated user’s account information from Stability AI. Returns user ID, email, organization memberships, and profile picture. No parameters required - uses authenticated session.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DREAMSTUDIO_USER_BALANCERetrieves the user’s current credit balance from their DreamStudio account. Use this tool to check how many credits are available before generating images or to monitor remaining credits after API operations. Credits are consumed when generating images through the Stability AI API. For large or high-resolution batch generation, verify sufficient balance first — insufficient credits will cause failures mid-run.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not