TESSEN Platform
Documentation
TESSEN DOCUMENTATION

Build with Tessen.

The API, the model families, Project ZERO Alpha and the tools around them, documented as they run in production.

Start here.

Choose the path closest to the work in front of you.

From first request to operation.

Explore the reference.

What is available today, what is restricted, and what is not available is stated on every page.

01

API reference

Every endpoint the production Gateway supports for developers.

Open reference
02

Model families

Z1, Z1 Code and H1: use cases, features, access and approved prices.

Choose a model
03

Billing

Token pricing, the prepaid wallet and how access works today.

Billing guide
04

Project ZERO Alpha

Free, private coding capacity: enrollment, limits and the CLI.

ZERO Alpha

All documentation.

Get started

  • IntroductionWhat Tessen's developer platform offers today, who can use each part, and where to start.
  • QuickstartFrom a new Tessen account to a first API response.
  • AuthenticationHow to authenticate a request to the Tessen API, and what a key can and cannot do.
  • API keysCreate a key in the Console, use it once, and revoke it when you are done.
  • First API requestSend one chat completion, read the answer and the usage, and know what each field means.
  • PlaygroundTry a model in the Console with a real streamed request and see the tokens and the cost.

Models

  • Models overviewThe model ids you can send to the Tessen API, what each is for, and who can call it today.
  • Z1Tessen's general-purpose model family for chat, writing, analysis and everyday product features.
  • Z1 CodeTessen's coding model family: generating, explaining, reviewing and fixing code.
  • H1Tessen's highest-capability family: it reasons before it answers, for harder multi-step problems.
  • Project ZERO AlphaA free, private developer program: Tessen intelligence for real coding work, in OpenCode and over the API.
  • What ZERO Alpha isA free developer program for coding with Tessen, run on a separate allowance from paid inference.
  • Getting accessZERO Alpha access is granted per Tessen account, and you can check it at any time.
  • AuthenticationSign in from the Tessen CLI with a device code you approve in your browser. You never paste a key.
  • First coding requestWhat a good first ZERO Alpha task looks like in OpenCode.
  • LimitsZERO Alpha allows 200 requests a day and 30 a minute per developer, and resets at 00:00 UTC.
  • TroubleshootingEach ZERO Alpha failure, what it means, and the fix.
  • Model selectionA short method for choosing between Z1, Z1 Code, H1 and Project ZERO Alpha.
  • Pricing and availabilityThe approved price of each model family per million tokens, and who can call what today.

API reference

  • OverviewThe 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.
  • AuthenticationSend your API key as a Bearer token. Two endpoints need no key.
  • Chat completionsCreate a model response for a conversation. Supports streaming and tool calling.
  • StreamingReceive a chat completion as server-sent events, ending with a usage frame and `data: [DONE]`.
  • ModelsList the Gateway's model registry. It is not the list of models your account may call.
  • EmbeddingsTurn text into 384-dimension vectors. Up to 64 inputs per request.
  • ImagesImage generation is not enabled on the Tessen API today.
  • UsageRead your monthly request and token totals. For what you were charged, read the wallet ledger.
  • ErrorsThe error shapes, every status and code the documented endpoints return, and how to handle each.
  • Rate limitsWhat limits apply to each kind of request, and how a limit is reported.

Model capabilities

  • ConversationsThe API is stateless: you send the whole conversation with every request.
  • StreamingShow the answer as it is written, and read the cost from the last frame.
  • Tool callingLet a model ask your code to run a function, then give it the result.
  • Structured responsesThe API does not enforce a JSON schema. Ask for JSON and validate what comes back.
  • Context and token usageWhat a token is for billing, where to read the counts, and the limits that apply.
  • Reasoning controlsSome models reason before they answer. There is no request parameter to set how much.

Developer tools

  • Tessen ConsoleWhere you create API keys, try models, and see your wallet and usage.
  • Tessen CodeTessen in the place you build: the terminal and OpenCode today.
  • Install the CLIInstall, upgrade and uninstall the Tessen CLI.
  • ZERO CLIEvery Tessen CLI command a ZERO Alpha developer uses.
  • OpenCode integrationHow Tessen appears in OpenCode: one provider, one model, no secret in the config.
  • SDK examplesNo Tessen SDK package is published. OpenAI-compatible clients and plain HTTP both work.
  • Environment configurationWhere to keep your key and the base URL, in a shell, a `.env` file and CI.

Billing

  • Token pricingHow the cost of a request follows from its tokens and the published price.
  • Wallet and usageRead your prepaid balance and ledger, and your monthly usage, from the API or the Console.
  • Billing errorsWhat you see when the wallet cannot cover a request or an account cannot call a model, and what to do.
  • Pilot and production accessWhat is open to whom today, what is not open, and how that will change.

Resources

  • FAQsShort answers about access, models, billing and limits, each linking to the page with the detail.
  • TroubleshootingFind the symptom, read what it means, and apply the fix.
  • ChangelogNotable changes to the developer platform and its documentation, newest first.
  • Service statusLive service state is published at status.tessen.ai.
  • SupportWhere to ask, and what to include so the answer is quick.

Platform

  • Platform capabilitiesWhat Tessen can be asked to do — and what it registers, names and deliberately does not offer.
  • IntelligenceHow Tessen starts from intent and context, and how that differs from calling a model directly.
  • MemoryWhat Tessen remembers for a person, who controls it, and what is not offered to integrations.
  • ConnectHow a person lets Tessen reach the services they use, with permission shown and revocable.
  • Work and executionsA plan, its stages, and why creating one returns before the work is done.
  • Developer policiesThe terms and notices that apply to building with Tessen.

Execution API (preview)

  • OverviewThe execution API of the Tessen web application: every documented endpoint, at the contract its handler enforces.
  • AuthenticationA session for a person, an API key for a program, and what no key may ever do.
  • First requestRead what Tessen can do, then start an execution with a key and read it back.
  • UsageRequest volume, errors and latency — and the two things Tessen cannot yet tell you.
  • ErrorsOne shape, a stable status vocabulary, and the cases where a 404 is deliberate.

Tessen Node

  • OverviewTessen Node: the participation layer for Tessen's distributed compute. Not yet released.
  • InstallInitial target requirements for the public Node program.
  • Connect to the Zero PoolHow verified Node capacity is planned to widen ZERO Alpha's capacity.
  • Capacity and contributionNode discovers what a machine can do; you decide what it contributes.
  • Status and troubleshootingWhere Tessen Node stands today: pre-release, with nothing to install or troubleshoot yet.

Support · Changelog · Service status

Search documentation

Titles, headings and guides↑ ↓ navigate · Enter open