Source: https://ailoot.ai/models/ko/google-gemma-4-31b-it-u003a-free/
Canonical: https://ailoot.ai/models/ko/google-gemma-4-31b-it-u003a-free/
Language: ko

# Google: Gemma 4 31B (free)

[Markdown](https://ailoot.ai/models/ko/google-gemma-4-31b-it-u003a-free/index.md) · [JSON](https://ailoot.ai/models/ko/google-gemma-4-31b-it-u003a-free/facts.json)

## [Google: Gemma 4 31B (free)](https://ailoot.ai/models/ko/google-gemma-4-31b-it-u003a-free/)

Gemma 4 31B IT는 텍스트와 시각 추론을 위한 Google의 지시 조정 밀집 모델입니다. 256K 컨텍스트, 조절 가능한 사고 모드, 이미지 이해, 기본 함수 호출을 통해 코딩, 문서, 에이전트 작업을 수행하고 텍스트를 출력합니다.

- [**Ailoot Ultra · OpenAI Chat** `POST /v1/chat/completions` `google/gemma-4-31b-it:free`](https://ailoot.ai/models/ko/google-gemma-4-31b-it-u003a-free/#method-0)

모델 소개

이 설명은 모델의 기능을 다룹니다. Ailoot에서 사용할 수 있는 입력, 출력 및 옵션은 아래에 선택한 메서드별로 표시됩니다.

Gemma 4 31B IT는 공개 Gemma 4 제품군에 속하는 Google DeepMind의 지시 조정 밀집 에디션입니다. Google은 31B 모델을 모델 품질과 작업별 적응에 초점을 맞춰 소개하며, 별도의 26B A4B 에디션은 추론 효율을 위해 전문가 혼합 구조를 사용합니다. 이 카드는 사전 학습 가중치나 양자화 파생 모델이 아니라 이름에 명시된 지시 조정 31B 에디션을 다룹니다.

공식 밀집 아키텍처 표에는 매개변수 307억 개, 60개 레이어, 1,024 토큰 슬라이딩 윈도, 256K 토큰 컨텍스트가 기재되어 있습니다. 이 제품군은 로컬 슬라이딩 윈도 어텐션과 글로벌 어텐션을 결합하고 마지막에 글로벌 레이어를 배치하며, 이 모델에는 전용 시각 인코더를 사용합니다. 따라서 텍스트와 이미지를 입력받아 텍스트를 출력하도록 설계되었습니다. 이는 모델 아키텍처에 관한 사실이며, 애플리케이션의 응답 시간을 정하거나 다른 크기의 Gemma 4가 제공하는 오디오 지원을 뜻하지 않습니다.

256K 토큰 컨텍스트를 활용하면 방대한 텍스트와 시각적 근거를 결합한 작업을 처리할 수 있습니다. 하나의 프롬프트에 이미지와 텍스트를 번갈아 배치할 수 있으며, 제조사는 최상의 결과를 위해 관련 텍스트 앞에 이미지 콘텐츠를 넣도록 권장합니다. 시각 작업에는 객체 탐지, 문서 페이지 해석, 화면과 인터페이스 이해, 차트, 다국어 OCR, 필기 인식, 위치 지시가 포함됩니다. 출력은 추출한 내용, 설명, 코드 또는 제안된 도구 동작과 같은 텍스트입니다.

조절 가능한 사고 모드를 통해 모델이 답변 전에 추론하거나 바로 답변하도록 할 수 있습니다. Gemma 4에는 user 및 assistant 역할과 함께 기본 system 역할이 추가되었습니다. Google의 프롬프트 형식은 시스템 프롬프트의 \<|think|\> 제어 토큰으로 사고를 활성화하고 사고 채널과 최종 답변을 분리합니다. 문서에 설명된 프로세서는 이 템플릿을 처리할 수 있습니다. 여러 턴으로 이어지는 대화에서는 이전 최종 답변을 기록에 유지하고 이전 사고 내용은 제외하세요. 다만 도구 호출 턴에서는 제조사의 설명에 따라 사고 내용을 보존해야 합니다.

기본 Function Calling은 구조화된 도구 사용을 지원하며, Google의 출시 설명에는 구조화된 JSON 출력도 명시되어 있습니다. 작업, 사용 가능한 함수, 기대 결과를 정의하세요. 애플리케이션이 요청된 작업을 수행한 뒤 그 출력을 반환하면 다음 단계로 이어갈 수 있습니다. 코딩 작업에서는 생성, 완성 또는 수정을 요청할 수 있고, 시각 어시스턴트는 반환된 텍스트로 차트나 화면을 설명할 수 있습니다. 함수 호출 지시는 연결된 동작이 실제로 실행되었다는 사실과 구분됩니다.

가변 이미지 해상도는 시각 토큰 예산으로 제어합니다. 문서에 명시된 선택지는 70, 140, 280, 560, 1,120 토큰입니다. 낮은 예산은 분류나 캡션에 적합하고, 높은 예산은 계산량이 늘어나는 대신 OCR, 문서 파싱, 작은 글자에 필요한 세부 정보를 더 많이 보존합니다. 이미지를 준비하기 전에 전체 장면이 필요한지 정확한 글자가 필요한지 결정하세요. 추출 작업에서는 페이지 전체의 모든 세부 사항을 무조건 살펴보라는 요청보다 라벨을 선명하게 잘라낸 이미지가 더 유용할 수 있습니다.

Google은 제품군의 샘플링 설정으로 temperature 1.0, top-p 0.95, top-k 64를 권장합니다. 모델 카드는 140개가 넘는 언어로 학습했다는 사실과 별도 설정 없이 35개가 넘는 언어를 지원한다는 사실을 구분합니다. 답변 언어를 지정하고 도메인 이름, 필드 이름 또는 수식은 작업 지시에 명시하여 유지하세요. 256K는 컨텍스트 사양이며, 인용된 모델 카드는 이 에디션의 별도 범용 최대 출력 수치를 정하지 않습니다.

문서와 코드를 함께 다루는 작업에서는 관련 페이지 이미지, 서면 요구사항, 소스 코드 조각을 제공하세요. 예를 들어 “라벨을 읽고, 이 화면이 명세와 어떻게 다른지 설명한 뒤, 제공된 코드에 필요한 부분만 수정하는 방안을 제안하세요”라고 요청할 수 있습니다. 차트에서는 화면에 표시된 값과 추론한 추세를 구분하여 답하도록 하세요. Gemma 모델 카드는 모호한 언어, 매우 복잡한 작업, 잘못되거나 오래된 사실 진술과 관련된 한계를 설명합니다. 따라서 학습 지식이 필요한 사실을 알아서 제공할 것으로 기대하기보다 결과가 반드시 사용해야 하는 권위 있는 사실 자료를 첨부하세요.

Ailoot에서는 /v1/chat/completions에서 이 정확한 모델 ID를 선택하고 messages에 작업을 넣으세요. 각 메시지는 role과 content를 포함하며, 관련 지시와 원본 자료를 함께 유지하세요. 전체 JSON 응답을 수집하거나 stream을 활성화한 경우 모든 SSE 조각을 수집하고, 작성된 결과와 함께 usage를 보관하세요.

**Ailoot Ultra · OpenAI Chat** `POST /v1/chat/completions` `google/gemma-4-31b-it:free`

[`google/gemma-4-31b-it:free`](https://ailoot.ai/models/ko/#m=google%2Fgemma-4-31b-it%3Afree&route=Ultra&caller=google%2Fgemma-4-31b-it%3Afree&fmt=chat)

Google /`google/gemma-4-31b-it:free`

### 시작하기

Gemma 4 31B IT는 텍스트와 시각 추론을 위한 Google의 지시 조정 밀집 모델입니다. 256K 컨텍스트, 조절 가능한 사고 모드, 이미지 이해, 기본 함수 호출을 통해 코딩, 문서, 에이전트 작업을 수행하고 텍스트를 출력합니다.

허용 입력

텍스트 · 이미지

결과

텍스트

### Ailoot에서 사용 가능 · 입력 및 메서드

**Ailoot Ultra · OpenAI Chat** `POST /v1/chat/completions`

입력

`text`, `image`

출력

`text`

출력 형식

JSON or SSE

| 필드 | 유형 | 요건 | 값과 한도 | 기본값 |
| --- | --- | --- | --- | --- |
| 필드`model` | 유형`string` | 요건필수 | 값과 한도 google/gemma-4-31b-it:free 조건: 이 Ailoot 라우팅 선택자를 그대로 사용하세요. | 기본값— |
| 필드`messages` | 유형`array` | 요건필수 | 값과 한도 조건: | 기본값— |
| 필드`stream` | 유형`boolean` | 요건선택 사항 | 값과 한도 조건: | 기본값false |

입력 자료 조합

**text\_input** · 필수: messages

**image\_with\_text** · 필수: messages with actual image content blocks

메서드 매개변수와 수명 주기

| 매개변수 | 명세 |
| --- | --- |
| 매개변수`content_type` | 명세application/json |
| 매개변수`required` | 명세model, messages |
| 매개변수`optional` | 명세stream |
| 매개변수`material_types` | 명세text, image |
| 매개변수`conditions` | 명세이 Ailoot 라우팅 선택자를 그대로 사용하세요., 선택한 특정 모델이 시각 인식을 지원하는 경우 이 프로토콜로 이미지 콘텐츠를 전달할 수 있습니다. 프로토콜에서 요청을 수락한다고 해서 모든 모델의 이미지 처리 기능이 입증되는 것은 아닙니다. |

메서드 별칭: `/chat/completions`

수명 주기: `synchronous_or_streamed`

### 요금

요금 정보는 요청 옵션을 추가하지 않습니다. 지원되는 매개변수는 선택한 메서드에 표시됩니다.

빠른 모드

표준 요금 빠른 모드를 선택한 경우

Flex 모드

표준 요금 flex 모드를 선택한 경우

최대 추론 수준

표준 요금 최대 추론 수준에 default 조정값을 적용하는 경우

명시적 캐시 요금

활성화되지 않음 명시적 캐시를 요청할 때

텍스트 전용 요율: 무료

캐시, 도구 및 미디어에는 각각 별도로 나열된 요금 조건이 적용됩니다. 텍스트 전용 입력 및 출력의 경우

#### Ailoot 요금

#### 설정별 가격

| 설정 | 요금표 | 요금 |
| --- | --- | --- |
| 설정기본 토큰 요금 | 요금표기본 요금 | 요금 입력 · 입력 토큰 **$0** / 1K 토큰 출력 · 출력 토큰 **$0** / 1K 토큰 입력 · 캐시 읽기 **—** / 1K 토큰 입력 · 캐시 쓰기 **—** / 1K 토큰 입력 · 캐시 쓰기, 1시간 **—** / 1K 토큰 |

Ailoot는 요청 전에 예상 금액을 미리 확보합니다. 결과를 받은 뒤 측정된 사용량을 기준으로 최종 요금을 정산합니다. 스트리밍 정산에는 최종 사용량 기록을 사용합니다. [금액 확보와 정산 방식 →](https://ailoot.ai/docs/ko/billing/reserve/)

### 요청 예제

#### Ailoot Ultra · OpenAI Chat

curl · 한 번만 생성하고 결과 전체 보관

```bash
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "google/gemma-4-31b-it:free", "messages": [{"role": "user", "content": "Explain how a rainbow forms."}]}')

Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/chat/completions \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o result.json
# Submit once. Retain the complete result, original identifiers and every response header.
```

### 결과 수신 및 저장

#### Ailoot Ultra · OpenAI Chat

JSON or SSE

##### 완료된 결과 모두 보관

반환된 완전한 응답, 파일, 콘텐츠 부분을 모두 보관하세요.

모든 콘텐츠 블록, 도구 호출 ID, 반환된 사고 서명, 모든 SSE 델타 및 전체 사용량 정보를 보존하세요. 첫 번째 텍스트 조각이 전체 결과는 아닙니다.

##### 원래 응답을 확인해야 할 경우

원래 X-Client-Request-ID, 응답 및 헤더를 보존하세요. 결과를 알 수 없거나 result\_pending\_check인 경우 두 번째 생성은 허용되지 않습니다.

응답 필드

| 필드 | 유형 |
| --- | --- |
| 필드`choices[]` | 유형object |
| 필드`usage` | 유형object |

오류와 다음 단계

| 응답 | 조건 | 다음 단계 |
| --- | --- | --- |
| 응답400 · `invalid_request_error` | 조건필수 필드, 모델 선택자, 유형 또는 입력 표현 형식이 유효하지 않습니다. | 다음 단계별도의 요청을 준비하기 전에 반환된 유효성 검사 세부 정보를 확인하세요. |
| 응답`` | 조건원래 요청이나 결과를 알 수 없거나 확인이 필요합니다. | 다음 단계원래 식별자와 헤더를 보존하고, 지원되는 상태 정보나 라이브러리 기록만 조회하세요. 생성 요청을 다시 제출하지 마세요. |

### 별칭

#### 모델 별칭

**Ailoot Ultra** [`google/gemma-4-31b-it:free`](https://ailoot.ai/models/ko/#m=google%2Fgemma-4-31b-it%3Afree&route=Ultra&caller=google%2Fgemma-4-31b-it%3Afree&fmt=chat)

#### 메서드 경로 별칭

`/chat/completions`

#### 관련 호출용 ID

[`google/gemma-4-31b-it:free`](https://ailoot.ai/models/ko/#m=google%2Fgemma-4-31b-it%3Afree&route=Ultra&caller=google%2Fgemma-4-31b-it%3Afree&fmt=chat)

FAQ · Google: Gemma 4 31B (free)

어떤 입력과 결과를 사용할 수 있나요?

`POST /v1/chat/completions` · `google/gemma-4-31b-it:free`: `text`, `image` → `text`

요청은 어떤 필드를 사용하나요?

`POST /v1/chat/completions` · `google/gemma-4-31b-it:free`: `model`, `messages`, `stream`

Claude Code, OpenCode, Hermes, 자체 앱에 Ailoot를 연결하세요.

## 회사와 그 프로젝트 포트폴리오

회사와 그 프로젝트 포트폴리오: 수백만 고객, 매월 수십억 규모의 매출.

## 할인받아 토큰을 구매하세요.

정기 작업에는 구독 할인, 토큰 구매에는 최대 50% 프로모션 코드.

구독

정기 요청에 맞는 할인 요금제를 선택하세요.

최대 50% 프로모션 코드

구매할 때 코드를 넣으면 진행 중 행사에 따라 가격을 다시 계산합니다.

이력의 지출

요청마다 모델, 토큰, 금액을 저장합니다.

[구독 선택](https://ailoot.ai/docs/ko/billing/subscriptions/) · [모델 가격 보기](https://ailoot.ai/models/ko/)

## 판매하는 제품에 API를 연결하세요.

Ailoot 공식 이용 조건과 라이선스 계약으로 SaaS, 앱, 봇에 사용하세요. 재판매에는 리셀러 라이선스를 요청하세요.

상업용 앱

서비스의 유료 기능에 텍스트, 이미지, 영상, 소리 생성을 넣으세요.

리셀러 라이선스

프로젝트 설명과 접근 구조를 보내 사용·재판매의 서면 조건을 요청하세요.

사이트의 문서

연결 전에 공식 이용 조건, 라이선스 계약, 데이터 처리 정책을 읽을 수 있습니다.

[리셀러 라이선스 요청](mailto:support@ailoot.ai) · [공식 이용 조건과 라이선스 계약](https://ailoot.ai/legal/offer?lang=ko)

## Ailoot · 회사와 그 프로젝트 포트폴리오





Ailoot는 축적된 운영 경험, 폭넓은 고객 기반, 안정적인 서비스, 지속적인 KPI 관리를 바탕으로 합니다.





회사와 그 프로젝트 포트폴리오: 수백만 고객, 매월 수십억 규모의 매출.





Ailoot는 이러한 운영 경험을 고객의 제품, 에이전트, 애플리케이션, 자동화에서 AI 기능을 이용할 수 있는 API 접근에 활용합니다.