Skip to main content

​
POST /v1/breakdown

Start a deep, structured breakdown of a video or image. This is an async operation — the response returns an ID you can poll with GET /v1/breakdown.

​
Request body

FieldTypeRequiredDescription
mediaUrlstringYesPublic URL of the video or image to analyze
mediaTypestringYesvideo or image
promptstringNoFocus the analysis on a specific aspect (e.g. “hook effectiveness”, “pacing”, “visual quality”)

​
Example request

curl -X POST https://api.vidjutsu.ai/v1/breakdown \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: vj_live_abc123..." \
  -d '{
    "mediaUrl": "https://cdn.example.com/video.mp4",
    "mediaType": "video",
    "prompt": "Analyze the hook and first 3 seconds"
  }'

​
Example response

{
  "id": "va_abc123",
  "status": "processing"
}

​
Response fields

FieldTypeDescription
idstringBreakdown ID — use this to poll for the result
statusstringprocessing or completed

​
Credits

10 credits ($1.00) per call. Charged at creation time.

​
Next step

Poll GET /v1/breakdown?id=va_abc123 until status is completed. See Get breakdown.