API REFERENCE · CREATORS & CONTROL
Context
One sentence on what the channel, stream, or video is: the names of the people on screen and what kind of video it is. It sharpens translation the way a human translator's briefing would.
01.What context does
The translator reads it before every line -- so "Maya" stays a name instead of becoming a word, jargon resolves the right way, and running jokes keep their setup. Write it like you'd brief a human: who is on screen, what the video is.
Context attaches at the same three scopes as Do Not Translate (creator · stream · job), one sentence per scope; narrower wins -- The three scopes.
02.Set it
/v1/contextcurl -X PUT https://api.thefamiliarlab.com/v1/context \
-H "Authorization: Bearer $FAMILIAR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"sentence": "A chess channel: openings, blunders, and speedruns.",
"scope": "creator",
"scope_key": "cr_8f2k1q"
}'| FIELD | TYPE | REQUIRED | DESCRIPTION |
|---|---|---|---|
sentence | string | yes | The one-sentence brief. PUT replaces the scope's previous sentence. |
scope | string | yes | creator · stream · job. |
scope_key | string | yes | The matching ID: creator_id, session_id, or dub_id. |
03.Read it
/v1/context?scope=creator&scope_key=cr_8f2k1q{
"sentence": "A chess channel: openings, blunders, and speedruns.",
"scope": "creator",
"scope_key": "cr_8f2k1q",
"updated_at": "2026-08-13T15:12:44Z"
}A scope with no sentence returns 404.
04.Per-job context
The context field on POST /v1/dubs is a shortcut for the job scope -- one video, no separate write. The context field on POST /v1/live/sessions writes the stream scope the same way, and the session remembers it for its next run.
05.Access
The API is enterprise-only: private access under a Studio contract, with volume pricing, raised limits, and a named point of contact for the integration. Book a call and your key is issued with the contract.