Your own providers

Roots and regions

A provider is a root, which holds its name, or a region under a root. The Provider organization's owner, signed in, manages them, and a provider is changed only by the organization that registered its root. A new root waits for Momor to approve it: until then it and its regions are listed in GET /providers and take models, but neither routing nor the public catalogs reach them. Approval reaches routing within five minutes. Once a root is approved, routing sees a change to it or its regions as soon as it is saved; the public catalogs (GET /models/...) may answer from a copy up to five minutes old.

name is the root's name, which callers give in model.provider, prioritization and keys, matched without regard to case. A name has one root across every organization: the first organization to register it holds it, a name another organization holds is 409, and removing the root frees the name. A root may name the region it serves from in its body. A region carries its root's name and takes what a key comes with from it, and where and how its models are reached from it wherever the region says nothing; it serves only the models put on it. A region needs its root first (400 without one), and a root another organization holds is 404. A caller's name always reaches the root; an unpinned selection reaches the regions too, and a region runs on the key saved for, or Momor's key for, its root where none is held for the region itself.

Register a provider

PUT /providers/hostly
{
  "defaultBaseUrl": "https://-region-.hostly.example/v1/",
  "defaultAuthentication": "Bearer",
  "defaultHostSettings": { "reasoningField": "reasoning", "maxTokensField": "max_tokens" },
  "keyFields": ["region"],
  "fieldPatterns": { "region": "^[a-z]+$" },
  "enabled": true
}

Put a model on it

PUT /providers/hostly/models/Acme/acme-1
{
  "providerModelId": "acme/acme-1",
  "contextLength": 128000,
  "quantization": "fp8",
  "enabled": true,
  "operations": [
    {
      "operation": "Chat",
      "protocol": "ChatCompletions",
      "cost": { "promptTokens": 0.5, "completionTokens": 1.5 },
      "compatibility": { "toolUse": true, "contentTypes": ["image/png"] },
      "verifiesKeys": true
    }
  ]
}