topaz/adjust/image

Name: Topaz Adjust Image
Author: Topaz Labs

Adjust Image by Topaz Labs - AI-powered image editing, style transfer, and transformation. Edit photos with natural language instructions, remove backgrounds, change styles, and enhance images effortlessly.

Input

Image URL or upload(string)

Upload

PNG, JPEG, WebP, or GIF · 20 MiB maximum

Url of the image to process

This field is required.

Output Format(string)

Output format of the processed image. Allowed values: jpeg, png.

Model(string)

Color & lighting correction. Adjust V2 fixes exposure/lighting; White Balance corrects color; Colorize adds color to B&W images. Allowed values: Adjust V2, White Balance, Colorize.

Idle

Example output — click Run to generate your own

Production endpoint

Send your first request

OpenAI-compatible endpoint with unified authentication and usage tracking.

POSThttps://api.sandbase.ai/v1/run

Model IDtopaz/adjust/image

Input Schema

3 parameters · 1 required · 2 optional

Parameter	Type	Required	Description
`image`	string	Required	Url of the image to process · Min length: 1
`model`	string	Optional	Color & lighting correction. Adjust V2 fixes exposure/lighting; White Balance corrects color; Colorize adds color to B&W images. · Options: Adjust V2, White Balance, Colorize · Default: "Adjust V2" Adjust V2White BalanceColorize
`output_format`	string	Optional	Output format of the processed image. · Options: jpeg, png · Default: "jpeg" jpegpng

Output Schema

Field	Type	Description
`id`	string	Unique identifier for the generation task
`status`	string	Task status: pending, running, completed, failed, timeout
`model`	string	Model used for the generation
`outputs`	array	Array of output items
`outputs[].url`	string	URL of the generated artifact
`outputs[].content_type`	string	MIME type (e.g. image/png, video/mp4)
`error`	object \| null	Error details if failed, null on success
`error.type`	string	Machine-readable error type code
`error.message`	string	Human-readable error description

Async Workflow

This model uses asynchronous execution. Submit a request and poll for the result.

Submit — POST to /v1/run, receive an id
Poll — GET /v1/run/{id} until status is completed, failed, or timeout
Retrieve — Read outputs from the completed response

Code Examples

Ready-to-run snippets

# Step 1: Submit
curl -X POST https://api.sandbase.ai/v1/run \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "model": "Adjust V2",
  "image": "https://static.sandbase.ai/examples/topaz/adjust/image/input_image_0.jpeg",
  "output_format": "jpeg",
  "prompt": "a beautiful sunset over mountains"
}'

# Step 2: Poll result (replace <id>)
curl https://api.sandbase.ai/v1/run/<id> \
  -H "Authorization: Bearer YOUR_API_KEY"

← Back to Topaz Adjust Image

API README

Image

Image serves the topaz/adjust/image workflow for image work in image production. Teams can place this named operation inside review, asset preparation, and publishing pipelines while keeping the original request attached to every result. Adjust Image by Topaz Labs - AI-powered image editing, style transfer, and transformation. Edit photos with natural language instructions, remove backgrounds, change styles, and enhance images effortlessly. Because topaz/adjust/image is a separate catalog entry, evaluations should use this route’s own inputs, output expectations, and billing behavior. The endpoint is especially useful when a project has a defined transformation goal and needs a repeatable request contract instead of an ad-hoc desktop step. This is the creative remit of the exact endpoint, not a family-wide promise.

Image exposes image, output_format, model as its documented request surface. The mandatory portion is image. image controls url of the image to process; output format controls output format of the processed image; output format accepts jpeg, png; model controls color & lighting correction. Adjust V2 fixes exposure/lighting; White Balance corrects color; Colorize adds color to B&W images; model accepts Adjust V2, White Balance, Colorize. For example, the route documentation includes “https://static.sandbase.ai/examples/topaz/adjust/image/input_image_0.jpeg”. Applications can submit that exact shape asynchronously, retain the chosen arguments in job metadata, and collect the resulting media URL for review or publishing.

Highlights

Targeted image adjustment. Topaz Adjust Image applies controlled color, exposure, lighting, and tonal corrections to an existing image while retaining its underlying composition.
Prompt-directed finishing. A written instruction can describe the desired visual correction, allowing nuanced enhancement beyond a single fixed filter.
Source-preserving workflow. The input image remains the structural reference, making this route appropriate when the scene is already approved and only its finish needs refinement.
Configurable delivery. Declared output settings let applications request the supported format and quality choices needed by the next production step.

Pricing

Billing option	Price
Per request	`$0.08`

When to Use

Scenario	Why it fits
Choose Image	Use it when the job specifically calls for image and the route’s documented input contract matches assets already available in your workflow.
Keep the request reproducible	Use the required `image` explicitly, then record optional choices alongside the prompt for repeatable reruns.
Build controlled creative variations	Change one declared control at a time when comparing framing, format, duration, resolution, style, or other route-supported output decisions.
Integrate asynchronous delivery	Use this endpoint when an application can submit work, track completion, and collect the returned media URL instead of requiring an immediate inline artifact.
Validate before a large batch	Run representative prompts and source assets first, confirm the visual or audio behavior, then lock the successful request shape for scaled production.

Prompt Guide

Lead with the subject or transformation, then add the composition, environment, style, lighting, motion, voice, or fidelity details relevant to this route. Keep every parameter inside the documented schema; the example below uses only fields declared for topaz/adjust/image.

{
  "image": "https://static.sandbase.ai/examples/topaz/adjust/image/input_image_0.jpeg",
  "output_format": "jpeg",
  "model": "Adjust V2"
}

Technical Specs

Specification	Details
Model ID	`topaz/adjust/image`
Execution mode	`async`
Task type	`image`
`image`	`string` · required
`output_format`	`string` · optional · choices: `jpeg`, `png`
`model`	`string` · optional · choices: `Adjust V2`, `White Balance`, `Colorize`