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.
Paid tiers from 60 credits/call
Pricing
| Condition | Charge |
|---|---|
| Up to 4 MP | 60 credits/call |
| Over 4 MP and up to 8 MP | 120 credits/call |
| Over 8 MP and up to 16 MP | 240 credits/call |
| Over 16 MP and up to 25 MP | 480 credits/call |
| Over 25 MP and up to 50 MP | 960 credits/call |
| Over 50 MP and up to 64 MP | 1920 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.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
request_body | object | Yes | No parameter description. | — |
request_body.image | string | Yes | Input image to upscale. | — |
request_body.creativity | number | No | Negative values stay stricter to the source; positive values add more generated detail. | 0 |
request_body.target_megapixels | number | No | Requested 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-KeySubmit 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
{
"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.



