Skip to Content
API 레퍼런스Gemini 네이티브 프로토콜Models

Gemini Models API

Gemini 네이티브 프로토콜을 통해 OfoxAI 플랫폼에서 사용 가능한 모델을 조회합니다. 응답 형식은 Google GenAI API 규격(name, displayName, inputTokenLimit 등 camelCase 필드)을 따릅니다.

Models API는 공개 인터페이스이며, API Key 없이 호출할 수 있습니다. 이 엔드포인트는 Google 시리즈뿐만 아니라 Gemini 프로토콜을 통해 호출 가능한 모든 모델을 반환합니다.

모든 모델 목록

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

요청 예시

Terminal
curl https://api.ofox.ai/gemini/v1beta/models

응답 형식

{
  "models": [
    {
      "name": "models/google/gemini-3-flash-preview",
      "version": "001",
      "displayName": "Google: Gemini 3 Flash Preview",
      "description": "High speed, high value thinking model designed for agentic workflows...",
      "inputTokenLimit": 1048576,
      "outputTokenLimit": 65536,
      "supportedGenerationMethods": [
        "generateContent",
        "countTokens"
      ],
      "ownedBy": "google",
      "canonicalSlug": "gemini-3-flash-preview",
      "contextLength": 1048576,
      "architecture": {
        "modality": "text+image+audio+file->text",
        "input_modalities": ["text", "image", "audio", "file"],
        "output_modalities": ["text"],
        "tokenizer": "gemini",
        "instruct_type": null
      },
      "pricing": {
        "prompt": "0.0000005",
        "completion": "0.000003",
        "audio": "0.000001",
        "input_cache_read": "0.00000005",
        "input_cache_write": "0.000001",
        "web_search": "0.014"
      },
      "topProvider": {
        "context_length": 1048576,
        "max_completion_tokens": 65536,
        "is_moderated": false
      },
      "supportedParameters": [
        "temperature",
        "top_p",
        "max_tokens",
        "stop",
        "tools",
        "tool_choice",
        "response_format",
        "reasoning"
      ],
      "expirationDate": null
    }
  ]
}

OpenAI 프로토콜과의 필드 차이

필드OpenAI 프로토콜Gemini 프로토콜
목록 키 이름datamodels
모델 식별자idname(models/ 접두사 포함)
이름namedisplayName
컨텍스트 길이context_lengthinputTokenLimit + contextLength
최대 출력top_provider.max_completion_tokensoutputTokenLimit
네이밍 스타일snake_casecamelCase

공급자별 모델 필터링

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

경로 파라미터

파라미터타입설명
providerstring공급자 식별자, 예: google, anthropic, openai

요청 예시

Terminal
# Google 시리즈 모델만 조회
curl https://api.ofox.ai/gemini/v1beta/models/google

응답 형식

전체 모델 목록과 동일한 형식으로 반환되며, models 배열에는 지정된 공급자의 모델만 포함됩니다.

모델 상세 정보

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

경로 파라미터

파라미터타입설명
providerstring공급자 식별자, 예: google
model_idstring모델 이름, 예: gemini-3-flash-preview

요청 예시

Terminal
curl https://api.ofox.ai/gemini/v1beta/models/google/gemini-3-flash-preview

응답 형식

단일 Model 객체를 반환하며, 구조는 목록 인터페이스의 객체와 동일합니다.

Last updated on
Generate ContentModels Count