---
title: "Improve Prompt - Enhance prompt"
method: POST
path: "/v1/ai/improve-prompt"
tags: ["improve-prompt"]
---

# Improve Prompt - Enhance prompt

`POST /v1/ai/improve-prompt`

## Request

- Base URL: `https://api.magnific.com`
- URL: `https://api.magnific.com/v1/ai/improve-prompt`
- Auth: API key in header `x-magnific-api-key`

Enhance user prompts for AI image or video generation using advanced AI models.
- **Image prompts**: Improve a prompt for image generation
- **Video prompts**: Improve a prompt for video generation

## Request body

- Request12
  - `prompt` string, required: Text prompt to improve for AI generation. Can be empty to generate a creative prompt.
  - `type` 'image' | 'video', required: Type of generation (image or video)
  - `language` string: Language code for the improved prompt (ISO 639-1 format). Defaults to English if not specified.
  - `webhook_url` string, uri: Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.

## Response `200`

OK - The task exists and the status is returned

- InlineObject4
  - `data` TaskDetail1, required
    - `task_id` string, uuid, required: Task identifier
    - `status` 'CREATED' | 'IN_PROGRESS' | 'COMPLETED' | 'FAILED', required: Task status
    - `generated` string[], required

## Other responses

- `400`: Bad Request - The server could not understand the request due to invalid syntax.
- `401`: Unauthorized - The client must authenticate itself to get the requested response.
- `500`: Internal Server Error - The server has encountered a situation it doesn't know how to handle.
- `503`: Service Unavailable

---

[API](https://skmtc.dev/magnific/apis/magnific-api.md) · [All operations](https://skmtc.dev/magnific/apis/magnific-api/llms.txt) · [OpenAPI document](https://skmtc.dev/magnific/apis/magnific-api/revisions/60711fb082c7?raw)