Get Model

GET/v1/models/{id_or_name}

Get detailed information about a model. This endpoint accepts either a model ID or the full model name, and returns the model card, unified schema, and skills in one response.

Authentication is required. Use an API key in the Authorization: Bearer sk-sb-... header.

Path Parameters

Parameter	Type	Description
id_or_name	string	Model ID, for example model_01abc..., or model name, for example openai/gpt-4o.

The server first tries to match the value as a model ID. If no model is found, it treats the full remaining path as the model name. This means names that contain / are supported, such as /v1/models/openai/gpt-4o.

Response

Detailed pricing fields are returned inside model_card. There is no top-level pricing object.

{
  "id": "model_01abc...",
  "name": "openai/gpt-4o",
  "display_name": "GPT-4o",
  "vendor": "OpenAI",
  "description": "Most capable GPT-4 model with vision...",
  "type": "llm",
  "capability_tags": ["chat", "streaming", "vision", "tools", "json_mode", "cache"],
  "skills": ["chat", "streaming", "vision", "tools", "json_mode", "cache"],
  "unified_schema": {
    "type": "object",
    "properties": {
      "prompt": {
        "type": "string"
      }
    }
  },
  "execution_mode": "chat",
  "supported_modes": ["chat"],
  "published_at": "2026-07-07T00:00:00Z",
  "vendor_slug": "openai",
  "model_slug": "gpt-4o",
  "enabled": true,
  "featured": true,
  "model_card": {
    "base_price": "0.000000",
    "prompt_token_price": "0.0000025",
    "completion_token_price": "0.000010",
    "cache_read_multiplier": "0.5",
    "cache_write_multiplier": "1.0",
    "reasoning_price": null,
    "price_formula": "$input_tokens * 0.0000025 + $output_tokens * 0.000010",
    "markup_ratio": "1.0000",
    "readme": "Model usage notes...",
    "cover_url": "https://..."
  },
  "examples": []
}

Examples

# Fetch by model ID
curl "https://api.sandbase.ai/v1/models/model_01abc..." \
  -H "Authorization: Bearer sk-sb-YOUR_KEY"

# Fetch by model name
curl "https://api.sandbase.ai/v1/models/openai/gpt-4o" \
  -H "Authorization: Bearer sk-sb-YOUR_KEY"

SEO-Friendly Slug

The legacy slug path is still supported and returns the same response structure:

GET /v1/models/slug/{vendor}/{model}

Example: GET /v1/models/slug/openai/gpt-4o