---
title: "Render an image using Explore tool"
method: POST
path: "/images/{imageId}/render/explore"
---

# Render an image using Explore tool

`POST /images/{imageId}/render/explore`

## Request

- Base URL: `https://app.visoid.com/api/v1`
- URL: `https://app.visoid.com/api/v1/images/{imageId}/render/explore`
- Auth: none declared

_This operation costs_ **3 credits** for 1K, **5 credits** for 2K, and **10 credits** for 4K (controlled by the `quality` parameter).

It is possible to pass a Base64 image mask (`input.mask`) to select only parts of the image that should be changed.

## Path parameters

- `imageId` string, uuid, required

## Request body

- RenderExploreBody
  - `callbackUrl` string, uri: URL called when task is finished. Endpoint will be called using **POST** method with a body containing: - `imageId` the rendered image - `sourceImageId` the original image from which the rendering was made - `status` the state of the operation, could be `completed` or `failed`
  - `quality` '1K' | '2K' | '4K': Resolution of the rendered image. Costs **3 credits** for 1K, **5 credits** for 2K, and **10 credits** for 4K.
  - `style` 'realistic' | 'vector-sketch' | 'vector-illustration' | 'watercolor-sketch' | 'watercolor-collage' | 'highlighted-sketch' | 'pastel-concept' | 'post-digital-collage' | 'ink-sketch': Visual style applied to the render.
  - `input` object, required: Minimal required setting is `input.positivePrompt`
    - `positivePrompt` string
    - `freedom` number
    - `mask` string: Base64 encoded image mask. **The mask should have the same dimensions as the input image.** **The selected part of the image should be white, while the non-selected part should be fully transparent using the alpha channel**

## Response `202`

Rendering task started

- object: ID of the created image
  - `id` string, uuid

## Other responses

- `404`: No image corresponding to the imageId

---

[API](https://skmtc.dev/visoid/apis/visoid-public-api.md) - [All operations](https://skmtc.dev/visoid/apis/visoid-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/visoid/apis/visoid-public-api/revisions/e75f7f5507e0?raw)