API reference
Models
Available from Phases 3 to 3b
The HTTP API is not live yet. These endpoints are the planned contract, generated from the same schema the server will use. Paths and fields can still change before they ship.
GET
/api/v1/modelsAuthorizationBearer <token>
An app token (sk_live_, sk_test_, pk_live_), a browser token (a 5-minute ES256 JWT) or an agent token (sa_live_).
In: header
Query Parameters
limit?integer
Range
1 <= value <= 200Default
50cursor?string
Length
1 <= lengthResponse Body
application/json
application/json
curl -X GET "https://example.com/api/v1/models"{ "data": [ { "id": "string", "family": "string", "kind": "versioned", "aliasTarget": "string", "status": "unreviewed", "releaseDate": "2019-08-24", "retireAt": "2019-08-24", "questionTypes": [ "noul" ], "limits": { "requestTokens": 1, "statePlusLongestQuestionTokens": 1, "rpm": 1, "tokensPerSec": 1 }, "inputModalities": [ "string" ], "weaknesses": [ "string" ], "supersedes": [ "string" ], "docsUrl": "http://example.com", "jaggednessUrl": "http://example.com", "lastReviewed": "2019-08-24", "isDefault": true } ], "nextCursor": "string"}GET
/api/v1/models/{id}AuthorizationBearer <token>
An app token (sk_live_, sk_test_, pk_live_), a browser token (a 5-minute ES256 JWT) or an agent token (sa_live_).
In: header
Path Parameters
id*string
Length
1 <= lengthResponse Body
application/json
application/json
curl -X GET "https://example.com/api/v1/models/string"{ "id": "string", "family": "string", "kind": "versioned", "aliasTarget": "string", "status": "unreviewed", "releaseDate": "2019-08-24", "retireAt": "2019-08-24", "questionTypes": [ "noul" ], "limits": { "requestTokens": 1, "statePlusLongestQuestionTokens": 1, "rpm": 1, "tokensPerSec": 1 }, "inputModalities": [ "string" ], "weaknesses": [ "string" ], "supersedes": [ "string" ], "docsUrl": "http://example.com", "jaggednessUrl": "http://example.com", "lastReviewed": "2019-08-24"}GET
/api/v1/model-upgradesAuthorizationBearer <token>
An app token (sk_live_, sk_test_, pk_live_), a browser token (a 5-minute ES256 JWT) or an agent token (sa_live_).
In: header
Response Body
application/json
application/json
curl -X GET "https://example.com/api/v1/model-upgrades"nullBandwise is an independent product built on TypeSafe's System One models. It is not TypeSafe's documentation. For the System One models themselves, see docs.typesafe.ai.