Create Model Alias

Create a model alias with fallback models for the organization that owns the API key.

A model alias allows you to define a name that resolves to an ordered list of fallback models. For example, you could create an alias called “sonnet-4” that falls back to [“anthropic/claude-3-5-sonnet-latest”, “anthropic/claude-3-5-sonnet-20241022”].

POST /models/aliases

Create Model Alias

cURL

curl --request POST \
  --url https://api.opper.ai/v2/models/aliases \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "fallback_models": [
    "<string>"
  ]
}
'

200

{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "name": "<string>",
  "fallback_models": [
    "<string>"
  ],
  "description": "<string>"
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

name · string · required

The name of the model alias

Required string length: 1 - 255

fallback_models · string[] · required

Ordered list of model names to try as fallbacks

Minimum array length: 1

description · string | null

Optional description of the model alias

Maximum string length: 1000

Response

200

application/json

Successful Response

id · string<uuid> · required

The ID of the model alias

name · string · required

The name of the model alias

fallback_models · string[] · required

Ordered list of model names to try as fallbacks

description · string | null

Optional description of the model alias