Models API

List available models and their metadata.

List models

GET https://backend.sovereigneg.com/v1/models

Authentication required — include your API key as a Bearer token:

curl https://backend.sovereigneg.com/v1/models \
  -H "Authorization: Bearer $SOVEREIGNEG_API_KEY"

Response

OpenAI-compatible list shape (object, data) with extra SovereignEG fields and no created field. Pass each entry's id as model on the endpoint that matches its modality: chat → /v1/chat/completions, embed → /v1/embeddings, image → /v1/images/generations, decision → /v1/decisions or /v1/systemone. owned_by and provider name the model's author, not the company that serves it. source is sovereign for models served on SovereignEG's own GPUs and serverless for models served by third-party providers. pricing is in EGP per 1M tokens (per_image_egp for image models) and is null for unpriced models. Deprecated models stay listed with deprecated_at, deprecation_notice and sunset_at.

{
  "object": "list",
  "data": [
    {
      "id": "<model-id>",
      "object": "model",
      "owned_by": "Alibaba",
      "provider": "Alibaba",
      "display_name": "<name>",
      "modality": "chat",
      "status": "live",
      "source": "serverless"
    }
  ]
}

Call GET /v1/models or browse the Model Library for the current id list — do not hardcode ids from examples.

Model IDs

For detailed comparisons and EGP pricing, see Models Overview.