Register Custom Model

Register a custom language model with the organization that owns the API key.

The model configuration is validated by making a test API call before saving.

POST /models/custom

Register Custom Model

cURL

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

200

{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "name": "<string>",
  "identifier": "<string>",
  "provider": "<string>",
  "type": "llm",
  "extra": {}
}

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 custom language model

Required string length: 1 - 255

identifier · string · required

The identifier of the custom language model (e.g. openai/gpt-4o, azure/gpt-5)

Required string length: 1 - 255

provider · string | null

Provider name (auto-detected from identifier if not specified)

type · string | null · default: llm

Model type: 'llm' (default), 'embedding', or 'image'

extra · Extra · object

Provider-specific configuration (e.g. api_base, api_version, region)

api_key · string | null

The API key or credentials for the model

Response

200

application/json

Successful Response

id · string<uuid> · required

The ID of the custom language model

name · string · required

The name of the custom language model

identifier · string · required

The identifier of the custom language model

provider · string | null

Provider name

type · string | null · default: llm

Model type: llm, embedding, or image

extra · Extra · object

Provider-specific configuration