List models in Gemini format

http
GET /ai/v1beta/models

List models in Gemini format.

Servers

json
[
  {
    "url": "https://api.veryfront.com"
  }
]

Authentication

json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyAuth": []
  }
]
json
{
  "bearerAuth": {
    "type": "http",
    "scheme": "bearer",
    "bearerFormat": "JWT or API Key",
    "description": "Use a JWT bearer token or a Veryfront API key in the `Authorization` header."
  },
  "apiKeyAuth": {
    "type": "apiKey",
    "in": "header",
    "name": "X-API-Key",
    "description": "Alternative API key header for `vf_<prefix>_<secret>` tokens."
  }
}

Parameters

NameLocationRequiredDescription
pageSizequeryNo
pageTokenqueryNo
x-veryfront-project-referenceheaderNo
x-veryfront-project-idheaderNo
x-veryfront-project-slugheaderNo

Parameter contracts

json
[
  {
    "schema": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 1000,
      "description": "Maximum number of models to return.",
      "example": 50
    },
    "required": false,
    "name": "pageSize",
    "in": "query"
  },
  {
    "schema": {
      "type": "string",
      "minLength": 1,
      "description": "The `nextPageToken` of the previous page."
    },
    "required": false,
    "name": "pageToken",
    "in": "query"
  },
  {
    "schema": {
      "type": "string",
      "minLength": 1,
      "maxLength": 255,
      "description": "Canonical project selector: a UUID or slug for model access, inference and billing context. A signed project scope takes precedence. Otherwise, send only one project selector header."
    },
    "required": false,
    "name": "x-veryfront-project-reference",
    "in": "header"
  },
  {
    "schema": {
      "type": "string",
      "minLength": 1,
      "maxLength": 255,
      "description": "Compatibility selector accepting a project UUID. Prefer x-veryfront-project-reference."
    },
    "required": false,
    "name": "x-veryfront-project-id",
    "in": "header"
  },
  {
    "schema": {
      "type": "string",
      "minLength": 1,
      "maxLength": 255,
      "description": "Compatibility selector accepting a project slug. Prefer x-veryfront-project-reference."
    },
    "required": false,
    "name": "x-veryfront-project-slug",
    "in": "header"
  }
]

Responses

200

Model list, answered from the Veryfront catalog and never forwarded to a vendor

json
{
  "description": "Model list, answered from the Veryfront catalog and never forwarded to a vendor",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/NeutralGoogleModelList"
      }
    }
  }
}

400

No project selector, or a selector that names no usable project

json
{
  "description": "No project selector, or a selector that names no usable project",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/NeutralGoogleError"
      }
    }
  }
}

401

Unauthorized

json
{
  "description": "Unauthorized",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/NeutralGoogleError"
      }
    }
  }
}

403

Project access denied, or a credential restricted to template inference

json
{
  "description": "Project access denied, or a credential restricted to template inference",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/NeutralGoogleError"
      }
    }
  }
}

500

Gateway error

json
{
  "description": "Gateway error",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/NeutralGoogleError"
      }
    }
  }
}

503

Authentication or the project inference policy is temporarily unavailable

json
{
  "description": "Authentication or the project inference policy is temporarily unavailable",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/NeutralGoogleError"
      }
    }
  }
}

Referenced contracts

components/schemas/NeutralGoogleModelList

json
{
  "type": "object",
  "properties": {
    "models": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "displayName": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "veryfront": {
            "$ref": "#/components/schemas/VeryfrontListedModelProcessing"
          }
        },
        "required": [
          "name",
          "displayName",
          "veryfront"
        ]
      }
    },
    "nextPageToken": {
      "type": "string"
    }
  },
  "required": [
    "models"
  ]
}

components/schemas/VeryfrontListedModelProcessing

json
{
  "type": "object",
  "properties": {
    "processing": {
      "type": "string",
      "description": "Where inference is processed: `eu`, `us`, `worldwide` or `unknown` (not recorded). An open string.",
      "example": "eu"
    },
    "processing_label": {
      "type": "string",
      "description": "The processing location in words, for display, e.g. `EU (EEA + Switzerland data zone)`.",
      "example": "EU (EEA + Switzerland data zone)"
    },
    "model_provider": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "Stable identifier."
        },
        "name": {
          "type": "string",
          "description": "Display name."
        }
      },
      "required": [
        "id",
        "name"
      ],
      "description": "Who made the model.",
      "example": {
        "id": "mistral",
        "name": "Mistral"
      }
    },
    "inference_providers": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Stable identifier."
          },
          "name": {
            "type": "string",
            "description": "Display name."
          },
          "region": {
            "type": "string",
            "description": "Where inference runs. Known values: `eu`, `us`, `worldwide`, `unknown`. Tolerate values you have not seen."
          }
        },
        "required": [
          "id",
          "name",
          "region"
        ],
        "description": "Who runs the model."
      },
      "description": "Who runs the model and where, one entry per deployment the caller may use, in routing order. `region` is `eu`, `us`, `worldwide` or `unknown`; an open string.",
      "example": [
        {
          "id": "google-vertex",
          "name": "Google",
          "region": "eu"
        }
      ]
    }
  },
  "required": [
    "processing",
    "processing_label",
    "model_provider",
    "inference_providers"
  ]
}

