API REFERENCE
API reference overview
The Tessen API is an HTTPS JSON API at https://api.tessen.ai/v1. This page lists every endpoint Tessen supports for developers and its status.
| Item | Value |
|---|---|
| Base URL | https://api.tessen.ai/v1 |
| Authentication | Authorization: Bearer tes_... (all endpoints except the two marked public) |
| Content type | application/json, UTF-8. Streaming responses are text/event-stream. |
| Format | Chat completions follow the OpenAI chat format. The differences are documented on each page. |
| Health | GET https://api.tessen.ai/health returns {"status":"ok"}. Public. |
Endpoints
| Method and path | Purpose | Status |
|---|---|---|
POST /v1/chat/completions | Chat completions on Z1, Z1 Code, H1 and Project ZERO. Streaming and tool calling. | Available. Models are restricted. |
GET /v1/models | The Gateway's model registry (legacy entries; not your entitlements). | Available |
POST /v1/embeddings | 384-dimension vectors for up to 64 inputs. | Available |
POST /v1/images/generate | Image generation. | Not available. Answers 404 capability_unavailable. |
GET /v1/economy/usage | Your monthly usage totals. | Available |
GET /v1/wallet/balance, GET /v1/wallet/ledger | Your prepaid wallet and its ledger. | Available |
GET /v1/pricing/families | The published price of each model family. | Available. Public: no key. |
GET /v1/zero/status | Your ZERO Alpha enrollment, capacity and daily allowance. | Available |
Limit
The production Gateway serves other routes that Tessen's own products use (memory, jobs, files, tools and others). They are not part of the documented developer contract, may change without notice, and are not described here.
Conventions
- Errors are JSON. Application errors are
{ "error": { "code", "message" } }; request-validation errors (422) and a few input errors (400) are{ "detail": ... }. See Errors. - Money is in US dollars. Prices are per one million tokens.
- Times are ISO 8601 in UTC, except the
createdfield of a chat response, which is Unix seconds. - Send an explicit
modelon every chat request.