GET /ai/v1beta/modelsList models in Gemini format.
Servers
[
{
"url": "https://api.veryfront.com"
}
]Authentication
[
{
"bearerAuth": []
},
{
"apiKeyAuth": []
}
]{
"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
Parameter contracts
[
{
"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
{
"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
{
"description": "No project selector, or a selector that names no usable project",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/NeutralGoogleError"
}
}
}
}401
Unauthorized
{
"description": "Unauthorized",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/NeutralGoogleError"
}
}
}
}403
Project access denied, or a credential restricted to template inference
{
"description": "Project access denied, or a credential restricted to template inference",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/NeutralGoogleError"
}
}
}
}500
Gateway error
{
"description": "Gateway error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/NeutralGoogleError"
}
}
}
}503
Authentication or the project inference policy is temporarily unavailable
{
"description": "Authentication or the project inference policy is temporarily unavailable",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/NeutralGoogleError"
}
}
}
}Referenced contracts
components/schemas/NeutralGoogleModelList
{
"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
{
"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
{
"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
{
"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"
}
}