Bygg

API

Deep Thought Clouds REST-API, som ingår i Premium: autentisering, uppladdning, källor, sökning och åtgärder.

Skiss: ett tomt kort som passerar genom ett brevinkast och fortsätter som mindre kort sorterade i tre brickor; inkastets kant bär gradienten.

REST-API:t är samma plattform som apparna själva använder. Det ingår i Premium.

Bas-URL: https://api.deep-thought.cloud/api/v1

Autentisering

HTTP Basic, för dina skript
curl -u användarnamn:lösenord, eller Authorization: Basic, på alla endpoints. Kontrolleras mot planen vid varje anrop: utan Premium blir svaret 402, och ett konto som lämnar Premium förlorar åtkomsten vid nästa anrop.
Bearer-token, för apparna
POST /api/v1/auth/login, eller inloggning med Apple eller Google, ger den token som webbappen och record-me använder. Skicka den som Authorization: Bearer <token>.
Enhetstoken, för Trillian
Paras i webbläsaren, begränsas till behörigheter (kb:read, kb:write, graph:read) och kan återkallas i webbappen under Inställningar, Enheter.
OAuth, för MCP-klienter
Utfärdas när du loggar in från en AI-assistent. Se sidan om MCP.

De viktigaste endpoints

Sökvägarna är relativa till bas-URL:en.

MetodSökvägVad den gör
POST/sources/uploadLadda upp en fil för bearbetning: ljud, video, PDF, bild eller dokument. Valfri språkangivelse och taggar.
GET/sources/{id}/statusBearbetningsstatus för en källa.
GET/sourcesDina källor, med sidindelning och filter (tagg, text, innehållstyp).
GET/sources/{id}En källa: transkript och extraktion.
POST/searchSemantisk sökning i dina källor, vid behov avgränsad med taggar.
GET/actionsDina åtgärder.
POST/actions/createSkapa en åtgärd.

Ladda upp, vänta, sök

Med HTTP Basic, från en terminal:

# 1. Ladda upp. Svaret innehåller id:t att fråga efter.
curl -u USER:PASSWORD -F file=@meeting.m4a -F language=sv \
  https://api.deep-thought.cloud/api/v1/sources/upload

# 2. Fråga tills statusen är done.
curl -u USER:PASSWORD https://api.deep-thought.cloud/api/v1/sources/SOURCE_ID/status

# 3. Sök i allt du har laddat upp.
curl -u USER:PASSWORD -H 'Content-Type: application/json' \
  -d '{"query": "what was decided about the launch", "n_results": 5}' \
  https://api.deep-thought.cloud/api/v1/search

Vad det inte gör

  • Det skickar inte resultat till dig. Fråga statusendpointen.
  • Det svarar inte ett skript i Gratis-planen. Webbappen, record-me och Trillian fungerar utan Premium.

Det som är planerat står på sidan om integrationer. Integrationer