Skip to Content
kosemdocs
GuidesLLM Gateway

Add models to your organization

Add a provider's models to your organization under aliases, and share each with the projects that can use it, without sharing the provider.

Add models to your organization, and share each with the projects that can use it. A project you share a model with adds that model, and no other, without the provider being shared with it. To add models, you need Owner or LLM Gateway Admin on the organization.

You need your organization's provider first, its key for the model provider: Add a provider shows how.

Add models

  1. In your organization, click LLM Gateway. It opens on Models.
  2. Click Add models, and select the provider that serves them.
  3. Select the models to add from those the provider lists. Enter part of a name to filter them. For a model the provider serves but doesn't list, click Add by ID and enter its Model ID.
  4. Click Next.
  5. Enter each model's alias, such as fast or smart. An alias is unique among your organization's models, and is what projects call the model by unless they set another.
  6. Under Projects that can use it, select All projects or Selected projects, or keep No projects yet and share it later.
  7. Click Add model.

The models show under their provider. The projects you shared them with can now add them: Add models to a project shows how. A provider's Models tab lists its models too, and adds more.

Change a model or who can use it

  1. In your organization, click LLM Gateway.
  2. On the model's row, click Edit.
  3. Change its Alias, its Name (optional) or the projects that can use it, and click Save.

Projects keep their own aliases for the model. A project you no longer share the model with keeps it, but its requests fail and it shows Needs attention until you share the model with it again.

Delete a model

  1. In your organization, click LLM Gateway.
  2. On the model's row, click Delete, then Delete model.

The projects that added the model lose it too, and their requests for it fail.

Add a model with the API

Set your API key (Call the API), your organization's ID, your provider's resource name and the project's ID:

export KOSEM_API_KEY='kosem_sk_…'
export KOSEM_ORG='org_01m5r8w2k3e9vbt6g0d4x7qz1h'
export KOSEM_PROVIDER='organizations/org_01m5r8w2k3e9vbt6g0d4x7qz1h/providers/prv_01m5raq8h2e4vbt6g0d4x7qz1j'
export KOSEM_PROJECT='prj_01m5r9dh9mf0ps98ktkap3562c'

curl -s -X POST "https://api.kosem.ai/v1/organizations/$KOSEM_ORG/models" \
  -H "Authorization: Bearer $KOSEM_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"alias\": \"fast\", \"provider\": \"$KOSEM_PROVIDER\", \"providerModel\": \"claude-haiku-4-5\", \"availability\": {\"allProjects\": false, \"projects\": [\"projects/$KOSEM_PROJECT\"]}}"

kosem answers with the model:

{
  "name": "organizations/org_01m5r8w2k3e9vbt6g0d4x7qz1h/models/mdl_01m5rb2x9ke4vbt6g0d4x7qz1k",
  "alias": "fast",
  "providerModel": "claude-haiku-4-5",
  "availability": { "allProjects": false, "projects": ["projects/prj_01m5r9dh9mf0ps98ktkap3562c"] },
  "formats": ["ANTHROPIC_MESSAGES", "OPENAI_CHAT_COMPLETIONS", "OPENAI_RESPONSES"],
  "nativeFormats": ["ANTHROPIC_MESSAGES"]
}

Choosing whom a model is shared with takes Owner or LLM Gateway Admin on the organization. To delete a model that projects added, send DELETE with ?force=true, which deletes what they added of it too: without it, kosem answers MODEL_ADOPTED (Errors).

On this page