Models

List the models available to your AlphaNeural API key. This endpoint is OpenAI-compatible, so tools and SDKs that expect GET /v1/models will work out of the box.

List models

GET /v1/models openapi

AlphaNeural also exposes GET /models as an alias for compatibility. openapi

Authentication

Send your key in the Authorization header.

-H "Authorization: Bearer $ALPHANEURAL_API_KEY"

Query parameters

These are optional. If you do not pass anything, you get the default model list for your key. openapi

• return_wildcard_routes (boolean). Include wildcard routes in the returned list.

• team_id (string). Filter models by team.

• include_model_access_groups (boolean). Include model access group information.

• only_model_access_groups (boolean). Return only model access groups.

• include_metadata (boolean). Include additional metadata in the response with fallback information.

• fallback_type (string). Which fallback class to include when include_metadata=true. Supported values include general, context_window, content_policy.

For richer model details like pricing, mode, and config-derived metadata, the spec recommends using /v1/model/info. This page focuses on OpenAI-compatible listing for developer tooling compatibility.

Examples

cURL

curl https://proxy.alfnrl.io/v1/models \
  -H "Authorization: Bearer $ALPHANEURAL_API_KEY"

With metadata and fallback info:

curl "https://proxy.alfnrl.io/v1/models?include_metadata=true&fallback_type=general" \
  -H "Authorization: Bearer $ALPHANEURAL_API_KEY"

Python (OpenAI SDK style)

from openai import OpenAI
import os
client = OpenAI(api_key=os.environ["ALPHANEURAL_API_KEY"], base_url="https://proxy.alfnrl.io/v1")
models = client.models.list()
print([m.id for m in models.data][:10])

JavaScript/TypeScript (OpenAI SDK style)

import OpenAI from "openai";
const client = new OpenAI({ apiKey: process.env.ALPHANEURAL_API_KEY, baseURL: "https://proxy.alfnrl.io/v1" });
const models = await client.models.list();
console.log(models.data.map(m => m.id).slice(0, 10));

Response

Returns an OpenAI-style “list” of model objects. The exact fields can vary by upstream and by whether you enable metadata. openapi

Example shape (illustrative):

{
  "object": "list",
  "data": [
    { "id": "gpt-4o-mini", "object": "model", "owned_by": "alphaneural" },
    { "id": "qwen3", "object": "model", "owned_by": "alphaneural" }
  ]
}

Related

• Retrieve a specific model: GET /v1/models/{model_id}