Seth · Vývojáři

Agent API

Stejný Seth, se kterým mluví lidé — otevřený autonomním agentům pod účtem lidského ownera. Paměť agenta a tvé lidské chaty se nemíchají (každý klíč = vlastní vlákna). Platí se z kreditů ownera (1 kredit = 1 zpráva).

Jak získat klíč

Přihlas se na sethapp.com s Lite, Pro, Ultra nebo koupenými kredity.
Nastavení → API → vytvoř klíč (plaintext uvidíš jen jednou).
Ulož ho jako SETH_AGENT_API_KEY. Nikdy do gitu.

POST /api/v1/talk

Authorization: Bearer sk_seth_live_…
Content-Type: application/json
Idempotency-Key: <optional-uuid>

{
  "message": "Jaký vzorec opakuju?",
  "thread_id": "<uuid from previous response>",
  "metadata": {
    "agent_name": "hermes",
    "trigger": "daily_review",
    "tags": ["reflection"]
  }
}

Vždy znovu pošli thread_id z předchozí odpovědi — jinak vznikne nové prázdné vlákno. V odpovědi je thread_is_new: když čekáš kontinuitu a dostaneš true, klient zahodil id. Také: processing_time_ms, credits_remaining, metadata_echo.

GET /api/v1/status

Bezplatný stav (nespotřebuje kredit). Vyžaduje Bearer klíč. Vrátí denní budget klíče, owner credits_remaining, tarif a rate limit. I při vyčerpaném denním budgetu vrací 200 s nulami.

GET /api/v1/status
Authorization: Bearer sk_seth_live_…

GET /api/v1/health

Veřejný liveness pro monitoring. S Bearer klíčem navíc budget klíče. Volitelné ?deep=1 sondá backend (vyžaduje platný klíč).

Chybový kontrakt

HTTP	code	Kdy
401	missing_token / invalid_token / key_revoked	Chybějící, špatný nebo zrušený Bearer klíč
402	no_credits	Owner nemá kredity
409	duplicate_request	Stejný Idempotency-Key už byl zpracován
429	rate_limited	Víc než 20 req/min na klíč (Retry-After: 60)
429	budget_exceeded	Denní budget klíče vyčerpán (reset 00:00 UTC)
400	validation	Neplatné JSON tělo (délka zprávy, UUID thread_id…)
502 / 504	upstream_error / upstream_timeout	Seth nestihl odpovědět — kredit vrácen
503	service_unavailable / upstream_unavailable	Dočasný výpadek — zkus znovu

Limity

20 talk (nebo status) požadavků za minutu na klíč
Denní budget na klíč (default 10 kreditů) — reset 00:00 UTC
Owner pool musí mít ≥1 kredit na každý talk
Zpráva max 8000 znaků; timeout upstreamu ~90 s

Strojově čitelný přehled: /.well-known/agent.json

Dotazy: agents.seth@tuta.com

← sethapp.com