Clarity
Clarity is an image upscaling model focused on boosting perceived detail during 2× to 4× enlargement, keeping structure stable while enhancing texture and small features for cleaner, higher-impact images.

API Reference
INTEGRATE
Complete technical specification for integration
RequestResponse
Examples4
CODE
Ready-to-use code snippets for common workflows
upscale
Falconry Hood Cutout Upscale$0.0064~16s
import { createClient } from '@runware/sdk'
const client = await createClient({ apiKey: process.env.RUNWARE_API_KEY })
await client.connect()
const [result] = await client.run({
model: 'runware:500@1',
upscaleFactor: 2,
settings: {
positivePrompt: 'Upscale this finished background-replaced product photograph without changing its composition or the hood\'s identity. Preserve the exact silhouette and clean separation from the pale-sage background. Enhance the fine leather grain, punched ventilation holes, cream stitching, braided topknot fibers, engraved tooling, aged brass patina, natural edge definition, soft grounding shadow, and controlled studio lighting. Keep the background seamless, matte, evenly colored, and free of artifacts.'
},
inputs: {
image: 'https://assets.runware.ai/assets/inputs/6a1e0185-5ed7-4603-af59-e416f85480fc.jpg'
}
})import asyncio
import os
from runware import Runware
async def main():
async with Runware(api_key=os.environ["RUNWARE_API_KEY"]) as client:
results = await client.run({
"model": "runware:500@1",
"upscaleFactor": 2,
"settings": {
"positivePrompt": "Upscale this finished background-replaced product photograph without changing its composition or the hood's identity. Preserve the exact silhouette and clean separation from the pale-sage background. Enhance the fine leather grain, punched ventilation holes, cream stitching, braided topknot fibers, engraved tooling, aged brass patina, natural edge definition, soft grounding shadow, and controlled studio lighting. Keep the background seamless, matte, evenly colored, and free of artifacts."
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/6a1e0185-5ed7-4603-af59-e416f85480fc.jpg"
}
})
asyncio.run(main())curl https://api.runware.ai/v1 \
-H "Authorization: Bearer $RUNWARE_API_KEY" \
-H "Content-Type: application/json" \
-d '[
{
"taskType": "upscale",
"taskUUID": "a2a81745-b7da-4b34-baa5-1d9c6c2ad52b",
"model": "runware:500@1",
"upscaleFactor": 2,
"settings": {
"positivePrompt": "Upscale this finished background-replaced product photograph without changing its composition or the hood's identity. Preserve the exact silhouette and clean separation from the pale-sage background. Enhance the fine leather grain, punched ventilation holes, cream stitching, braided topknot fibers, engraved tooling, aged brass patina, natural edge definition, soft grounding shadow, and controlled studio lighting. Keep the background seamless, matte, evenly colored, and free of artifacts."
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/6a1e0185-5ed7-4603-af59-e416f85480fc.jpg"
}
}
]'runware run runware:500@1 \
upscaleFactor=2 \
settings.positivePrompt="Upscale this finished background-replaced product photograph without changing its composition or the hood's identity. Preserve the exact silhouette and clean separation from the pale-sage background. Enhance the fine leather grain, punched ventilation holes, cream stitching, braided topknot fibers, engraved tooling, aged brass patina, natural edge definition, soft grounding shadow, and controlled studio lighting. Keep the background seamless, matte, evenly colored, and free of artifacts." \
inputs.image=https://assets.runware.ai/assets/inputs/6a1e0185-5ed7-4603-af59-e416f85480fc.jpg{
"taskType": "upscale",
"taskUUID": "a2a81745-b7da-4b34-baa5-1d9c6c2ad52b",
"model": "runware:500@1",
"upscaleFactor": 2,
"settings": {
"positivePrompt": "Upscale this finished background-replaced product photograph without changing its composition or the hood's identity. Preserve the exact silhouette and clean separation from the pale-sage background. Enhance the fine leather grain, punched ventilation holes, cream stitching, braided topknot fibers, engraved tooling, aged brass patina, natural edge definition, soft grounding shadow, and controlled studio lighting. Keep the background seamless, matte, evenly colored, and free of artifacts."
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/6a1e0185-5ed7-4603-af59-e416f85480fc.jpg"
}
}Response
{
"taskType": "imageUpscale",
"taskUUID": "a2a81745-b7da-4b34-baa5-1d9c6c2ad52b",
"imageUUID": "8075f74f-47f0-4a13-a5b4-c6c4c9a2be9b",
"imageURL": "https://im.runware.ai/image/os/a01d21/ws/3/ii/8075f74f-47f0-4a13-a5b4-c6c4c9a2be9b.jpg",
"cost": 0.0064,
"inputImageUUID": "97064fbe-5c0e-4d61-b4e6-a609ed207bd3"
}upscale
Antarctic Radio Archive Photo Restoration$0.0032~13s
import { createClient } from '@runware/sdk'
const client = await createClient({ apiKey: process.env.RUNWARE_API_KEY })
await client.connect()
const [result] = await client.run({
model: 'runware:500@1',
upscaleFactor: 2,
settings: {
positivePrompt: 'Restore and enlarge this archival Antarctic research photograph while preserving the exact composition, radio operator’s identity, facial expression, pose, equipment layout, and monochrome documentary character. Recover natural facial detail, knitted wool fibers, parka fur, radio dial markings, braided cable texture, handwritten logbook lines, map edges, frost crystals, and restrained silver-gelatin film grain. Reduce scan softness, dust, scratches, fading, and the shallow print crease without making the image look modern, glossy, colorized, or artificially sharpened.',
negativePrompt: 'changed face, altered identity, added objects, missing equipment, rearranged composition, colorization, modern electronics, plastic skin, excessive sharpening, halos, waxy texture, invented lettering, illegible replacement text, heavy HDR, oversaturated contrast'
},
inputs: {
image: 'https://assets.runware.ai/assets/inputs/e3de92ff-1d3d-44cc-a9c5-07f1f429c904.jpg'
}
})import asyncio
import os
from runware import Runware
async def main():
async with Runware(api_key=os.environ["RUNWARE_API_KEY"]) as client:
results = await client.run({
"model": "runware:500@1",
"upscaleFactor": 2,
"settings": {
"positivePrompt": "Restore and enlarge this archival Antarctic research photograph while preserving the exact composition, radio operator’s identity, facial expression, pose, equipment layout, and monochrome documentary character. Recover natural facial detail, knitted wool fibers, parka fur, radio dial markings, braided cable texture, handwritten logbook lines, map edges, frost crystals, and restrained silver-gelatin film grain. Reduce scan softness, dust, scratches, fading, and the shallow print crease without making the image look modern, glossy, colorized, or artificially sharpened.",
"negativePrompt": "changed face, altered identity, added objects, missing equipment, rearranged composition, colorization, modern electronics, plastic skin, excessive sharpening, halos, waxy texture, invented lettering, illegible replacement text, heavy HDR, oversaturated contrast"
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/e3de92ff-1d3d-44cc-a9c5-07f1f429c904.jpg"
}
})
asyncio.run(main())curl https://api.runware.ai/v1 \
-H "Authorization: Bearer $RUNWARE_API_KEY" \
-H "Content-Type: application/json" \
-d '[
{
"taskType": "upscale",
"taskUUID": "91c9e0a4-b00f-4987-b98e-f5cbdaf5defe",
"model": "runware:500@1",
"upscaleFactor": 2,
"settings": {
"positivePrompt": "Restore and enlarge this archival Antarctic research photograph while preserving the exact composition, radio operator’s identity, facial expression, pose, equipment layout, and monochrome documentary character. Recover natural facial detail, knitted wool fibers, parka fur, radio dial markings, braided cable texture, handwritten logbook lines, map edges, frost crystals, and restrained silver-gelatin film grain. Reduce scan softness, dust, scratches, fading, and the shallow print crease without making the image look modern, glossy, colorized, or artificially sharpened.",
"negativePrompt": "changed face, altered identity, added objects, missing equipment, rearranged composition, colorization, modern electronics, plastic skin, excessive sharpening, halos, waxy texture, invented lettering, illegible replacement text, heavy HDR, oversaturated contrast"
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/e3de92ff-1d3d-44cc-a9c5-07f1f429c904.jpg"
}
}
]'runware run runware:500@1 \
upscaleFactor=2 \
settings.positivePrompt="Restore and enlarge this archival Antarctic research photograph while preserving the exact composition, radio operator’s identity, facial expression, pose, equipment layout, and monochrome documentary character. Recover natural facial detail, knitted wool fibers, parka fur, radio dial markings, braided cable texture, handwritten logbook lines, map edges, frost crystals, and restrained silver-gelatin film grain. Reduce scan softness, dust, scratches, fading, and the shallow print crease without making the image look modern, glossy, colorized, or artificially sharpened." \
settings.negativePrompt="changed face, altered identity, added objects, missing equipment, rearranged composition, colorization, modern electronics, plastic skin, excessive sharpening, halos, waxy texture, invented lettering, illegible replacement text, heavy HDR, oversaturated contrast" \
inputs.image=https://assets.runware.ai/assets/inputs/e3de92ff-1d3d-44cc-a9c5-07f1f429c904.jpg{
"taskType": "upscale",
"taskUUID": "91c9e0a4-b00f-4987-b98e-f5cbdaf5defe",
"model": "runware:500@1",
"upscaleFactor": 2,
"settings": {
"positivePrompt": "Restore and enlarge this archival Antarctic research photograph while preserving the exact composition, radio operator’s identity, facial expression, pose, equipment layout, and monochrome documentary character. Recover natural facial detail, knitted wool fibers, parka fur, radio dial markings, braided cable texture, handwritten logbook lines, map edges, frost crystals, and restrained silver-gelatin film grain. Reduce scan softness, dust, scratches, fading, and the shallow print crease without making the image look modern, glossy, colorized, or artificially sharpened.",
"negativePrompt": "changed face, altered identity, added objects, missing equipment, rearranged composition, colorization, modern electronics, plastic skin, excessive sharpening, halos, waxy texture, invented lettering, illegible replacement text, heavy HDR, oversaturated contrast"
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/e3de92ff-1d3d-44cc-a9c5-07f1f429c904.jpg"
}
}Response
{
"taskType": "imageUpscale",
"taskUUID": "91c9e0a4-b00f-4987-b98e-f5cbdaf5defe",
"imageUUID": "f1e68736-9f58-4e94-8696-feb85ea1e1bc",
"imageURL": "https://im.runware.ai/image/os/a08dlim3/ws/4/ii/f1e68736-9f58-4e94-8696-feb85ea1e1bc.jpg",
"cost": 0.0032,
"inputImageUUID": "4037474a-bb9f-4c8c-aa90-6e99ebe84f34"
}upscale
Historic Organ Campaign Panorama$0.0026~11s
import { createClient } from '@runware/sdk'
const client = await createClient({ apiKey: process.env.RUNWARE_API_KEY })
await client.connect()
const [result] = await client.run({
model: 'runware:500@1',
upscaleFactor: 2,
settings: {
positivePrompt: 'Preserve the exact panoramic composition, symmetry, organ design, architectural geometry, lighting, and subject identity. Enhance the fine fluting and aged patina of every pipe, carved walnut ornament, console keys, balcony joinery, cobalt wall texture, and subtle pools of amber light. Keep the extended side architecture coherent and natural without adding, removing, or rearranging elements.'
},
inputs: {
image: 'https://assets.runware.ai/assets/inputs/d7f31d2a-03e2-42e9-8569-8e1dad2e1463.jpg'
}
})import asyncio
import os
from runware import Runware
async def main():
async with Runware(api_key=os.environ["RUNWARE_API_KEY"]) as client:
results = await client.run({
"model": "runware:500@1",
"upscaleFactor": 2,
"settings": {
"positivePrompt": "Preserve the exact panoramic composition, symmetry, organ design, architectural geometry, lighting, and subject identity. Enhance the fine fluting and aged patina of every pipe, carved walnut ornament, console keys, balcony joinery, cobalt wall texture, and subtle pools of amber light. Keep the extended side architecture coherent and natural without adding, removing, or rearranging elements."
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/d7f31d2a-03e2-42e9-8569-8e1dad2e1463.jpg"
}
})
asyncio.run(main())curl https://api.runware.ai/v1 \
-H "Authorization: Bearer $RUNWARE_API_KEY" \
-H "Content-Type: application/json" \
-d '[
{
"taskType": "upscale",
"taskUUID": "120618e4-259c-4e7a-8c38-a9ffb02e5620",
"model": "runware:500@1",
"upscaleFactor": 2,
"settings": {
"positivePrompt": "Preserve the exact panoramic composition, symmetry, organ design, architectural geometry, lighting, and subject identity. Enhance the fine fluting and aged patina of every pipe, carved walnut ornament, console keys, balcony joinery, cobalt wall texture, and subtle pools of amber light. Keep the extended side architecture coherent and natural without adding, removing, or rearranging elements."
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/d7f31d2a-03e2-42e9-8569-8e1dad2e1463.jpg"
}
}
]'runware run runware:500@1 \
upscaleFactor=2 \
settings.positivePrompt="Preserve the exact panoramic composition, symmetry, organ design, architectural geometry, lighting, and subject identity. Enhance the fine fluting and aged patina of every pipe, carved walnut ornament, console keys, balcony joinery, cobalt wall texture, and subtle pools of amber light. Keep the extended side architecture coherent and natural without adding, removing, or rearranging elements." \
inputs.image=https://assets.runware.ai/assets/inputs/d7f31d2a-03e2-42e9-8569-8e1dad2e1463.jpg{
"taskType": "upscale",
"taskUUID": "120618e4-259c-4e7a-8c38-a9ffb02e5620",
"model": "runware:500@1",
"upscaleFactor": 2,
"settings": {
"positivePrompt": "Preserve the exact panoramic composition, symmetry, organ design, architectural geometry, lighting, and subject identity. Enhance the fine fluting and aged patina of every pipe, carved walnut ornament, console keys, balcony joinery, cobalt wall texture, and subtle pools of amber light. Keep the extended side architecture coherent and natural without adding, removing, or rearranging elements."
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/d7f31d2a-03e2-42e9-8569-8e1dad2e1463.jpg"
}
}Response
{
"taskType": "imageUpscale",
"taskUUID": "120618e4-259c-4e7a-8c38-a9ffb02e5620",
"imageUUID": "370e2485-157d-47aa-8aff-4e05ae3ede44",
"imageURL": "https://im.runware.ai/image/os/a01d21/ws/3/ii/370e2485-157d-47aa-8aff-4e05ae3ede44.jpg",
"cost": 0.0026,
"inputImageUUID": "f2176eb8-0967-47e9-a63a-687bcbad1289"
}upscale
Cave Rescue Team Commemorative Wall Portrait$0.0045~16s
import { createClient } from '@runware/sdk'
const client = await createClient({ apiKey: process.env.RUNWARE_API_KEY })
await client.connect()
const [result] = await client.run({
model: 'runware:500@1',
upscaleFactor: 2,
settings: {
positivePrompt: 'Preserve the exact group composition, all eight rescuers, their individual faces, poses, equipment and the retired border collie seated at center. Enhance realistic facial definition, individual fur strands, rope fibers, scratched helmets, woven technical fabrics, metal carabiners and damp limestone texture. Maintain the existing warm work-light and cool cave-shadow balance, documentary realism and seamless integration of the added dog without changing subject identity or placement.',
negativePrompt: 'Changed faces, altered poses, missing or additional people, duplicated limbs, extra dogs, shifted subjects, modified equipment, artificial fur, plastic skin, halos, cutout edges, oversharpening, invented text, changed composition'
},
inputs: {
image: 'https://assets.runware.ai/assets/inputs/0a72bbe8-2013-4cc3-8d06-72fa00780c08.jpg'
}
})import asyncio
import os
from runware import Runware
async def main():
async with Runware(api_key=os.environ["RUNWARE_API_KEY"]) as client:
results = await client.run({
"model": "runware:500@1",
"upscaleFactor": 2,
"settings": {
"positivePrompt": "Preserve the exact group composition, all eight rescuers, their individual faces, poses, equipment and the retired border collie seated at center. Enhance realistic facial definition, individual fur strands, rope fibers, scratched helmets, woven technical fabrics, metal carabiners and damp limestone texture. Maintain the existing warm work-light and cool cave-shadow balance, documentary realism and seamless integration of the added dog without changing subject identity or placement.",
"negativePrompt": "Changed faces, altered poses, missing or additional people, duplicated limbs, extra dogs, shifted subjects, modified equipment, artificial fur, plastic skin, halos, cutout edges, oversharpening, invented text, changed composition"
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/0a72bbe8-2013-4cc3-8d06-72fa00780c08.jpg"
}
})
asyncio.run(main())curl https://api.runware.ai/v1 \
-H "Authorization: Bearer $RUNWARE_API_KEY" \
-H "Content-Type: application/json" \
-d '[
{
"taskType": "upscale",
"taskUUID": "c9359b21-16a3-44ef-aa71-f089c59c1006",
"model": "runware:500@1",
"upscaleFactor": 2,
"settings": {
"positivePrompt": "Preserve the exact group composition, all eight rescuers, their individual faces, poses, equipment and the retired border collie seated at center. Enhance realistic facial definition, individual fur strands, rope fibers, scratched helmets, woven technical fabrics, metal carabiners and damp limestone texture. Maintain the existing warm work-light and cool cave-shadow balance, documentary realism and seamless integration of the added dog without changing subject identity or placement.",
"negativePrompt": "Changed faces, altered poses, missing or additional people, duplicated limbs, extra dogs, shifted subjects, modified equipment, artificial fur, plastic skin, halos, cutout edges, oversharpening, invented text, changed composition"
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/0a72bbe8-2013-4cc3-8d06-72fa00780c08.jpg"
}
}
]'runware run runware:500@1 \
upscaleFactor=2 \
settings.positivePrompt="Preserve the exact group composition, all eight rescuers, their individual faces, poses, equipment and the retired border collie seated at center. Enhance realistic facial definition, individual fur strands, rope fibers, scratched helmets, woven technical fabrics, metal carabiners and damp limestone texture. Maintain the existing warm work-light and cool cave-shadow balance, documentary realism and seamless integration of the added dog without changing subject identity or placement." \
settings.negativePrompt="Changed faces, altered poses, missing or additional people, duplicated limbs, extra dogs, shifted subjects, modified equipment, artificial fur, plastic skin, halos, cutout edges, oversharpening, invented text, changed composition" \
inputs.image=https://assets.runware.ai/assets/inputs/0a72bbe8-2013-4cc3-8d06-72fa00780c08.jpg{
"taskType": "upscale",
"taskUUID": "c9359b21-16a3-44ef-aa71-f089c59c1006",
"model": "runware:500@1",
"upscaleFactor": 2,
"settings": {
"positivePrompt": "Preserve the exact group composition, all eight rescuers, their individual faces, poses, equipment and the retired border collie seated at center. Enhance realistic facial definition, individual fur strands, rope fibers, scratched helmets, woven technical fabrics, metal carabiners and damp limestone texture. Maintain the existing warm work-light and cool cave-shadow balance, documentary realism and seamless integration of the added dog without changing subject identity or placement.",
"negativePrompt": "Changed faces, altered poses, missing or additional people, duplicated limbs, extra dogs, shifted subjects, modified equipment, artificial fur, plastic skin, halos, cutout edges, oversharpening, invented text, changed composition"
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/0a72bbe8-2013-4cc3-8d06-72fa00780c08.jpg"
}
}Response
{
"taskType": "imageUpscale",
"taskUUID": "c9359b21-16a3-44ef-aa71-f089c59c1006",
"imageUUID": "45d0a12e-7e92-43ab-addc-5431739ec4f6",
"imageURL": "https://im.runware.ai/image/os/a08dlim3/ws/4/ii/45d0a12e-7e92-43ab-addc-5431739ec4f6.jpg",
"cost": 0.0045,
"inputImageUUID": "c4973f93-e6f5-4a9f-963c-0083f54fcb7f"
}