시작하기

토큰 사용

LLMs Text

토큰 사용

sk-4ai-...는 4AICode 릴레이에 접근하는 유일한 자격 증명이며, 모든 요청에 포함해야 합니다.

토큰 생성

대시보드 → 토큰 관리 → 새 토큰으로 이동해 이름을 입력하고 만들기를 클릭합니다.

⚠️ 토큰은 한 번만 표시됩니다. 1Password, Bitwarden 등 비밀번호 관리자에 즉시 복사하세요. 대화상자를 닫으면 복구할 수 없으며, 폐기 후 새로 만들어야 합니다. 채팅 창에 붙여넣거나 git에 커밋하지 마세요.

사용 방법

Authorization: Bearer 헤더를 사용합니다.

Authorization: Bearer sk-4ai-xxxxxxxxxxxxxxxx

URL 쿼리 매개변수(?api_key=...)와 X-Api-Key 헤더는 HTTP 로그에 노출되기 쉬워 지원하지 않습니다.

팀 격리

토큰은 생성된 팀 하의 리소스에만 접근할 수 있습니다.

  • 팀 전환 → 새 토큰 생성
  • 사용량은 항상 토큰 소유 팀에 청구됩니다

모든 팀에 접근하는 단일 토큰은 없습니다.

토큰 폐기

토큰 관리 페이지에서 폐기를 클릭합니다. 폐기는 되돌릴 수 없으며 즉시 적용됩니다. 1초 이내에 모든 요청이 401을 반환합니다. 폐기 후 같은 이름으로 새 토큰을 만들 수 있습니다.

토큰을 폐기해야 하는 경우

상황폐기?
공개 저장소, 단체 채팅, 스크린샷에 노출✅ 즉시
퇴사한 직원의 개발 PC에 저장✅ 즉시
정기 교체(90일마다 권장)✅
노트북 교체❌ 그대로 재사용
유출 의심✅ 우선 폐기

오류 코드

상태 코드의미
401토큰 누락, 형식 오류, 또는 폐기됨
403관리자에 의해 팀이 정지됨
429속도 제한 또는 할당량 초과. 속도 제한 / 할당량 참고.

FAQ

Q: 토큰은 몇 개까지 만들 수 있나요? A: 하드 제한은 없습니다. 기기별로 하나씩 두면 해당 기기 접근만 개별적으로 폐기할 수 있습니다.

Q: 하나의 토큰으로 Claude와 GPT-5를 모두 쓸 수 있나요? A: 예. 토큰은 모델이 아니라 팀에 연결됩니다.