TessaRun

API preview · built for humans and agents

Prompt in.
Durable asset out.

Give your application content storage, managed image and video generation, durable operations, signed webhooks, and usage attribution through one workspace-scoped API.

Create a workspace key Read the docs

create_generation.sh 

curl https://api.tessarun.com/api/v1/generations \
  -H "Authorization: Bearer $TESSARUN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "krea-2",
    "tenant": "customer-42",
    "params": {
      "prompt": "A copper robot in a daylight studio",
      "aspect_ratio": "4:5"
    },
    "metadata": {"project": "launch"}
  }'
202 accepted Fixed price Full refund on failure

Quickstart

One key.
Three steps.

The API is asynchronous because image and video work is durable. Your product can restart without losing the operation.

  1. 01

    Control plane

    Create a workspace API key

    Sign in, choose the isolated workspace that should own the content and usage, then create a key. The plaintext value is shown once.

    Open the developer console ↗
  2. 02

    Data plane

    Submit a priced generation

    Send a logical model ID and generation parameters. TessaRun validates the request and debits the fixed price only when work is accepted.

    Build the generation loop ↗
  3. 03

    Durable result

    Receive generation webhooks

    Register an HTTPS endpoint for the event types you need. Successful outputs become durable assets; failed generations receive a full balance refund.

    Configure webhooks ↗

Infrastructure surfaces

The parts your product should not rebuild.

Every resource stays scoped to the authenticated workspace. Pass your own tenant and metadata through TessaRun for downstream attribution without sharing your user model.

01 / MODELS

Logical model catalog

Discover stable image and video capabilities without coupling your code to provider-specific endpoints.

GET /models

02 / ASSETS

Direct media storage

Create short-lived upload and download URLs while TessaRun retains durable asset identity and metadata.

POST /assets

03 / WEBHOOKS

Generation event delivery

Receive signed generation events at the HTTPS endpoint selected for your Workspace.

POST /webhook_endpoints

04 / USAGE

Attributable economics

Read successful usage and immutable balance entries with your tenant and metadata values returned intact.

GET /usage

Agent-ready documentation

Let the coding agent read the contract directly.

/llms.txtConcise documentation map↗ /llms-full.txtComplete agent context↗ /openapi.yamlOpenAPI 3.1 contract↗