topaz/upscale/image/transparent

Name: Topaz Upscale Image Transparent
Author: Topaz Labs

Upscale Image Transparent is Topaz Labs's intelligent image editing model. Transform, retouch, and reimagine existing images using text prompts - from background replacement to artistic style conversion.

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)

Transparent upscaling always outputs PNG to preserve the alpha channel.

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/upscale/image/transparent

Input Schema

2 parameters · 1 required · 1 optional

Parameter	Type	Required	Description
`image`	string	Required	Url of the image to process · Min length: 1
`output_format`	string	Optional	Transparent upscaling always outputs PNG to preserve the alpha channel. · Default: "png"

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": "topaz/upscale/image/transparent",
  "image": "https://static.sandbase.ai/examples/topaz/upscale/image/transparent/input_image_0.jpeg",
  "output_format": "png",
  "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 Upscale Image Transparent

API README

Transparent

Teams can place this named operation inside review, asset preparation, and publishing pipelines while keeping the original request attached to every result. Upscale Image Transparent is Topaz Labs's intelligent image editing model. Transform, retouch, and reimagine existing images using text prompts - from background replacement to artistic style conversion. Transparent is designed around the topaz/upscale/image/transparent workflow for transparent work in image production. Because topaz/upscale/image/transparent 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. Those strengths describe this precise catalog entry rather than its siblings.

Transparent exposes image, output_format as its documented request surface. image controls url of the image to process; output format controls transparent upscaling always outputs PNG to preserve the alpha channel. The mandatory portion is image. Applications can submit that exact shape asynchronously, retain the chosen arguments in job metadata, and collect the resulting media URL for review or publishing. For example, the route documentation includes “https://static.sandbase.ai/examples/topaz/upscale/image/transparent/input_image_0.jpeg”.

Highlights

Alpha-aware enlargement. Topaz Upscale Image Transparent upscales imagery with transparency while preserving the usable transparent background around the subject.
Clean boundary reconstruction. Enhancement concentrates on edges where foreground detail meets alpha, an area that ordinary resizing can leave jagged or haloed.
Asset-pipeline fit. It is suited to cutouts, stickers, product elements, sprites, and design components that must remain compositable after enlargement.
Layout-ready delivery. The larger transparent result can be placed across varied backgrounds without first rebuilding a mask.

Pricing

Billing option	Price
Per request	`$0.08`

When to Use

Scenario	Why it fits
Choose Transparent	Use it when the job specifically calls for transparent 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/upscale/image/transparent.

{
  "image": "https://static.sandbase.ai/examples/topaz/upscale/image/transparent/input_image_0.jpeg",
  "output_format": "png"
}

Technical Specs

Specification	Details
Model ID	`topaz/upscale/image/transparent`
Execution mode	`async`
Task type	`image`
`image`	`string` · required
`output_format`	`string` · optional