Models

List available AI models.

GET /v1/models

Request

curl https://api.gateflow.ai/v1/models \
  -H "Authorization: Bearer gw_prod_..."

Response

{
  "object": "list",
  "data": [
    {
      "id": "gpt-4o",
      "object": "model",
      "created": 1715367049,
      "owned_by": "openai",
      "gateflow": {
        "provider": "openai",
        "capabilities": ["chat", "vision", "function_calling"],
        "context_window": 128000,
        "max_output_tokens": 4096,
        "pricing": {
          "input_per_1m": 2.50,
          "output_per_1m": 10.00
        },
        "status": "available"
      }
    },
    {
      "id": "claude-3-5-sonnet-20241022",
      "object": "model",
      "created": 1729555200,
      "owned_by": "anthropic",
      "gateflow": {
        "provider": "anthropic",
        "capabilities": ["chat", "vision", "function_calling"],
        "context_window": 200000,
        "max_output_tokens": 8192,
        "pricing": {
          "input_per_1m": 3.00,
          "output_per_1m": 15.00
        },
        "status": "available"
      }
    }
  ]
}

Response Fields

Model Object

Field	Type	Description
id	string	Model identifier
object	string	Always model
created	integer	Unix timestamp
owned_by	string	Provider name
gateflow	object	Extended model info

GateFlow Extension

Field	Type	Description
provider	string	Provider name
capabilities	array	What the model can do
context_window	integer	Max input tokens
max_output_tokens	integer	Max output tokens
pricing	object	Cost per 1M tokens
status	string	available, deprecated, beta
deprecation	object	Present if deprecated

Capabilities

Capability	Description
chat	Chat completions
vision	Image input
function_calling	Tool use
json_mode	JSON output
streaming	Streaming responses
embeddings	Text embeddings
speech	Text-to-speech
transcription	Speech-to-text

Filtering

By Provider

curl https://api.gateflow.ai/v1/models?provider=openai \
  -H "Authorization: Bearer gw_prod_..."

By Capability

curl https://api.gateflow.ai/v1/models?capability=vision \
  -H "Authorization: Bearer gw_prod_..."

By Status

curl https://api.gateflow.ai/v1/models?status=available \
  -H "Authorization: Bearer gw_prod_..."

Get Single Model

GET /v1/models/{model_id}

curl https://api.gateflow.ai/v1/models/gpt-4o \
  -H "Authorization: Bearer gw_prod_..."

Response:

{
  "id": "gpt-4o",
  "object": "model",
  "created": 1715367049,
  "owned_by": "openai",
  "gateflow": {
    "provider": "openai",
    "capabilities": ["chat", "vision", "function_calling", "json_mode", "streaming"],
    "context_window": 128000,
    "max_output_tokens": 4096,
    "pricing": {
      "input_per_1m": 2.50,
      "output_per_1m": 10.00
    },
    "status": "available",
    "aliases": ["gpt4o", "gpt-4-omni"],
    "recommended_for": ["general", "coding", "analysis"],
    "fallback_chain": ["claude-3-5-sonnet", "gemini-1.5-pro"]
  }
}

Examples

List All Models

Python

from openai import OpenAI

client = OpenAI(
    base_url="https://api.gateflow.ai/v1",
    api_key="gw_prod_..."
)

models = client.models.list()

for model in models.data:
    print(f"{model.id}: {model.owned_by}")

TypeScript

import OpenAI from 'openai';

const client = new OpenAI({
  baseURL: 'https://api.gateflow.ai/v1',
  apiKey: 'gw_prod_...',
});

const models = await client.models.list();

for (const model of models.data) {
  console.log(`${model.id}: ${model.owned_by}`);
}

cURL

curl https://api.gateflow.ai/v1/models \
  -H "Authorization: Bearer gw_prod_..."

Find Vision Models

models = client.models.list()

vision_models = [
    m for m in models.data
    if "vision" in m.gateflow.get("capabilities", [])
]

for model in vision_models:
    print(model.id)

Check Model Availability

try:
    model = client.models.retrieve("gpt-4o")
    status = model.gateflow.get("status")

    if status == "deprecated":
        deprecation = model.gateflow.get("deprecation", {})
        print(f"Deprecated! Sunset: {deprecation.get('sunset_date')}")
        print(f"Use instead: {deprecation.get('replacement')}")
    else:
        print(f"Model available: {model.id}")
except Exception as e:
    print(f"Model not found: {e}")

Model Categories

Chat Models

Model	Provider	Context	Best For
gpt-4o	OpenAI	128k	General, coding
gpt-4o-mini	OpenAI	128k	Fast, cheap
claude-3-5-sonnet	Anthropic	200k	Analysis, writing
claude-3-opus	Anthropic	200k	Complex reasoning
gemini-1.5-pro	Google	1M	Long documents
gemini-1.5-flash	Google	1M	Fast, cheap
mistral-large	Mistral	32k	European compliance

Embedding Models

Model	Provider	Dimensions
text-embedding-3-small	OpenAI	1536
text-embedding-3-large	OpenAI	3072
text-embedding-004	Google	768
embed-english-v3.0	Cohere	1024

Audio Models

Model	Provider	Type
whisper-1	OpenAI	STT
tts-1	OpenAI	TTS
tts-1-hd	OpenAI	TTS (high quality)

Deprecation Info

For deprecated models:

{
  "id": "gpt-4-32k",
  "gateflow": {
    "status": "deprecated",
    "deprecation": {
      "announced_date": "2024-06-01",
      "sunset_date": "2025-06-01",
      "replacement": "gpt-4o",
      "migration_guide": "/guide/change-management/migrations/gpt-4-32k"
    }
  }
}

See Model Change Management for handling deprecations.