typesafe/docs/models.md

Documentation Index

Fetch the complete documentation index at: https://docs.typesafe.ai/llms.txt Use this file to discover all available pages before exploring further.

Models

Jev is TypeSafe's flagship model and the first System One model. Every model on this page is served by the same endpoint, POST /v1/systemone. The request's model field selects which one handles the call; see the API reference for the full request shape.

Current models

Jev 1.13	jev-1.13.0
Price (per Btok / per Mtok)	$42 / $0.042
Rate limits	250,000 tokens per second / 1,200 requests per minute

• Price: Charged per input token. Output tokens are free. A Btok is a billion tokens and an Mtok is a million tokens.
• Rate limits: Measured in tokens per second and requests per minute. A request over either limit returns 429 Too Many Requests. Our client SDKs retry with backoff by default and honor the retry-after header when the response carries one. If you call the HTTP API directly, see Handling rate limits.

**Rate limits are adjusting dynamically.** We are serving a very large volume of demand, and the limits above can change without notice while we do, as upcoming large GPU deals land and we let in more users. Once things settle down more, we'll be able to offer more stable limits. Higher limits are available on custom and enterprise plans. Contact [sales@typesafe.ai](mailto:sales@typesafe.ai).

Aliases

An alias is a model name that resolves to a versioned model ID. Send it in the model field like any other name.

Alias	Points to	Meaning
jev-latest	jev-1.13.0	The most recent stable, official release. The default in our client SDKs, and the name the examples in these docs use.
jev-preview	jev-1.13.0	The most recent release, whether or not it is an official one. Moves ahead of jev-latest when a preview build is available.

`jev-preview` currently points to the same model as `jev-latest`. There is no preview build available right now.

An alias moves when a new release ships, so the answers behind it can change without a change on your side. The response's model field reports the versioned ID that answered, so you can log which model produced each result. If you have tuned confidence thresholds against a specific version, pin that version's ID instead of the alias and move to the new one on your own schedule.

Listing models

GET /v1/models returns the names your account can send in the model field, with a description and release date for each. It currently lists the aliases. Versioned IDs such as jev-1.13.0 are accepted by the model field whether or not they appear in the list.

```bash cURL theme={null} curl https://api.typesafe.ai/v1/models \ -H "Authorization: Bearer $TYPESAFE_API_KEY" ```

from typesafe_sdk import TypeSafeClient

with TypeSafeClient() as client:
    for model in client.models.list().models:
        print(model.name, model.release_date, model.description)

import { TypeSafeClient } from "@typesafe-ai/sdk";

const client = new TypeSafeClient();
const models = await client.models.list();
for (const model of models) {
  console.log(model.name, model.release_date, model.description);
}

One entry per model or alias. The model ID or alias, as accepted by the `model` field.

<ResponseField name="description" type="string" required>
  What the model is for.
</ResponseField>

<ResponseField name="release_date" type="string" required>
  When the model or alias was released.
</ResponseField>

See the Python and JavaScript SDK references for the full method signatures.