HydraCore
API by router

Model catalog internal

Resolve Model For Instance

Resolve the best model + API key for a given instance and task.

Auth: proxy-key (Bearer header). Returns decrypted credentials — MUST be authenticated.

Model resolution order:

  1. Instance agent_config.model_policy[task].primary
  2. Tenant-level model_override.primary_model (if no instance policy)
  3. Platform default (minimax/m2.7)

Key resolution (BYOK hierarchy):

  1. Instance MCP credential (slug="llm/{provider}")
  2. Tenant MCP credential (slug="llm/{provider}", instance_id IS NULL)
  3. Platform env var
GET
/internal/v1/instances/{instance_id}/resolve-model

Path Parameters

instance_idInstance Id
Formatuuid

Query Parameters

task?Task
Default"chat"

Response Body

curl -X GET "https://loading/internal/v1/instances/497f6eca-6276-4993-bfeb-53cbbbba6f08/resolve-model?task=chat"
{
  "api_base_url": "string",
  "api_format": "string",
  "api_key": "string",
  "capabilities": [
    null
  ],
  "context_window": 0,
  "cost_cached_input_per_mtok": "string",
  "cost_input_per_mtok": "string",
  "cost_output_per_mtok": "string",
  "key_source": "string",
  "max_output_tokens": 0,
  "model_id": "string",
  "provider": "string",
  "slug": "string"
}
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}