여기서 API 키 생성하기 (Grok 키 아님)

먼저, 이 키가 무엇이며 무엇이 아닌지

이 사이트의 키는 정확히 하나의 것만 엽니다: https://api.grokkey.com/v1의 API입니다. xAI의 엔드포인트에서는 작동하지 않으며, 다른 벤더의 키는 여기서 작동하지 않습니다. 이 서비스는 xAI, OpenAI, Meta, Mistral, Qwen, DeepSeek, Google 또는 Anthropic의 공식 API가 아니며, 해당 회사로 요청을 전달하는 라우터도 아닙니다.

제공되는 것은 단일 모델 ID를 가진 OpenAI 호환 텍스트 API입니다. 모델 ID는 uncensored이며, 법적 성인 사용자를 위한 콘텐츠 거부 없이 답변하도록 조정되었습니다. Grok 자체용 키가 필요하면 xAI의 자체 콘솔과 문서를 사용하세요. 판타지, 역할극, 동반자 앱 또는 거부 레이어 없이 직설적인 텍스트 작업에 호스팅 모델이 필요하면 계속 읽으세요.

단계: 가입부터 작동하는 키까지

1. 키 페이지 열기. API 키 페이지로 이동하여 Google 또는 이메일과 비밀번호로 회원가입하세요.
2. 체험 크레딧 받기. 회원가입 후 해당 페이지에서 원클릭으로 $0.50의 체험 크레딧을 받습니다. 인원당 1회 한도로 7일 동안 유효하며 카드가 필요하지 않습니다.
3. 키 복사하기. 키는 같은 페이지에 표시됩니다. 비밀번호처럼 취급하세요.
4. 코드 외부에 저장하기. 환경 변수에 넣으세요. 예를 들어 export API_KEY="paste-your-key-here"와 같이 사용합니다.
5. 테스트 호출하기. 아래 코드 스니펫 중 하나를 사용하세요. 응답이 오면 키가 작동한다는 의미입니다.

전체 과정은 몇 분 정도 걸리며, 프로젝트, 청구 프로필 또는 콘솔 설정이 필요하지 않습니다. 체험 크레딧이 소진되면 선불 크레딧로 충전할 수 있습니다(아래 청구 섹션 참조).

curl로 키 테스트하기

Copycurl https://api.grokkey.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Say hello in five words."}]
  }'

키가 유효하면 JSON 완료 응답을 받습니다. 응답 헤더도 확인하세요: X-Balance-USD은 남은 크레딧을 보여주며, X-Request-Id은 특정 요청에 대해 지원에 문의할 때 유용합니다. GET /v1/balance로 직접 잔액을 확인할 수도 있습니다.

Copycurl https://api.grokkey.com/v1/balance \
  -H "Authorization: Bearer $API_KEY"

Python 또는 Node에서 호출하기

베이스 URL과 키를 변경하면 모든 OpenAI SDK가 작동합니다. Python에서는 다음과 같습니다:

Copyimport os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.grokkey.com/v1",
    api_key=os.environ["API_KEY"],
)

stream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Give me three names for a fantasy tavern."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="")

Node에서는 공식 openai 패키지를 사용하여 다음과 같이 합니다:

Copyimport OpenAI from "openai";

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

const res = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Give me three names for a fantasy tavern." }],
});
console.log(res.choices[0].message.content);

스트리밍은 서버 전송 이벤트를 사용하며 사용량을 마지막에 보고합니다. 함수 호출, JSON 모드 및 일반적인 샘플링 매개변수도 작동합니다. 자세한 내용은 문서 페이지에서 확인하세요.

채팅 프론트엔드에서 사용하기

코드를 작성할 계획이 없다면 많은 채팅 및 역할극 프론트엔드가 OpenAI 호환 제공업체를 지원합니다. 예를 들어 SillyTavern은 OpenAI 호환 엔드포인트를 추가할 수 있게 해줍니다. 설정은 모든 해당 앱에서 동일한 세 가지 필드로 이루어집니다: 베이스 URL https://api.grokkey.com/v1, 키 및 모델 이름 uncensored. 일부 앱은 목록에서 모델을 선택하라고 요청할 수 있습니다. 목록이 비어 있으면 직접 이름을 입력하거나 GET /v1/models로 가져오세요.

연결 테스트가 통과하면 앱은 위의 코드 스니펫과 동일한 요청을 보냅니다. 스트리밍이 지원되므로 응답이 단어 단위로 나타납니다. 앱에 컨텍스트 크기 필드가 있는 경우 100,000 토큰이 프롬프트와 응답 간에 공유되는 컨텍스트 창입니다.

이 키가 벤더 콘솔 키와 다른 점

벤더 콘솔은 서로 다르므로 각 벤더의 문서에서 최신 세부 정보를 확인하세요. 몇 가지 차이점은 이 서비스에 고유하며 이에 대해 확신 있게 설명할 수 있습니다.

