# TessaRun

> TessaRun is managed content and generative AI infrastructure for software built by developers and coding agents. It provides workspace-isolated media storage, image and video generation, durable operations, signed webhook events, usage attribution, and prepaid billing through one HTTP API.

TessaRun customers build their own products and workflows. They do not run TessaRun code, share their downstream user identities, or manage GPU infrastructure. The current API is an implementation preview; use the OpenAPI document as the canonical interface contract.

## Documentation

- [Developer portal](https://tessarun.com/developers): Start here for the quickstart, supported surfaces, and machine-readable documentation.
- [Documentation](https://tessarun.com/docs): Core concepts, integration workflow, reliability guidance, and API endpoint reference.
- [Complete agent reference](https://tessarun.com/llms-full.txt): Self-contained implementation context for coding agents.

## Machine-readable contracts

- [OpenAPI 3.1](https://tessarun.com/openapi.yaml): Canonical request, response, parameter, and schema definitions.
- [LLM documentation map](https://tessarun.com/llms.txt): This concise documentation index.

## Console

- [Create a developer account](https://tessarun.com/sign-up): Create an infrastructure account and workspace API key.
- [Developer sign in](https://tessarun.com/sign-in): Access workspaces, balance, API keys, models, and recent generations.

## Key integration facts

- API base URL: `https://api.tessarun.com/api/v1`
- Authentication: `Authorization: Bearer <workspace-api-key>`
- Initial executable models: `krea-2` and `minimax-h3`
- Generation requests are asynchronous. Each `POST /generations` creates a new generation.
- Register a webhook endpoint and select the generation event types your application needs.
- Verify webhook timestamps and HMAC signatures against the exact raw request body.
- Every API key belongs to exactly one isolated workspace.
- Use `metadata` for customer-defined identifiers and context; TessaRun returns it unchanged.
- Failed generations receive a full customer refund.
- Customer-requested cancellation is not supported in the v1 preview.