Great Stories — Generation

POST /v1/jobs

Create a new enrichment job. Use Authorization: Bearer <api_key>.

Request: Provide text and/or file_ids (upload files first via POST /v1/files).

{
  "text": "string (optional if file_ids provided)",
  "file_ids": ["uuid", "..."],
  "type": "educational | financial | fictional",
  "segments_count": "integer (1–max from config)",
  "audio_type": "free_speech | podcast",
  "fact_check_needed": "boolean (optional, default false)",
  "webhook": { "url": "string (optional)", "secret": "string (optional)" }
}

POST /v1/files — Upload a file (multipart form, field file). Returns file_id. Use these IDs in file_ids when creating a job.

Response (202): { "job_id", "status": "queued", "created_at" }

GET /v1/jobs/{job_id}

Get job status, segments, and assets (with download URLs).

GET /v1/jobs

List your jobs (with pagination).

GET /v1/assets/{asset_id} / GET /v1/assets/{asset_id}/content

Asset metadata and pass-through content.