Topaz Bloom API reference

Call Topaz Bloom from your own code with one PopNow API key. Below are the exact model IDs to send, every input field the model accepts, what each request costs in USD, and a request you can paste into a terminal.

At a glance

Made by: Topaz Labs
Output: Image
From: $0.36 USD per image
Model IDs: topaz/bloom/upscale

Prices are in USD, charged to your separate API wallet. A task reserves the maximum possible charge when accepted and settles actual usage on completion; any remainder is released. Failed tasks are not charged. Call POST /api/v1/jobs/quote for an exact quote before running.

Upscale Image

topaz/bloom/upscale

Price

Option	USD
`2k`	$0.36 per image
`4k`	$1.08 per image
`8k`	$4.08 per image

Parameters

Field	Type	Default	Allowed	What it does
`image_url`Required	`string`	—	—	The image to upscale creatively, usually an AI render or artwork: JPEG, PNG or WebP. Composition and aspect ratio are kept.
`preset`Optional	`string`	`bloom_2`	bloom_2, bloom, bloom_realism	Which Topaz Bloom model to run. bloom_2 is the newest and invents the most convincing new detail; bloom suits illustrations, artwork and CG; bloom_realism keeps a natural, photographic look and only accepts creativity 1 to 4.
`resolution`Optional	`string`	`4k`	2k, 4k, 8k	Output size: a pixel budget of about 4 MP (2k), 16.8 MP (4k) or 67 MP (8k) with the source aspect ratio kept. The price depends on this tier only.
`prompt`Optional	`string`	—	up to 2,000 characters	Optional description of the image or of the result you want; it steers what the new detail looks like. Leave it empty to let the model describe the image itself.
`creativity`Optional	`integer`	`3`	1 to 9	How freely the image is reinterpreted: 1 stays closest to the source, 9 adds the most new detail. bloom_realism accepts 1 to 4; higher values are refused for that preset. Does not change the price.
`output_format`Optional	`string`	`jpeg`	jpeg, png	File type of the returned image. png avoids another round of lossy compression but is several times larger. The format does not change the price.

Example request

This request runs as it is; any field you leave out uses its default. Put your key in POPNOW_API_KEY first.

The example uses PopNow sample files in image_url. Replace them with your own public HTTPS links, uploads or saved assets.

POST /api/v1/jobs/createTask

curl -X POST "https://api.popnow.ai/api/v1/jobs/createTask" \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "model": "topaz/bloom/upscale",
  "input": {
    "prompt": "Sharpen fine detail and keep the natural look",
    "image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
    "resolution": "4k"
  }
}'

The response carries a taskId straight away. Read the result with GET /api/v1/jobs/recordInfo, or add callBackUrl to be notified.

GET /api/v1/jobs/recordInfo

curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
  -H "Authorization: Bearer $POPNOW_API_KEY"