# DRAMA API quickstart

Full reference: https://docs.drama.syncmonster.ai/

## Authentication

Send your key in the `x-api-key` header on every request. Never put it in browser code.

Base URL: `https://studio.syncmonster.ai/neuralgarage/saas/api/v1/clients`

## One-step flow (single-face videos)

1. `POST /generate` with `skip_find_face=1`, `is_drama=true`, the video, the audio and `drama_params`. Returns a `request_id`.
2. `GET /get-status?request_id=...` every few seconds until `data.status` is `Success`.
3. `GET /get-file?request_id=...` returns the MP4.

~~~python
import json, time, requests

BASE = "https://studio.syncmonster.ai/neuralgarage/saas/api/v1/clients"
H = {"x-api-key": "YOUR_API_KEY"}

with open("clip.mp4", "rb") as v, open("clip.mp3", "rb") as a:
    r = requests.post(f"{BASE}/generate", headers=H,
        data={"skip_find_face": 1, "is_drama": "true",
              "drama_params": json.dumps({"happy": 0.8})},
        files={"video": v, "audio": a})
rid = r.json()["data"]["request_id"]

while True:
    s = requests.get(f"{BASE}/get-status", headers=H,
                     params={"request_id": rid}).json()["data"]["status"]
    if str(s).lower() == "success":
        break
    if str(s).lower() == "failed":
        raise RuntimeError("DRAMA job failed")
    time.sleep(5)

out = requests.get(f"{BASE}/get-file", headers=H, params={"request_id": rid})
open("drama.mp4", "wb").write(out.content)
~~~

## Multi-face videos

Run `POST /v2/find-face`, poll `GET /v2/find-face/status`, list faces with `GET /v2/get-face` (each has a `global_face_id` and a preview image), then call `POST /generate` with `find_face_id` and the chosen `global_face_id`.

## Emotions

`happy`, `sad`, `excited`, `angry`, each 0–1. `happy` and `sad` share one axis.

## Credits

Face detection 0.5 credits per second of video, drama 1 credit per second. Check your balance with `GET /get-credits`.

## Errors

| Code | Meaning |
| --- | --- |
| ERR_004 | No face detected |
| ERR_006 | Not enough credits |
| ERR_007 | File corrupted |
| ERR_008 | Unsupported format (use .mp4, .mov, .mp3, .wav) |
| ERR_009 | Video too long |

## Getting a key

[How to get access, and the support link.]