token이란 무엇입니까(API 키)
token은 APIYI를 호출할 때 사용하는sk-로 시작하는 API 키입니다. 이는 귀하의 신원과 권한을 위한 인증 정보입니다. 주요 역할은 다음과 같습니다:
인증
모든 API 호출에는 신원과 계정을 확인하기 위한 token이 포함되어야 합니다.
쿼터 및 권한 제어
token별로 전용 쿼터, 만료일, 허용 모델 및 그룹을 설정할 수 있습니다.
사용 통계
각 token의 지출, 남은 쿼터, 호출 로그를 독립적으로 추적합니다.
유연한 할당
서로 다른 프로젝트나 팀원별로 별도의 token을 생성할 수 있습니다.
등록 후 시스템은 별도 설정 없이 바로 사용할 수 있는 기본 token을 자동으로 생성합니다. 필요에 따라 추가 token도 생성할 수 있습니다.
토큰을 만드는 방법
1
토큰 페이지 열기
상단 내비게이션에서 “Token” 페이지를 엽니다: https://api.apiyi.com/token
2
‘New’ 클릭
오른쪽 상단의 “New” 버튼을 클릭하여 토큰 생성 대화상자를 엽니다.
3
토큰 세부정보 입력
토큰 이름, 쿼터(무제한 선택 가능), 만료(만료 없음 선택 가능), 과금 방식, 그룹(아래 참조)을 설정합니다.
4
저장하고 KEY 복사
저장한 후 토큰 오른쪽의 복사 아이콘을 클릭하여 전체
sk- KEY를 복사합니다.
토큰 편집 및 코드 예제 보기
모든 작업을 펼치려면 “작업” 열의 **관리 메뉴(렌치 아이콘)**를 클릭합니다:
“요청 예시”는 코드 예제 진입점입니다. 현재 토큰이 미리 채워진 실행 가능한 호출 코드를 생성하므로, KEY와 엔드포인트를 직접 조합할 필요가 없습니다. 빠른 테스트와 연동에 적합합니다.
여러 사람이 하나의 token을 함께 사용하면 요청 제한이 걸리나요?
고객들이 자주 묻는 질문입니다: “하나의 token을 여러 사람이 공유하면 요청 제한이 걸리나요?” 답은 token 자체에는 요청 제한이 없습니다입니다. 요청 제한은 보유한 token 수나 사용하는 사람 수와 관계없이 계정을 따릅니다. 즉, 10명이 하나의 token을 공유하든 1명이 token 10개를 각각 사용하든, 동작은 정확히 동일합니다.RPM (분당 요청 수)
일반적으로 100 RPM까지 사용하는 단일 계정이면 충분합니다. 대부분의 팀과 애플리케이션에 넉넉한 수준입니다.
TPM (분당 token 수)
TPM은 적용되지 않으므로, 긴 컨텍스트나 높은 동시 token 사용량 때문에 제한이 걸릴 걱정을 하지 않으셔도 됩니다.
그룹이란
그룹은 token에 대해 선택할 수 있는 “리소스 채널”입니다. 서로 다른 그룹은 서로 다른 상위 리소스, 사용 가능한 모델 범위, 그리고 과금 요율 배수에 매핑되며, 사용자가 선택할 수 있도록 열려 있습니다. 요약하면: 동일한 모델이 여러 상위 채널로 제공될 수 있으며, 그룹은 사용할 채널을 선택하게 합니다. 서로 다른 모델은 서로 다른 그룹이 필요할 수 있습니다, 따라서 올바른 그룹을 선택하면 호출이 정상적으로 작동하고 해당 할인도 적용됩니다.대부분의 경우, 기본 그룹(Default) 만으로 충분합니다 — 텍스트 모델, NanoBanana 시리즈, Veo 3.1, 그리고 대부분의 다른 모델을 포함한 전체 모델 커버리지를 제공합니다.
기본 그룹 및 대체 그룹
하나의 token에는 최대 3개 그룹: 기본 그룹 1개 + 대체 그룹 2개.기본 그룹(주)
token이 가장 먼저 사용하는 그룹이며, 대부분의 모델을 지원합니다. 모든 token에는 기본 그룹 1개가 있어야 합니다.
대체 그룹(백업)
기본 그룹이 요청을 처리할 수 없을 때 자동으로 활성화되는 백업 채널입니다. 최대 2개까지 추가할 수 있으며, 호출 성공률을 높입니다.
- 그룹 선택: 기본(주) 그룹을 설정합니다, 기본적으로
Default입니다 - 대체 그룹: 주 그룹을 사용할 수 없을 때 대신할 1–2개의 백업 그룹을 추가합니다
서로 다른 모델에는 서로 다른 그룹이 필요합니다
기본 그룹은 대부분의 모델을 지원하지만, 일부 모델(특히 동영상 모델)에는 전용 그룹이 필요합니다:그룹 개요
아래는 시스템이 제공한 그룹과 설명입니다(콘솔 표기가 기준입니다):
“그룹 요율 배수” 열은 RMB로 책정된 상대 값입니다 — 이는 USD에 대한 직접 할인 비율이 아니므로, 너무 깊게 해석할 필요는 없습니다. 모델에 맞는 그룹을 선택하시면 됩니다. 배수와 가격 환산을 이해하려면 모델의 배수란 무엇입니까?를 참조하십시오.
관련 문서
Token 과금 모드
사용량별 과금 모드와 호출당 과금 모드의 차이를 이해합니다.
Token 모델 허용 목록
단일 token이 사용할 수 있는 모델을 제한하는 방법입니다.
모델 요율 배수
요율 배수의 의미와 가격 계산을 이해합니다.
호출 로그
token별 호출 기록과 지출 내역을 확인합니다.