---
title: "Describe Media"
method: POST
path: "/api/v1/ai/{provider}/describe-media"
tags: ["api", "api", "ai"]
---

# Describe Media

`POST /api/v1/ai/{provider}/describe-media`

## Request

- Base URL: `https://www.faroz.uz` (the document declares no server; this is the origin it was published from)
- URL: `https://www.faroz.uz/api/v1/ai/{provider}/describe-media`
- Auth: HTTP bearer

Metadata asosida media (video/audio/rasm) uchun tavsif yozadi (≤5000).

## Path parameters

- `provider` 'claude' | 'gpt' | 'gemini' | 'deepseek', required: Qaysi AI provayderdan foydalanish. URL prefiksi sifatida ham ishlatiladi: /api/v1/ai/{provider}/...

## Request body

- DescribeMediaRequest: Metadata asosida media uchun tavsif generatsiyasi.
  - `media_type` 'video' | 'audio' | 'image'
  - `title` string, required: Media sarlavhasi
  - `current_description` string: Admin yozgan qoralama (bo'lsa, yaxshilanadi)
  - `tags` string[]
  - `genres` string[]
  - `categories` string[]
  - `language` string

## Response `200`

Successful Response

- DescribeMediaResponse
  - `description` string, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/faroz/apis/edu-app-api.md) · [All operations](https://skmtc.dev/faroz/apis/edu-app-api/llms.txt) · [OpenAPI document](https://skmtc.dev/faroz/apis/edu-app-api/revisions/414a551ba773?raw)