Gemini Models API

Consulte os modelos disponíveis na plataforma OfoxAI pelo protocolo nativo Gemini. O formato de resposta segue a especificação da API Google GenAI (campos camelCase como name, displayName, inputTokenLimit).

A API de Models é uma interface pública — não é necessário API Key. Este endpoint retorna todos os modelos disponíveis pelo protocolo Gemini, não apenas a série Google.

Listar todos os modelos


GET https://api.ofox.io/gemini/v1beta/models

Exemplo de requisição

Terminal


curl https://api.ofox.io/gemini/v1beta/models

Formato da resposta


{
  "models": [
    {
      "name": "models/google/gemini-3.8-flash",
      "version": "001",
      "displayName": "Google: Gemini 3.8 Flash",
      "description": "Gemini 3.8 Flash is Google's most intelligent Flash model, with significant gains over 3.7 Flash across software engineering, agentic tasks, and multi-step reasoning. All input modalities (text/image/video/audio) unified pricing; batch tier at 50% discount. Thinking model with configurable levels. 1M context. Released September 2, 2026.",
      "inputTokenLimit": 1000000,
      "outputTokenLimit": 65536,
      "supportedGenerationMethods": [
        "generateContent",
        "countTokens"
      ],
      "ownedBy": "google",
      "canonicalSlug": "gemini-3.8-flash",
      "contextLength": 1000000,
      "architecture": {
        "modality": "text+image+audio+file->text",
        "input_modalities": [
          "text",
          "image",
          "audio",
          "file"
        ],
        "output_modalities": [
          "text"
        ],
        "tokenizer": "gemini",
        "instruct_type": null
      },
      "pricing": {
        "prompt": "0.0000015",
        "completion": "0.0000075",
        "audio": "0.0000015",
        "input_cache_read": "0.00000015",
        "input_cache_write": "0.000000083",
        "input_cache_write_1h": "0.000001",
        "input_cached_audio": "0.00000015",
        "web_search": "0.014"
      },
      "topProvider": {
        "context_length": 1000000,
        "max_completion_tokens": 65536,
        "is_moderated": false
      },
      "supportedParameters": [
        "temperature",
        "top_p",
        "max_tokens",
        "stop",
        "tools",
        "tool_choice",
        "response_format",
        "reasoning"
      ],
      "expirationDate": null,
      "isDeprecated": false,
      "aliases": [
        "gemini-3.8-flash"
      ]
    }
  ]
}

Diferenças de campos em relação ao protocolo OpenAI

Campo	Protocolo OpenAI	Protocolo Gemini
Chave da lista	`data`	`models`
Identificador do modelo	`id`	`name` (com prefixo `models/`)
Nome	`name`	`displayName`
Tamanho do contexto	`context_length`	`inputTokenLimit` + `contextLength`
Saída máxima	`top_provider.max_completion_tokens`	`outputTokenLimit`
Convenção de nomes	snake_case	camelCase

Filtrar modelos por provedor


GET https://api.ofox.io/gemini/v1beta/models/{provider}

Parâmetros de caminho

Parâmetro	Tipo	Descrição
`provider`	string	Identificador do provedor, ex: `google`, `anthropic`, `openai`

Exemplo de requisição

Terminal


# Listar apenas modelos Google
curl https://api.ofox.io/gemini/v1beta/models/google

Formato da resposta

O formato da resposta é idêntico ao da listagem completa de modelos. O array models contém apenas modelos do provedor especificado.

Obter detalhes do modelo


GET https://api.ofox.io/gemini/v1beta/models/{provider}/{model_id}

Parâmetros de caminho

Parâmetro	Tipo	Descrição
`provider`	string	Identificador do provedor, ex: `google`
`model_id`	string	Nome do modelo, ex: `gemini-3.8-flash`

Exemplo de requisição

Terminal


curl https://api.ofox.io/gemini/v1beta/models/google/gemini-3.8-flash

Formato da resposta

Retorna um único objeto Model, com a mesma estrutura dos objetos na listagem.