ai.aiinplanet.com ●

Gemma (gemma4) — OpenAI 호환 LLM API · 웹검색 자동 증강
Base URL
https://ai.aiinplanet.com
호환 규격
OpenAI API 호환 (/v1/...)
인증
Authorization: Bearer <API_KEY> (키는 별도 안내)
모델
gemma4:26b · gemma4
웹검색
최신 정보가 필요한 질문은 자동으로 웹검색 후 답변 (별도 설정 불필요)
스트리밍
SSE 지원 ("stream": true)
API 키는 보안을 위해 이 공개 문서에 표시하지 않습니다. 아래 예제의 YOUR_API_KEY 자리에 발급받은 키(sk-aiin-…)를 넣어 사용하세요.

엔드포인트

메서드경로설명인증
GET /v1/models 사용 가능한 모델 목록 공개
POST /v1/chat/completions 채팅 컴플리션 (메인) Bearer 필수
POST /v1/completions 텍스트 컴플리션 Bearer 필수
POST /v1/embeddings 임베딩 Bearer 필수

/v1/models를 제외한 모든 경로는 올바른 Bearer 키가 없으면 401을 반환합니다.

빠른 시작

cURL
Python (openai)
JavaScript
스트리밍
# 모델 목록 (공개)
curl https://ai.aiinplanet.com/v1/models

# 채팅 (Bearer 키 필요)
curl https://ai.aiinplanet.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemma4:26b",
    "messages": [{"role": "user", "content": "안녕하세요"}],
    "max_tokens": 1024
  }'
from openai import OpenAI

client = OpenAI(
    base_url="https://ai.aiinplanet.com/v1",
    api_key="YOUR_API_KEY",
)

resp = client.chat.completions.create(
    model="gemma4:26b",
    messages=[{"role": "user", "content": "안녕하세요"}],
    max_tokens=1024,
)
print(resp.choices[0].message.content)
const res = await fetch("https://ai.aiinplanet.com/v1/chat/completions", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "gemma4:26b",
    messages: [{ role: "user", content: "안녕하세요" }],
    max_tokens: 1024,
  }),
});
const data = await res.json();
console.log(data.choices[0].message.content);
# SSE 스트리밍 — "stream": true 추가
curl -N https://ai.aiinplanet.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemma4:26b",
    "messages": [{"role": "user", "content": "긴 글을 써줘"}],
    "max_tokens": 2048,
    "stream": true
  }'

웹검색 (자동 증강)

API 사용법은 그대로입니다. 별도 파라미터·모델명·헤더가 필요 없습니다. 평소처럼 /v1/chat/completions를 호출하면, 최신 정보가 필요한 질문은 게이트웨이가 자동으로 웹을 검색해 그 결과를 근거로 답합니다.

동작 방식

마지막 사용자 메시지를 기준으로 3단계로 처리합니다.

  1. 판단 — 이 질문에 최신 웹검색이 필요한지 모델이 스스로 결정합니다.
  2. 검색 — 필요하면 검색엔진(SearXNG)으로 상위 결과를 가져와 본문을 수집합니다.
  3. 답변 — 수집한 내용을 컨텍스트로 주입해 최신 사실에 기반한 답을 생성합니다 (스트리밍도 그대로 동작).

검색이 켜지는 질문 / 켜지지 않는 질문

자동 검색 ✓검색 안 함 ✗
최신 뉴스·시사, 가격·환율, 날씨, 스포츠 결과, 신제품/릴리스, 인물의 현재 상태 등 학습 시점 이후의 시의성 있는 정보 창작·글쓰기, 번역, 코딩, 수학, 일반 상식, 잡담, 이미 제공한 텍스트에 대한 추론

예시

# 최신 정보 질문 → 자동으로 웹검색 후 답변 (요청 형식은 기존과 동일)
curl https://ai.aiinplanet.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemma4:26b",
    "messages": [{"role": "user", "content": "오늘 비트코인 시세 알려줘"}],
    "max_tokens": 1024
  }'

참고

참고 사항

reasoning 모델입니다. gemma4는 응답 전에 추론(reasoning) 토큰을 생성합니다. max_tokens를 너무 작게 주면 추론에 예산이 소진되어 content가 비고 finish_reason: "length"가 됩니다. 1024 이상을 넉넉히 주세요.