← Catalogue

AI Inference & Embeddings Gateway

OAS 3.1.0 v1.2.0 ✓ Valid 3.1
specs/ai-inference-gateway.yaml • 3 operations • 3 schemas • 0 webhooks
⬇ Download .yaml

AI Inference & Embeddings Gateway

Unified OpenAPI 3.1 specification for multimodal chat completions, embeddings, and model routing

Standardized inference router supporting structured JSON outputs, token usage budgets, and vector embeddings.

Configured Target Servers

/api/mock/ai-inference-gateway Built-in OpenAPI 3.1 Mock Server
https://httpbin.org/anything Echo Inspection Endpoint

Detected OpenAPI 3.1 / JSON Schema 2020-12 Features

✦ info.summary✦ SPDX license.identifier✦ schema examples array✦ type array unions (e.g. ["string", "null"])

Completions

POST /v1/chat/completions Create a model chat completion

Request Body (application/json)

{
  "model": "gemini-4-argon",
  "temperature": 0.7,
  "maxTokens": 1024,
  "messages": [
    {
      "role": "user",
      "content": "Explain the key differences between OpenAPI 3.0 and 3.1."
    }
  ]
}

Responses

200 Generated completion response
{
  "id": "chatcmpl_99281a",
  "model": "gemini-4-argon",
  "reply": "OpenAPI 3.1 achieves 100% compatibility with JSON Schema Draft 2020-12, adds top-level webhooks, and replaces nullable with type arrays.",
  "usage": {
    "promptTokens": 24,
    "completionTokens": 48
  }
}

Embeddings

POST /v1/embeddings Generate vector embeddings

Request Body (application/json)

{
  "model": "text-embedding-3-large",
  "input": "OpenAPI 3.1 unifies OAS with JSON Schema 2020-12",
  "dimensions": 1536
}

Responses

200 Embedding vector array
{
  "model": "text-embedding-3-large",
  "embedding": [
    0.0231,
    -0.0144,
    0.0892,
    0.0412
  ]
}

Models

GET /v1/models List available foundation models

Responses

200 List of active models and context window limits
{
  "models": [
    {
      "id": "gemini-4-argon",
      "provider": "google-deepmind",
      "contextWindow": 1000000,
      "supportsVision": true,
      "deprecationDate": null
    }
  ]
}

Component Schemas (JSON Schema 2020-12)

ModelCard

object
PropertyTypeRequired
idstring ✓
providerstring ✓
contextWindowinteger ✓
supportsVisionboolean —
deprecationDatestring | null —

ChatCompletionRequest

object
PropertyTypeRequired
modelstring ✓
temperaturenumber —
maxTokensinteger | null —
messagesarray<object> ✓

ChatCompletionResponse

object
PropertyTypeRequired
idstring ✓
modelstring ✓
replystring ✓
usageobject ✓

Delete OpenAPI Specification?

Are you sure you want to permanently delete AI Inference & Embeddings Gateway (specs/ai-inference-gateway.yaml)?