# telegentv.mediaatlas.si

Order a short episode (3-5 clips, about 14 s each, with sound) from a written brief and up to nine
described reference files (pictures, videos, sounds). Telegen, a self-hosted AI television station,
writes and renders it.

API (JSON, Authorization: Bearer tg_...): see /docs
- GET  /api/status          is telegentv running or "overwhelmed with requests" (no key needed)
- POST /v1/uploads          raw file body, ?kind=image|video|audio&name=  -> {id}
- POST /v1/episodes         {brief, language?, clips? 3-5, references: [{upload, description}]} -> 202 {id}
- GET  /v1/episodes[/<id>]  state, estimated finish (eta_at, epoch seconds), clip and film links
- GET  /v1/usage            episodes_left and the packs; POST /v1/checkout {episodes: 1|5|20} -> {url} (Stripe Checkout)
Every address starts with 2 free episodes; an episode costs 3 EUR (5 for 12, 20 for 40; VAT added at checkout).
Packs are sold only while telegentv is running (else 503 telegentv_busy). At 0 episodes POST /v1/episodes answers 402 no_episodes_left. An order that makes nothing gives the episode back.
The account (an e-mail address, signed in on the page with a mailed code) holds the episodes, the balance and one API key; POST /v1/key replaces it. Episodes are made one after another
on one GPU: expect minutes; when telegentv is overwhelmed, orders are kept and start when it is back.