Grok API 키 생성 방법 및 대체 키

벤더를 통해 키 생성

우리는 독립적인 서비스이며 공식 xAI API가 아니므로, xAI 자체 키를 얻으려면 xAI의 페이지가 필요합니다. 이 흐름은 대부분의 제공업체에 공통적이며 메뉴 이름은 다음과 다를 수 있습니다.

1. 계정으로 제공업체의 개발자 콘솔에 로그인하세요.
2. 결제 섹션을 확인하세요. 일부 제공업체는 키가 작동하기 전에 결제 수단이나 예치금을 요구합니다. 제공업체가 요구하는 사항을 확인하세요.
3. API 키 섹션을 열고 새 키 생성을 선택하세요.
4. 프로젝트나 환경 등 사용처를 알 수 있는 이름을 지정하세요.
5. 즉시 키를 복사하세요. 많은 콘솔에서 전체 시크릿은 한 번만 표시합니다.
6. 시크릿 관리자나 환경 변수에 저장하고, 소스 코드에는 저장하지 마세요.

페이지 레이아웃이 일치하지 않으면 제공업체의 문서가 기준입니다. 이 가이드를 포함해 몇 달 전에 작성된 모든 가이드는 이전 인터페이스를 설명할 수 있습니다.

1분 이내에 여기서 키 얻기

우리의 키는 합법적인 성인용으로 콘텐츠 거부 없이 답변하도록 조정된 하나의 호스팅 오픈 웨이트 모델을 제공하는 OpenAI 호환 엔드포인트용입니다. 얻는 데 5단계가 필요합니다.

1. API 키 페이지를 엽니다.
2. Google 또는 이메일과 비밀번호로 회원가입하세요.
3. 무료 체험 크레딧 $0.50을 받기 위해 한 번 클릭하세요. 1인당 1회, 유효 기간 7일이며 카드가 필요하지 않습니다.
4. 페이지에 표시된 키를 복사하세요.
5. 아래 테스트 호출을 실행하세요.

베이스 URL은 https://api.grokaiapikey.com/v1이며, 모델 ID는 uncensored이고, 키는 Authorization: Bearer 헤더에 포함됩니다.

키 테스트

curl로 시작하세요. JSON 응답이 반환되면 키, 베이스 URL 및 모델이 모두 정확합니다.

Copyexport API_KEY="paste-your-key-here"

curl https://api.grokaiapikey.com/v1/chat/completions   -H "Authorization: Bearer $API_KEY"   -H "Content-Type: application/json"   -d '{"model": "uncensored",
       "messages": [{"role": "user", "content": "Reply with the word ready."}]}'

Node에서는 두 가지 설정을 변경한 후 공식 OpenAI 패키지가 작동합니다.

Copyimport OpenAI from "openai";

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

const r = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Reply with the word ready." }],
});
console.log(r.choices[0].message.content);

Python 사용자는 OpenAI(base_url=..., api_key=...)로 동일한 작업을 수행할 수 있습니다. 사용 가능한 메서드는 POST /v1/chat/completions, POST /v1/responses 및 GET /v1/models입니다.

환경 변수로 키 설정

키를 소스 코드에 붙여넣지 마세요. 환경 변수에 넣고 런타임에 읽으세요. 명령어는 시스템마다 다릅니다.

Copy# macOS or Linux, current shell session
export API_KEY="paste-your-key-here"

# Windows PowerShell, current session
$env:API_KEY = "paste-your-key-here"

# Check that the variable is set (macOS or Linux)
test -n "$API_KEY" && echo "key is set"

프로젝트의 경우 .env 파일에 값을 저장하고 .gitignore에 나열하세요. 프레임워크의 로더를 사용하여 로드하세요. 서버의 경우 호스트의 비밀 저장소 또는 배포 플랫폼의 환경 설정을 사용하세요. 이 사이트의 베이스 URL은 https://api.grokaiapikey.com/v1이며, 비밀 정보가 아니므로 코드에 유지해도 안전합니다.

여러 서비스를 실행하는 경우 각 서비스에 고유한 키를 부여하세요. 충전된 계정은 최대 5개의 키를 보유할 수 있으므로 스테이징 복사본, 프로덕션 복사본 및 개인 테스트 키가 모두 각각 고유한 레이블을 가지고 공존할 수 있습니다.

호출이 실패한 경우

증상	잠재적 원인	해결 방법
401 Unauthorized	누락되거나 오타가 있는 키	Bearer 헤더를 확인하고 후행 공백이나 따옴표가 있는지 확인하세요
404 Not Found	잘못된 베이스 URL	경로는 api. 하위 도메인의 /v1/chat/completions이어야 합니다.
모델 오류	잘못된 모델 이름	모델 ID uncensored를 사용하세요.
429 rate_limited	분당 요청 수 초과	시험 키는 분당 60개까지 허용됩니다. 속도를 줄이세요.
429 concurrency	동시에 너무 많음	시험 키는 동시 요청 2개까지 허용됩니다. 스트림은 종료될 때까지 슬롯을 유지합니다.