components/schemas/NeutralGoogleError

json
{
  "type": "object",
  "properties": {
    "error": {
      "type": "object",
      "properties": {
        "code": {
          "type": "integer"
        },
        "message": {
          "type": "string"
        },
        "status": {
          "type": "string"
        },
        "details": {
          "type": "array",
          "items": {
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "@type": {
                    "type": "string",
                    "enum": [
                      "type.googleapis.com/google.rpc.ErrorInfo"
                    ]
                  },
                  "reason": {
                    "type": "string"
                  },
                  "domain": {
                    "type": "string"
                  }
                },
                "required": [
                  "@type",
                  "reason",
                  "domain"
                ]
              },
              {
                "type": "object",
                "properties": {
                  "@type": {
                    "type": "string",
                    "enum": [
                      "type.googleapis.com/google.rpc.RetryInfo"
                    ]
                  },
                  "retryDelay": {
                    "type": "string"
                  }
                },
                "required": [
                  "@type",
                  "retryDelay"
                ]
              },
              {
                "type": "object",
                "properties": {
                  "@type": {
                    "type": "string",
                    "enum": [
                      "type.googleapis.com/google.rpc.QuotaFailure"
                    ]
                  },
                  "violations": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "quotaId": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "quotaId"
                      ]
                    }
                  }
                },
                "required": [
                  "@type",
                  "violations"
                ]
              }
            ]
          }
        },
        "veryfront": {
          "type": "object",
          "additionalProperties": {}
        }
      },
      "required": [
        "code",
        "message",
        "status"
      ]
    }
  },
  "required": [
    "error"
  ]
}

Operation contract

json
{
  "operationId": "neutralGoogleModelList",
  "tags": [
    "ai-gateway/Models/Inference Models"
  ],
  "summary": "List models in Gemini format",
  "description": "List models in Gemini format.",
  "parameters": [
    {
      "schema": {
        "type": "integer",
        "exclusiveMinimum": 0,
        "maximum": 1000,
        "description": "Maximum number of models to return.",
        "example": 50
      },
      "required": false,
      "name": "pageSize",
      "in": "query"
    },
    {
      "schema": {
        "type": "string",
        "minLength": 1,
        "description": "The `nextPageToken` of the previous page."
      },
      "required": false,
      "name": "pageToken",
      "in": "query"
    },
    {
      "schema": {
        "type": "string",
        "minLength": 1,
        "maxLength": 255,
        "description": "Canonical project selector: a UUID or slug for model access, inference and billing context. A signed project scope takes precedence. Otherwise, send only one project selector header."
      },
      "required": false,
      "name": "x-veryfront-project-reference",
      "in": "header"
    },
    {
      "schema": {
        "type": "string",
        "minLength": 1,
        "maxLength": 255,
        "description": "Compatibility selector accepting a project UUID. Prefer x-veryfront-project-reference."
      },
      "required": false,
      "name": "x-veryfront-project-id",
      "in": "header"
    },
    {
      "schema": {
        "type": "string",
        "minLength": 1,
        "maxLength": 255,
        "description": "Compatibility selector accepting a project slug. Prefer x-veryfront-project-reference."
      },
      "required": false,
      "name": "x-veryfront-project-slug",
      "in": "header"
    }
  ],
  "responses": {
    "200": {
      "description": "Model list, answered from the Veryfront catalog and never forwarded to a vendor",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/NeutralGoogleModelList"
          }
        }
      }
    },
    "400": {
      "description": "No project selector, or a selector that names no usable project",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/NeutralGoogleError"
          }
        }
      }
    },
    "401": {
      "description": "Unauthorized",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/NeutralGoogleError"
          }
        }
      }
    },
    "403": {
      "description": "Project access denied, or a credential restricted to template inference",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/NeutralGoogleError"
          }
        }
      }
    },
    "500": {
      "description": "Gateway error",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/NeutralGoogleError"
          }
        }
      }
    },
    "503": {
      "description": "Authentication or the project inference policy is temporarily unavailable",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/NeutralGoogleError"
          }
        }
      }
    }
  },
  "x-documentation-source-tag": "Inference Models",
  "x-canonical-documentation": {
    "domain": "ai-gateway",
    "resource": "Models",
    "subgroup": "Inference Models",
    "name": "List models in Gemini format",
    "description": "List models in Gemini format.",
    "operationId": "neutralGoogleModelList"
  },
  "x-mint": {
    "href": "/cloud/rest/api-reference/ai-gateway-models-inference-models/list-models-in-gemini-format"
  }
}