---
title: "Playground image edit"
method: POST
path: "/api/v1/{workspaceID}/playground/images/edits"
tags: ["Playground Images"]
---

# Playground image edit

`POST /api/v1/{workspaceID}/playground/images/edits`

## Request

- Base URL: `https://ai.liara.ir`
- URL: `https://ai.liara.ir/api/v1/{workspaceID}/playground/images/edits`
- Auth: API key in header `Authorization`

Edits images in the playground. Requires `ai.operate` or `ai.manage` permission.
Requires `multipart/form-data` content type.

## Path parameters

- `workspaceID` string, required

## Request body `multipart/form-data`

- object
  - `image` string[]
  - `prompt` string
  - `model` string
  - `mask` string, binary

## Response `200`

Successful response

- object

## Other responses

- `401`: Missing authentication
- `403`: Forbidden
- `503`: Service temporarily unavailable.

---

[API](https://skmtc.dev/liara-cloud/apis/ai-playground.md) - [All operations](https://skmtc.dev/liara-cloud/apis/ai-playground/llms.txt) - [OpenAPI document](https://skmtc.dev/liara-cloud/apis/ai-playground/revisions/865035acf0a0?raw)