Creative Upscaler

Paid tiers from 60 credits/call
ae_creative_upscaler

ae_creative_upscaler — Creatively enlarge an image with WaveSpeed's clarity-ai/creative-upscaler. Provide an input image and optionally choose a target size of 1–64 megapixels (default 4) and creativity from -10 to 10 (default 0). Negative creativity stays closer to the original; positive creativity adds generated detail and may change image details. Processing is asynchronous.

UpscalingImage
Paid tiers from 60 credits/call

Pricing

ConditionCharge
Up to 4 MP60 credits/call
Over 4 MP and up to 8 MP120 credits/call
Over 8 MP and up to 16 MP240 credits/call
Over 16 MP and up to 25 MP480 credits/call
Over 25 MP and up to 50 MP960 credits/call
Over 50 MP and up to 64 MP1920 credits/call

Each call uses one price tier based on the target output size. When omitted, the target size defaults to 4 MP.

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
request_bodyobjectYesNo parameter description.—
request_body.imagestringYesInput image to upscale.—
request_body.creativitynumberNoNegative values stay stricter to the source; positive values add more generated detail.0
request_body.target_megapixelsnumberNoRequested output size in megapixels. Range: 1-64 MP.4

Invocation example

Copy the request and explore its response example.

POST/agent-api/v1/tool/executeX-Api-Key

Submit first, then query with the returned task_id until the task completes.

Request coderequest.sh
curl --request POST \
  --url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_creative_upscaler' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "request_body": {
      "image": "https://storage.googleapis.com/falserverless/model_tests/upscale/owl.png",
      "target_megapixels": 1
    }
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "description": "task accepted; poll the result via query_tool with this task_id",
  "query_tool": "ae_get_result",
  "status": "created",
  "task_id": "0f085e8b-c62c-4b2d-8f68-f41c224a145f"
}

This example shows part of the response. Copied content is valid JSON.