Gemini 모델 | API 문서

# Gemini Models

Call Gemini 3.6 Flash, 3.7 Flash, 3.8 Flash, 3.5 Flash-Lite, and 4 Argon through the shared Chat Completions endpoint.

POST https://api.apihop.ai/v1/chat-completions

Gemini models use the Common Chat Completions endpoint. This page records the supported `model` values and text chat contract.

```text
POST https://api.apihop.ai/v1/chat-completions
```

## Available Models

| `model` value | Non-streaming JSON | SSE streaming |
| --- | --- | --- |
| `gemini-3.6-flash` | Yes | Yes |
| `gemini-3.7-flash` | Yes | Yes |
| `gemini-3.8-flash` | Yes | Yes |
| `gemini-3.5-flash-lite` | Yes | Yes |
| `gemini-4-argon` | Yes | Yes |

`gemini-4-argon` requires deployment and enablement. Its inclusion in this reference does not confirm production availability.

Model names distinguish product tiers; they are not latency, throughput, or quality SLAs. Compare models with your real workload. Check `GET https://api.apihop.ai/v1/models` for availability to your API Key before making a request.

## Authentication

```http
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
```

## Non-streaming Request

```json
{
  "model": "gemini-3.7-flash",
  "messages": [
    {
      "role": "system",
      "content": "You are a concise and accurate technical assistant."
    },
    {
      "role": "user",
      "content": "Explain idempotent APIs in five sentences."
    }
  ],
  "stream": false
}
```

## Streaming Request

```json
{
  "model": "gemini-3.6-flash",
  "messages": [
    {
      "role": "user",
      "content": "Show a TypeScript API error-handling example."
    }
  ],
  "stream": true
}
```

This endpoint returns one complete JSON response by default. Set `stream: true` explicitly when you need SSE streaming.

## Request Fields

### `model` (string, required)

Use `gemini-3.6-flash`, `gemini-3.7-flash`, `gemini-3.8-flash`, `gemini-3.5-flash-lite`, or `gemini-4-argon`.

### `messages` (object[], required)

OpenAI Chat Completions style messages. Each message contains `role` and `content`.

### `stream` (boolean, Default: false)

`true` returns SSE; `false` returns one complete JSON response.

### `max_tokens` (integer)

Optional maximum output tokens, as a positive integer. Omit this field to use the upstream default for the selected model. Depending on the model, the budget may include reasoning tokens as well as final text. A small budget can truncate the answer or be exhausted before final text; increasing it may increase cost.

### `max_completion_tokens` (integer)

Optional compatibility alternative to `max_tokens`, with the same budget considerations. The selected model determines support; omit both fields to use the upstream default.

