API reference

OOOI AI API

JSON over HTTPS. The search endpoint is live on the demo index today; indexing, ask and usage endpoints open with API keys.

POST/api/public/v1/searchLive

Hybrid semantic + BM25 search over indexed moments. Returns ranked moments and a cited answer.

Request

{ "query": "giant robot battle", "top_k": 5, "filters": { "video_id": "vid_steel" } }

Response

{
  "query": "giant robot battle",
  "mode": "hybrid",
  "answer": "The battle happens in the old church [vid_steel_m4].",
  "results": [{
    "moment_id": "vid_steel_m4", "video_id": "vid_steel",
    "title": "Tears of Steel — sci-fi short",
    "start_time": 230, "end_time": 300,
    "matched_text": "Battle in the old church…",
    "visual_summary": "Explosions inside a ruined church…",
    "confidence_score": 0.94, "source_url": "https://…"
  }]
}

POST/v1/videosBeta

Submit a file or URL for indexing; returns a job_id.

Request

{ "url": "https://youtube.com/watch?v=…" }

Response

{ "job_id": "job_…", "status": "queued" }

GET/v1/videos/{id}Beta

Indexing status, metadata and moments.

Response

{ "id": "vid_…", "status": "ready", "moments": [ … ] }

POST/v1/askBeta

RAG answer with cited video moments.

Request

{ "question": "What did we decide about pricing?" }

Response

{ "answer": "…", "citations": [ … ] }

GET/v1/usageBeta

Quota and metering for your API key.

Response

{ "minutes_indexed": 42, "quota": 60 }