Retry-After: 5 헤더가 있는 429은 일시적인 과부하를 의미합니다. 5초를 기다렸다가 다시 시도하세요.

요청 ID 사용

모든 응답에는 X-Request-Id 헤더가 포함됩니다. 자체 오류 메시지 옆에 로깅하세요. 지원팀에 실패한 호출에 대해 문의할 때 요청 ID를 제공하면 추측이 아닌 해당 정확한 호출을 찾을 수 있습니다. curl에서는 -i를 추가하여 응답 헤더를 출력하고, Python SDK에서는 raw-response 도우미를 사용하여 읽을 수 있습니다.

문제가 간헐적일 때 헤더도 도움이 됩니다. X-RateLimit-Limit-Requests 및 X-RateLimit-Limit-Concurrency은 귀하의 키에 적용되는 제한을 보여주므로 시험 키인지 전체 키인지 한눈에 알 수 있습니다.

키 교체 또는 추가

누군가 키를 교체하도록 요청할 필요가 없습니다. API 키 페이지에서 원하는 때에 키를 재생성(재발급)할 수 있으며 이전 키는 즉시 사용 중지됩니다. 키가 공개 저장소, 스크린샷 또는 공유 채팅에 들어간 즉시 이 작업을 수행하세요.

충전한 계정은 최대 5개의 키를 보유할 수 있습니다. staging 또는 mobile app과 같이 각 키에 이름을 붙이고, 다른 키에 영향을 주지 않고 임의의 단일 키만 회수할 수 있습니다. 환경마다 키를 하나씩 사용하는 것이 좋습니다. 유출된 스테이징 키를 회수해도 프로덕션 트래픽에는 아무런 영향이 없기 때문입니다.

기존 도구에서 키 사용

키를 사용하려면 코드를 작성할 필요가 없습니다. 많은 채팅 프론트엔드 및 개발자 도구는 사용자 지정 OpenAI 호환 엔드포인트를 지원하며 SillyTavern은 그 중 하나의 공개 예시입니다. 설정은 항상 동일한 세 가지 값을 묻습니다.

• 베이스 URL 또는 API URL: https://api.grokaiapikey.com/v1
• API 키: 복사한 키
• 모델 이름: uncensored

일부 도구는 /chat/completions로 끝나는 전체 경로를 원합니다. 다른 도구는 자체적으로 추가합니다. 404 오류가 발생하면 다른 형식을 시도하세요. 모델 드롭다운이 비어 있는 경우 모델 이름을 직접 입력하거나, GET /v1/models에서 목록을 가져와 단일 모델 ID를 반환하게 하세요.

스트리밍은 동일한 설정을 통해 작동합니다. 답변이 단어별로가 아니라 한 번에 표시되면 도구에서 스트리밍 토글을 찾아보세요.

API 키 보관

• 서버 측에서 유지하세요. 브라우저 JavaScript나 모바일 앱 번들에 포함된 키는 누구나 읽을 수 있습니다.
• 환경 변수에서 로드하고 첫 커밋 전에 env 파일을 .gitignore에 추가하세요.
• 소비 습관을 들이세요: X-Balance-USD 응답 헤더를 확인하여 예상치 못한 잔액 감소가 눈에 띄도록 하세요.
• 별도의 서비스를 위해 별도의 키를 사용하세요. 이렇게 하면 다른 서비스의 중단 없이 하나의 키만 취소할 수 있습니다.

테스트 호출이 성공하면 스트리밍, 함수 호출 및 JSON 모드에 대한 문서를 읽고, 요금제 페이지에서 요금을 확인하세요: 입력 토큰 100만 개당 $0.15, 출력 토큰 100만 개당 $0.50입니다. 폐쇄형 벤더와 비교 중이라면 개발자들이 무검열 모델로 전환하는 이유 기사를 통해 장단점을 확인하세요.

간단한 키 교체 절차

1. API 키 페이지에서 교체할 키를 생성하거나 재생성하세요. 재생성하면 이전 키가 즉시 작동하지 않으므로 코드가 새 값을 받을 준비가 되었을 때 진행하세요.
2. 키가 사용되는 모든 위치의 환경 변수 또는 시크릿을 업데이트하세요.
3. 서비스를 다시 시작하고 이 기사의 curl 테스트를 실행하세요.
4. 메모에 날짜를 적어 두세요. 대부분의 프로젝트에서는 몇 달마다 캘린더 알림을 설정하는 것으로 충분합니다.

충전 후 여러 개의 레이블이 지정된 키를 보유하고 있다면 하나씩 교체하세요. 유출 가능성이 가장 높은 노트북이나 이전 팀원에게 연결된 키부터 취소하세요.

더 많은 가이드

• 무료 Grok API 키: 진실과 사기
• Claude API 키: 개발자들이 무검열 모델로 전환하는 이유