Authentication Analyse Animate Cinematic Reel Photo Animate History Languages Deep reasoning Errors

CareerVideo API

Transcript-grounded career-video analysis and Director Brain–generated reels. Independent account and API keys — a csvm_live_* key only works on the endpoints below.

Authentication

Every request needs Authorization: Bearer <your-key>, where the key starts with csvm_live_ (or csvm_test_). Register, then generate a key from your dashboard. Base URL: https://api.careerstudiomax.com/api/csvm/v1.

Analyse a real video

POST/v1/analyse

Pulls the real transcript from a YouTube URL (or accepts one you paste directly) and extracts structured career intelligence — insights, skills, salary figures, companies mentioned — every field grounded in what the video actually said.

{
  "url": "https://youtube.com/watch?v=...",  // or "transcript"/"description" directly
  "focus": "salary negotiation",        // optional — narrows extraction focus
  "lang": "es", "langName": "Spanish",     // optional — see Languages below
  "reasoning": true                    // optional — see Deep reasoning below
}
{
  "success": true, "model": "careervideo-v1",
  "analysis": {
    "category": "salary_negotiation", "speakerRole": "recruiter",
    "keyInsights": [{ "insight": "...", "type": "TIP", "confidence": 0.95 }],
    "salaryData": [...], "skillsMentioned": [...], "companiesMentioned": [...],
    "qualityScore": 82, "language": "es", "model": "CSVM-1"
  }
}

Generate a short animation

POST/v1/animate

A short animation grounded in one specific insight — pass title and/or insight/summary. Returns immediately with a job id; poll GET /v1/animate/status/:id for the result.

Cinematic Reel — Director Brain

POST/v1/cinematic

A multi-scene, narrated reel planned by a reasoning layer from real extracted insight — not one prompt to one clip. Pass keyInsights (from a prior /analyse call) plus languageCode/languageName/voice for narration in the language you need. Returns a job id; poll GET /v1/cinematic/status/:jobId.

Photo to video + voice

POST/v1/photo-animate

A real uploaded photo (multipart field image), animated and narrated in the requested language via languageCode/languageName/voice. Poll GET /v1/photo-animate/status/:jobId.

Your call history

GET/v1/history

Your past requests on this key.

Languages — the honest breakdown

EndpointWhat "language" controlsReal coverage
/analyselang/langName — the extracted insight text itselfBroad text-based multilingual output — the model writes the extracted values in the language you request
/cinematic, /photo-animatelanguageCode/languageName/voice — real narration audioA specific, real, trained-voice language set — request one to see it echoed back in the job result; not every language text analysis supports has a trained voice yet

We don't publish one flat "N languages supported" number on this page, because it isn't one honest number across both rows above. Request the language you need and read what comes back — the response always tells you what actually ran, never what we'd like to claim ran.

Deep reasoning

Pass "reasoning": true on /analyse to raise the model's internal effort/complexity tier for that one call — useful for a long or dense transcript where the default pass might miss nuance. Off by default, real added latency, no extra cost: it's still the same self-hosted model, just told to think harder about this one video, never escalated to an external provider.

Errors

Every error response is JSON with a code and a message. Rate limits are set per key based on your plan — see pricing.