See [Common Chat Completions](https://apihop.ai/en/docs/api-reference/common-chat-completions) for shared fields such as `temperature`, `top_p`, `frequency_penalty`, `presence_penalty`, `stop`, and `n`. Support and behavior of optional fields depend on the selected model; this page does not guarantee every shared field.

## Success Response

```json
{
  "id": "chatcmpl_...",
  "object": "chat.completion",
  "created": 1787200000,
  "model": "gemini-3.7-flash",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "An idempotent API produces the same effective result when..."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 26,
    "completion_tokens": 118,
    "total_tokens": 144
  }
}
```

`usage` may include optional reasoning-token details; clients should tolerate them being absent or changing by model.

## Usage Notes

- The request body's `model` must be one of the public model IDs listed in the Available Models table.
- Product names, display names, and other aliases are not accepted in place of a public model ID.
- This page applies only to Chat Completions requests sent to

`POST https://api.apihop.ai/v1/chat-completions`, not OpenAI Responses or Claude Messages.

- Use `GET https://api.apihop.ai/v1/models` for the models visible to the current API Key, and use the console for current pricing.

## Related Docs

- [Common Chat Completions](https://apihop.ai/en/docs/api-reference/common-chat-completions)
- [Model Catalog](https://apihop.ai/en/docs/api-reference/models)

Gemini 모델은 공통 Chat Completions 엔드포인트를 사용합니다. 이 페이지는 지원하는 model 값과 텍스트 채팅 계약을 기록합니다.

text

POST https://api.apihop.ai/v1/chat-completions

사용 가능한 모델

`model` 값	비스트리밍 JSON	SSE 스트리밍
`gemini-3.6-flash`	지원	지원
`gemini-3.7-flash`	지원	지원
`gemini-3.8-flash`	지원	지원
`gemini-3.5-flash-lite`	지원	지원
`gemini-4-argon`	지원	지원

gemini-4-argon은 배포와 활성화가 필요합니다. 참조 문서에 포함되었다고 운영 환경에서 사용할 수 있음을 확인하는 것은 아닙니다.

모델 이름은 제품 등급을 구분하며 지연, 처리량 또는 품질 SLA가 아닙니다. 실제 작업 부하로 비교하고 요청 전에 GET https://api.apihop.ai/v1/models로 키의 가용성을 확인하세요.

인증

http

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

비스트리밍 요청

json

{
  "model": "gemini-3.7-flash",
  "messages": [
    {
      "role": "system",
      "content": "You are a concise and accurate technical assistant."
    },
    {
      "role": "user",
      "content": "Explain idempotent APIs in five sentences."
    }
  ],
  "stream": false
}

스트리밍 요청

json

{
  "model": "gemini-3.6-flash",
  "messages": [
    {
      "role": "user",
      "content": "Show a TypeScript API error-handling example."
    }
  ],
  "stream": true
}

이 엔드포인트는 기본적으로 하나의 완전한 JSON 응답을 반환합니다. SSE 스트리밍이 필요하면 stream: true를 명시하세요.

요청 필드

modelstring필수

gemini-3.6-flash 또는 gemini-3.7-flash 또는 gemini-3.8-flash 또는 gemini-3.5-flash-lite 또는 gemini-4-argon을(를) 사용하세요.

messagesobject[]필수

OpenAI Chat Completions 형식의 메시지입니다. 각 메시지는 role과 content를 포함합니다.

streamboolean기본값: false

true는 SSE를, false는 하나의 완전한 JSON 응답을 반환합니다.

max_tokensinteger

양의 정수로 지정하는 선택적 최대 출력 토큰입니다. 생략하면 선택한 모델의 상위 제공자 기본값을 사용합니다. 모델에 따라 추론 토큰과 최종 텍스트가 같은 한도를 사용할 수 있습니다. 작은 한도는 응답을 자르거나 최종 텍스트 전에 소진될 수 있으며, 늘리면 비용이 증가할 수 있습니다.

max_completion_tokensinteger

max_tokens의 선택적 호환 대안으로 같은 한도 고려 사항이 적용됩니다. 지원 여부는 선택한 모델에 달려 있습니다. 둘 다 생략하면 상위 기본값을 사용합니다.

temperature, top_p, frequency_penalty, presence_penalty, stop, n 같은 공통 필드는 공통 Chat Completions를 참조하세요. 선택 필드의 지원과 동작은 모델에 달려 있으며 이 페이지는 모든 공통 필드를 보장하지 않습니다.

성공 응답

json

{
  "id": "chatcmpl_...",
  "object": "chat.completion",
  "created": 1787200000,
  "model": "gemini-3.7-flash",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "An idempotent API produces the same effective result when..."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 26,
    "completion_tokens": 118,
    "total_tokens": 144
  }
}

usage에 선택적인 추론 토큰 상세 정보가 포함될 수 있습니다. 클라이언트는 없거나 모델에 따라 달라지는 경우를 허용해야 합니다.

사용 참고 사항

본문의 model은 사용 가능한 모델 표의 공개 ID 중 하나여야 합니다.
제품명, 표시명 및 별칭은 공개 모델 ID 대신 사용할 수 없습니다.
이 페이지는 POST https://api.apihop.ai/v1/chat-completions로 보내는 Chat Completions 요청에만 적용되며 OpenAI Responses나 Claude Messages에는 적용되지 않습니다.
현재 키에 보이는 모델은 GET https://api.apihop.ai/v1/models로, 현재 가격은 콘솔에서 확인하세요.