Gemma API 키 문서

인증 및 Base URL

고유한 API 키를 사용하여 모든 요청을 인증하세요. 기본 URL은 HTTPS://api.gemmaapikey.com/v1이며 Authorization 헤더에 키를 전송합니다. 이는 base_url과 API 키를 변경하여 모든 OpenAI 호환 클라이언트와 함께 작동합니다. 분실 시 대시보드에서 새 키를 생성할 수 있습니다. 이전 키는 즉시 작동하지 않게 됩니다. 오류 및 거부 요청은 미리 결제된 크레딧을 소모하지 않습니다.

첫 번째 요청

모델 id "uncensored"를 사용하여 /v1/chat/completions으로 POST 요청을 보내세요. messages 배열에 시스템 프롬프트와 사용자 메시지를 포함하세요. 모델은 합법적인 성인 사용에 대한 콘텐츠 거부 없이 생성된 텍스트로 응답합니다.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.gemmaapikey.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)

temperature와 top_p를 사용하여 무작위성을 제어합니다. 생성을 조기에 중단하기 위해 stop 시퀀스를 사용하세요. 스트리밍이 활성화된 경우 응답에는 마지막 청크에 토큰 사용량이 포함됩니다.

Node SDK 통합

공식 OpenAI SDK for Node.js를 설치하세요. API 키와 이 가이드의 기본 URL을 사용하여 구성하세요. 프롬프트와 함께 chat.completions.create 메서드를 호출하세요.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.gemmaapikey.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);

이 방식은 사용된 토큰에 대해서만 지불하므로 비용이 예측 가능합니다. 선불 크레딧은 실제 사용량에 따라 청구됩니다. 월 구독료가 없습니다. 언제든지 크립토로 충전할 수 있습니다.

스트리밍 응답

요청에서 stream을 true로 설정하여 스트리밍을 활성화하세요. API는 서버 전송 이벤트(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개의 요청만 동시에 실행할 수 있습니다. 요청 본문은 8MB를 초과해서는 안 됩니다. 이러한 제한은 모든 사용자의 안정적인 성능을 보장합니다.

이 모델은 함수 호출, JSON 모드, seed 및 presence_penalty와 같은 표준 매개변수를 지원합니다. 최대 출력은 요청당 16,000 토큰입니다. max_tokens을 설정하지 않으면 기본값은 2,048입니다.

오류 및 문제 해결

401 오류는 API 키가 유효하지 않거나 만료되었음을 의미합니다. 대시보드에서 활성 키를 확인하십시오. 402 오류는 미결제 크레딧이 부족함을 나타냅니다. 계속하려면 암호화폐로 충전하십시오. 429 오류는 속도 제한에 도달했음을 의미합니다. 몇 초 후 다시 시도하십시오.

오류는 크레딧이 소모되지 않습니다. 중복 과금이 발생한 경우 지원 페이지를 통해 수정할 수 있습니다. 크레딧은 만료되지 않으므로 나중에 충전할 수 있습니다.

cURL

Copycurl https://api.gemmaapikey.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Return the current system status"}]
  }'