Skip to content
Reduced motion is on. Play a preview to watch it.
Explore models

Image

Playground v2.5

Create an image from a scene description with Playground v2.5.

  • Text to image
  • Image editing
Create with Playground v2.5
Preview for Playground v2.5

Catalog preview for Playground v2.5. Review your own result before publishing.

A starting point.

Explore composition and lighting before refining smaller objects.

Before you publish.

Inspect object relationships and check that requested details are not replaced by unrelated decoration.

Review the quote before running. A failed generation releases its reserved credits. Download the results you want to keep; stored media is retained for 30 days.

How credits work · Use the API · Content guidelines

Settings and model questionsCheck the available settings and guidance when preparing your input.

Inputs and settings

The default requires prompt. num_images allows 1–8; num_inference_steps allows 1–50. Change guidance_scale gradually while keeping seed fixed.

Image-to-image needs image_url and prompt; inpainting also needs mask_url. These operations offer strength and their own step limits. Choose format as jpeg or png.

Inputs, all modes and APIModel IDs, current input limits and the API generation workflow.

Supported inputs

These fields come from the current studio form for playground-v25. Other modes may require different inputs.

Input types, requirements and limits for playground-v25
InputTypeRequirementOptions and limits
promptTextRequired—
embeddingsListOptional—
enable_safety_checkerOn/offOptional—
expand_promptOn/offOptional—
formatTextOptionaljpeg, png
guidance_scaleNumberOptional≥ 0 · ≤ 20
negative_promptTextOptional—
num_imagesWhole numberOptional≥ 1 · ≤ 8
num_inference_stepsWhole numberOptional≥ 1 · ≤ 50
request_idTextOptional—
safety_checker_versionTextOptional—
seedWhole numberOptional—

Check the full model schema for all options and cross-field rules. Request a quote for your selected settings before generating.

Other modes and their inputs

Open the operation you need and check its inputs. Settings from one mode do not automatically apply to another.

image-to-image (image-to-image)playground-v25/image-to-image

Supported inputs

These fields come from the current studio form for playground-v25/image-to-image. Other modes may require different inputs.

Input types, requirements and limits for playground-v25/image-to-image
InputTypeRequirementOptions and limits
image_urlTextRequired—
promptTextRequired—
crop_outputOn/offOptional—
embeddingsListOptional—
enable_safety_checkerOn/offOptional—
expand_promptOn/offOptional—
formatTextOptionaljpeg, png
guidance_scaleNumberOptional≥ 0 · ≤ 20
negative_promptTextOptional—
num_imagesWhole numberOptional≥ 1 · ≤ 8
num_inference_stepsWhole numberOptional≥ 1 · ≤ 65
preserve_aspect_ratioOn/offOptional—
request_idTextOptional—
safety_checker_versionTextOptional—
seedWhole numberOptional—
strengthNumberOptional≥ 0.05 · ≤ 1

Check the full model schema for all options and cross-field rules. Request a quote for your selected settings before generating.

Open this operation in the studio

image-to-image (inpainting)playground-v25/inpainting

Supported inputs

These fields come from the current studio form for playground-v25/inpainting. Other modes may require different inputs.

Input types, requirements and limits for playground-v25/inpainting
InputTypeRequirementOptions and limits
image_urlTextRequired—
mask_urlTextRequired—
promptTextRequired—
embeddingsListOptional—
enable_safety_checkerOn/offOptional—
expand_promptOn/offOptional—
formatTextOptionaljpeg, png
guidance_scaleNumberOptional≥ 0 · ≤ 20
negative_promptTextOptional—
num_imagesWhole numberOptional≥ 1 · ≤ 8
num_inference_stepsWhole numberOptional≥ 1 · ≤ 65
request_idTextOptional—
safety_checker_versionTextOptional—
seedWhole numberOptional—
strengthNumberOptional≥ 0.01 · ≤ 1

Check the full model schema for all options and cross-field rules. Request a quote for your selected settings before generating.

Open this operation in the studio

Use Playground v2.5 through the API.

Start with this model ID for the endpoint featured on this page:

playground-v25

Input requirements belong to this model ID. Check a different mode’s schema separately when switching modes.

Available modes

Check the current model schema for supported inputs and options. Other tasks may use different model IDs.

From quote to result.

Request a credit quote for your input and settings before submitting a generation. A sample output or the price of another model is not a quote for your request.

Follow the generation workflow, then poll the job for its status and result. The API and studio use the same balance.