> ## Documentation Index > Fetch the complete documentation index at: https://docs.magnific.com/llms.txt > Use this file to discover all available pages before exploring further. # Improve Prompt - Enhance prompt > 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 ## OpenAPI ````yaml post /v1/ai/improve-prompt openapi: 3.0.0 info: description: >- The Magnific API is your gateway to a vast collection of high-quality digital resources for your applications and projects. As a leading platform, it offers a wide range of graphics, including vectors, photos, illustrations, icons, PSD templates, and more, all curated by talented designers from around the world. title: Magnific API version: 1.0.0 servers: - description: B2B API Production V1 url: https://api.magnific.com security: - magnificApiKey: [] paths: /v1/ai/improve-prompt: post: tags: - improve-prompt summary: Improve Prompt - Enhance prompt description: > 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 operationId: create_improve_prompt_task requestBody: content: application/json: examples: image-prompt: $ref: '#/components/examples/request-improve-prompt-image' video-prompt: $ref: '#/components/examples/request-improve-prompt-video' all-params: $ref: '#/components/examples/request-improve-prompt-all-params' schema: $ref: '#/components/schemas/request_12' required: true responses: '200': $ref: '#/components/responses/task-detail-200-default-response' '400': $ref: '#/components/responses/400-bad-request' '401': $ref: '#/components/responses/401-unauthorized' '500': $ref: '#/components/responses/500-internal-server-error' '503': $ref: '#/components/responses/503-service-unavailable' components: examples: request-improve-prompt-image: description: Example request to improve a prompt for image generation using Gemini summary: Improve Prompt Request - Image Type value: prompt: A beautiful landscape type: image request-improve-prompt-video: description: Example request to improve a prompt for video generation using OpenAI summary: Improve Prompt Request - Video Type value: prompt: A cat playing with a ball type: video language: en request-improve-prompt-all-params: description: Example request with all available parameters including webhook summary: Improve Prompt Request - All Parameters value: prompt: Un paisaje hermoso con montañas type: image language: es webhook_url: https://your-app.com/webhooks/improve-prompt 200-task-created: summary: Success - Task created value: data: generated: [] task_id: 046b6c7f-0b8a-43b9-b35d-6489e6daee91 status: CREATED 200-task-in-progress: summary: Success - Task in progress value: data: generated: [] task_id: 046b6c7f-0b8a-43b9-b35d-6489e6daee91 status: IN_PROGRESS 200-task-completed: summary: Success - Task completed value: data: generated: - https://ai-statics.freepik.com/completed_task_image.jpg task_id: 046b6c7f-0b8a-43b9-b35d-6489e6daee91 status: COMPLETED 200-task-failed: summary: Success - Task failed value: data: generated: [] task_id: 046b6c7f-0b8a-43b9-b35d-6489e6daee91 status: FAILED schemas: request_12: properties: prompt: description: >- Text prompt to improve for AI generation. Can be empty to generate a creative prompt. example: A beautiful landscape maxLength: 2500 type: string type: description: Type of generation (image or video) enum: - image - video example: image type: string language: default: en description: >- Language code for the improved prompt (ISO 639-1 format). Defaults to English if not specified. example: en pattern: ^[a-z]{2}$ type: string webhook_url: description: > 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. example: https://www.example.com/webhook format: uri type: string required: - prompt - type type: object inline_object_4: example: data: generated: - https://openapi-generator.tech - https://openapi-generator.tech task_id: 046b6c7f-0b8a-43b9-b35d-6489e6daee91 status: CREATED properties: data: $ref: '#/components/schemas/task-detail_1' required: - data type: object inline_object: example: message: message properties: message: type: string type: object inline_object_1: properties: problem: $ref: '#/components/schemas/inline_object_1_problem' type: object inline_object_2: example: message: Internal Server Error properties: message: example: Internal Server Error type: string type: object inline_object_3: example: message: Service Unavailable. Please try again later. properties: message: example: Service Unavailable. Please try again later. type: string type: object task-detail_1: allOf: - $ref: '#/components/schemas/task' - properties: generated: items: description: URL of the generated image format: uri type: string type: array required: - generated type: object example: generated: - https://openapi-generator.tech - https://openapi-generator.tech task_id: 046b6c7f-0b8a-43b9-b35d-6489e6daee91 status: CREATED inline_object_1_problem: properties: message: example: Validation error type: string invalid_params: items: $ref: '#/components/schemas/inline_object_1_problem_invalid_params_inner' type: array required: - invalid_params - message type: object task: example: task_id: 046b6c7f-0b8a-43b9-b35d-6489e6daee91 status: CREATED properties: task_id: description: Task identifier format: uuid type: string status: description: Task status enum: - CREATED - IN_PROGRESS - COMPLETED - FAILED type: string required: - status - task_id type: object inline_object_1_problem_invalid_params_inner: properties: name: description: Name of the invalid parameter. example: page type: string field: description: Field of the invalid parameter. Mirrors `name`. example: page type: string reason: example: Parameter 'page' must be greater than 0 type: string required: - field - name - reason type: object responses: task-detail-200-default-response: content: application/json: examples: success - created task: $ref: '#/components/examples/200-task-created' success - in progress task: $ref: '#/components/examples/200-task-in-progress' success - completed task: $ref: '#/components/examples/200-task-completed' success - failed task: $ref: '#/components/examples/200-task-failed' schema: $ref: '#/components/schemas/inline_object_4' description: OK - The task exists and the status is returned 400-bad-request: content: application/json: examples: invalid_page: summary: Parameter 'page' is not valid value: message: Parameter 'page' must be greater than 0 invalid_query: summary: Parameter 'query' is not valid value: message: Parameter 'query' must not be empty invalid_filter: summary: Parameter 'filter' is not valid value: message: Parameter 'filter' is not valid generic_bad_request: summary: Bad Request value: message: Parameter ':attribute' is not valid schema: $ref: '#/components/schemas/inline_object' application/problem+json: examples: invalid_page: summary: Parameter 'page' is not valid value: message: Validation error invalid_params: - field: page reason: Parameter 'page' must be greater than 0 - field: per_page reason: Parameter 'per_page' must be greater than 0 schema: $ref: '#/components/schemas/inline_object_1' description: >- Bad Request - The server could not understand the request due to invalid syntax. 401-unauthorized: content: application/json: examples: invalid_api_key: summary: API key is not valid value: message: Invalid API key missing_api_key: summary: API key is not provided value: message: Missing API key schema: $ref: '#/components/schemas/inline_object' description: >- Unauthorized - The client must authenticate itself to get the requested response. 500-internal-server-error: content: application/json: schema: $ref: '#/components/schemas/inline_object_2' description: >- Internal Server Error - The server has encountered a situation it doesn't know how to handle. 503-service-unavailable: content: application/json: schema: $ref: '#/components/schemas/inline_object_3' description: Service Unavailable securitySchemes: magnificApiKey: description: > Your Magnific API key. Required for authentication. [Learn how to obtain an API key](https://docs.magnific.com/quickstart) in: header name: x-magnific-api-key type: apiKey ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.