Models

Discover what SpiderGate can route to — the underlying models and the task aliases that front them.

GET /models

Lists every model available across all providers, with usage stats. OpenAI-compatible shape.

curl https://spideriq.ai/api/gate/v1/models \
  -H "Authorization: Bearer $SPIDERGATE_API_KEY"

{
  "object": "list",
  "data": [
    { "id": "llama-3.3-70b-groq", "object": "model", "owned_by": "groq" },
    { "id": "codestral", "object": "model", "owned_by": "mistral" },
    { "id": "gpt-5.5-codex", "object": "model", "owned_by": "codex" }
  ]
}

GET /aliases

Lists the SpiderGate task aliases and the model chain each one routes through (SpiderGate-specific — this is the recommended way to choose a model).

curl https://spideriq.ai/api/gate/v1/aliases \
  -H "Authorization: Bearer $SPIDERGATE_API_KEY"

{
  "object": "list",
  "data": [
    {
      "id": "spideriq/fast",
      "description": "Fastest response for simple tasks",
      "use_case": "Fastest response, simple tasks, low latency",
      "models": [
        { "provider": "groq", "model": "llama-3.1-8b-instant" },
        { "provider": "nvidia_nim", "model": "meta/llama-3.1-8b-instruct" },
        { "provider": "cerebras", "model": "zai-glm-4.7" }
      ],
      "usage": { "requests_30d": 5872, "tokens_30d": 29013427, "cost_30d": 7.46 }
    }
  ]
}

Prefer an alias over a raw model id — it gives you automatic fallback and cost-aware routing. See Task Aliases.