• 셀프서비스 재발급. API 키 페이지에서 원하는 때에 언제든지 키를 재생성할 수 있습니다. 이전 키는 즉시 작동하지 않게 됩니다. 키가 유출된 경우 다른 사람에게 연락할 필요 없이 교체할 수 있습니다.
• 충전 후 여러 키. 충전된 계정은 최대 5개의 키를 보유할 수 있으며, 각 키에 레이블(예: 앱별 또는 환경별)을 지정하고 언제든지 회수할 수 있습니다.
• 하나의 모델, 하나의 이름. 선택할 모델 카탈로그가 없습니다. 모든 호출은 uncensored를 사용하며, GET /v1/models에 나열됩니다.
• 선불 방식, 사후 정산 아님. 크레딧이 먼저 로드되고 토큰당 차감됩니다. 실패하거나 거부된 요청은 요금이 부과되지 않으며, 크레딧은 만료되지 않습니다.

체험 키는 동시 요청 2개와 분당 60개의 요청으로 제한됩니다. 충전 후 제공되는 전체 키는 동시 요청 8개와 분당 300개의 요청을 허용합니다. 한도를 초과하면 API는 HTTP 429를 반환하며 오류 코드 rate_limited 또는 concurrency이 발생합니다. 이때 짧은 대기 후 다시 시도하는 것이 올바른 대응입니다.

체험 후 청구

가격은 입력 토큰 100만 개당 $0.15, 출력 토큰 100만 개당 $0.50입니다. 따라서 $0.50 체험 크레딧은 약 333만 개의 입력 토큰 또는 100만 개의 출력 토큰, 또는 두 토큰의 혼합을 구매할 수 있습니다. 입력 토큰 2,000개와 출력 토큰 500개로 구성된 요청의 비용은 $0.00055이므로, 체험 크레딧은 약 909개의 요청을 커버할 수 있어 작은 도구를 구축하고 테스트하기에 충분합니다.

계속 진행할 준비가 되면 $20에서 $500 사이의 전체 금액으로 충전할 수 있으며, $50부터 +5%, $100부터 +10%, $200부터 +15%의 보너스가 제공됩니다. 결제는 암호화폐로만 가능하며, TRC20의 USDT 또는 Base의 USDC를 사용합니다. 가격 책정 페이지에 세부 정보가 있습니다. Claude 키와 비교 중이라면 Claude API 키 vs GrokKey 기사를 참조하세요.

키 안전하게 유지하기

API 키는 Bearer 자격 증명입니다. 키를 가진 사람은 잔액을 사용할 수 있습니다. 몇 가지 습관을 들이면 문제를 피할 수 있습니다.

• 소스 컨트롤에서 제외하기. 환경 변수 또는 비밀 관리자에서 로드하고, 로컬 .env 파일을 .gitignore에 추가하세요.
• 브라우저로 전송하지 않기. 웹 페이지가 API에 직접 호출하면 누구나 페이지에서 키를 읽을 수 있습니다. 페이지와 API 사이에 작은 서버를 두고 키를 거기에 보관하세요.
• 앱당 하나의 키 사용. 충전 후 최대 5개의 키를 생성하고 앱 이름이나 환경과 같은 레이블을 지정할 수 있습니다. 하나가 오용되면 나머지에는 영향을 주지 않고 해당 키를 회수하세요.
• 잔액 헤더 확인하기. 설명할 수 없는 X-Balance-USD의 급격한 하락은 키 유출의 가장 초기 징후입니다. 키 페이지에서 즉시 재생성하면 이전 키는 즉시 작동하지 않게 됩니다.
• 로그에서 정보 감추기. 요청 헤더를 로깅하는 경우 Authorization 줄을 마스킹하세요.

API를 통해 전송된 프롬프트는 학습에 사용되지 않지만, 이것이 유출된 키가 무해하다는 의미는 아닙니다. 키를 데이터베이스 비밀번호처럼 취급하세요.

자주 발생하는 문제

401 또는 유효하지 않은 키

헤더가 Authorization: Bearer로 시작하여 키가 이어지는지, 불필요한 따옴표나 공백이 없는지 확인하세요. 또한 api.grokkey.com로 전송하고 있는지, 다른 벤더의 호스트가 아닌지 확인하세요. 키를 재생성했으면 이전 값은 더 이상 작동하지 않습니다.

모델을 찾을 수 없음

유일한 모델 ID는 uncensored입니다. 다른 벤더의 이름은 여기서 유효하지 않습니다.

테스트 중 429 오류

체험 키의 경우 동시 요청 2개가 한도입니다. 스트리밍 요청은 스트림이 끝날 때까지 슬롯을 유지하므로, 두 개의 열린 스트림에 세 번째 호출이 추가되면 거부됩니다. 하나가 완료될 때까지 기다린 후 재시도하세요.

느리거나 잘린 응답

긴 생성에는 시간이 걸립니다. stream: true를 사용하여 텍스트가 생성되는 대로 표시되도록 하세요. 요청한 길이에 맞는 클라이언트 타임아웃을 설정하세요. 완료는 100,000토큰 창의 나머지 부분을 사용할 수 있으므로 max_tokens은 선택 사항입니다. 길이를 직접 제한하고 싶을 때 설정하세요.

더 많은 가이드

• API 키 가격 책정: 무료 티어 대 토큰당 요금
• Claude API 키 vs. GrokKey: 무검열 대안