Gemma API: 5분 내 첫 요청

베이스 URL 및 인증

API 키 발급 페이지에서 계정을 생성하세요. 이메일과 비밀번호만 있으면 되며, 무료 체험 크레딧 활성화에 전화번호나 신용카드가 필요하지 않습니다. 등록하면 API 키가 즉시 표시됩니다. 이 키를 복사하여 안전하게 저장하세요. 모든 요청에 Authorization 헤더의 Bearer 토큰으로 사용하세요. 모든 엔드포인트의 베이스 URL은 https://api.gemma4api.com/v1입니다. 이 URL은 모든 표준 OpenAI 호환 클라이언트와 호환되며, 구성의 베이스 URL과 API 키를 변경하여 공급자만 전환하면 됩니다.

첫 번째 요청

curl을 사용하여 첫 번째 프롬프트를 보내 연결성을 확인하세요. YOUR_API_KEY을 실제 키로 바꿉니다. 모델 식별자는 uncensored입니다. 이 간단한 텍스트 입력-출력 요청은 인증이 올바르고 모델이 응답함을 확인합니다. choices 배열이 있는 JSON 응답을 받으면 설정이 완료된 것입니다. 이제 더 복잡한 워크플로우를 위해 SDK를 통합할 수 있습니다.

Copycurl https://api.gemma4api.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

Python SDK 통합

공식 OpenAI Python 패키지를 설치하세요. 베이스 URL과 API 키 환경 변수를 설정하거나 클라이언트 생성자에 직접 전달하세요. 모델 ID uncensored을 사용하여 특정 인스턴스를 호출하고 있음을 확인하세요. 이 방법은 표준 OpenAI 패턴과 호환되도록 코드를 유지하면서 콘텐츠 생성을 위해 무검열 모델을 활용합니다. SDK는 재시도 및 JSON 파싱을 자동으로 처리합니다.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.gemma4api.com/v1", api_key="YOUR_KEY")

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

Node.js SDK 통합

JavaScript 환경에서는 OpenAI Node.js 패키지를 설치하세요. 베이스 URL https://api.gemma4api.com/v1과 API 키로 클라이언트를 구성하세요. 완료 호출에 모델 ID uncensored을 사용하세요. 이 설정은 표준 OpenAI 호환 코드 구조를 유지하면서 서버에서 호스팅된 특정 모델의 이점을 누릴 수 있게 합니다. Node.js 이벤트 루프 내에서 비동기 응답을 올바르게 처리하세요.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.gemma4api.com/v1", apiKey: process.env.API_KEY });

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

스트리밍 응답

API 요청에서 stream 매개변수를 true로 설정하여 스트리밍을 활성화하세요. 이는 서버 전송 이벤트(SSE) 스트림을 반환하여 생성되는 토큰을 표시할 수 있게 합니다. 이는 지연 시간이 중요한 채팅 인터페이스에 이상적입니다. 각 청크에는 응답의 부분 델타가 포함됩니다. 생성이 완료되었음을 알기 위해 스트림 종료 이벤트를 처리하세요. 이 방법은 전체 응답을 기다리는 것보다 인지된 지연 시간을 크게 줄입니다.

Copystream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

제한, 오류 및 컨텍스트 창

요청에는 프롬프트와 완성 텍스트를 합산한 컨텍스트 창 100,000 토큰이 지원됩니다. 속도 제한은 키당 분당 300 요청이며, 최대 요청 본문 크기는 8 MB입니다. 일반적인 오류로는 잘못된 키의 경우 401, 선불 크레딧이 고갈된 경우 402, 분당 제한을 초과한 경우 429이 있습니다. API 키를 재생성하면 이전 키가 무효화되지만 속도 카운터는 초기화되지 않습니다. 클라이언트가 이러한 HTTP 상태 코드를 적절히 처리하여 원활한 운영을 유지하도록 하세요.