GetAPI.ONE API 시작하기: API 키 발급부터 첫 요청까지

계정 생성 및 모델 선택부터 범위가 지정된 API 키, 클라이언트 구성 및 작동하는 첫 번째 연결까지의 전체 경로입니다.

여기서 시작하세요

GetAPI.ONE을 처음 사용한다면 계정을 만들고 모델과 지원 엔드포인트를 선택한 다음 API 키를 생성하세요. 이미 키가 있다면 아래 Python 또는 Node.js 예제로 바로 이동할 수 있습니다. 요청을 보내기 전에 현재 요금을 확인하세요.

시작 전

공식 https://www.getapi.one 도메인과 인증에 접근 가능한 이메일을 사용하세요.
CCSwitch를 통해 호환되는 Codex 대상인 Codex CLI를 연결할지, 아니면 자체 API 클라이언트를 연결할지 결정하세요.
개인 비밀번호 관리자나 환경 변수 저장소를 준비하세요. 실제 키를 공개 이슈, 스크린샷, 저장소에 붙여 넣지 마세요.

1. 계정 생성 및 열기

가입 페이지에서 사용자 이름, 8–20자 비밀번호, 이메일을 입력하세요.
이메일 코드를 요청하고 입력한 뒤 연결된 이용약관과 개인정보 처리방침을 검토하고 동의하여 계정을 생성하세요.
사용자 이름 또는 이메일과 비밀번호로 로그인하세요. 성공하면 개요 페이지가 열립니다.

2. 잔액, 엔드포인트, 모델 확인

과금 요청 전에 계정에 사용 가능한 잔액 또는 적용 가능한 패키지가 있는지 확인하세요.
카탈로그에서 클라이언트가 사용하는 엔드포인트를 명시하는 모델을 선택하세요. 모델 이름으로 프로토콜 지원을 추정하지 마세요.
사용 직전에 라이브 가격을 공개하세요. 가용성과 가격은 변경될 수 있으므로 현재 모델, 그룹, 가격 모드 및 청구 단위를 확인하세요.

3. 범위 제한 API 키 생성

API 키에서 만들기를 선택하고 클라이언트나 프로젝트를 식별하는 이름을 지정하세요.
필요한 그룹, 구체적인 만료, 연동에 맞는 한도를 선택하세요. 필요한 접근을 이해한 경우에만 고급 제한을 확대하세요.
키를 저장하고 목록에서 개인 저장소로 복사하세요. GetAPI.ONE은 관리 가능한 목록 항목을 유지하므로 나중에 다시 복사할 수 있습니다.

4. 클라이언트 하나 연결

클라이언트에 맞는 경로만 사용하세요. Codex 사용자 지정 공급자는 Responses wire API와 ONE 기본 URL https://www.getapi.one/v1 을 사용합니다. 직접 API 프로그램은 경로를 무조건 추가하지 말고 명시된 개별 엔드포인트를 사용해야 합니다.

5. 확인 후 계속

성공은 선택한 클라이언트가 유효한 응답을 받고 GetAPI.ONE 콘솔에 요청이 기록되는 것입니다. 로컬 문법 검사만으로 실제 호출 성공을 판단할 수 없습니다.
401이면 ONE 키를 다시 복사하고 활성 상태와 ONE 주소 조합을 확인하세요. 404이면 클라이언트가 기대하는 정확한 엔드포인트나 /v1 기본 주소를 확인하세요.
모델을 찾을 수 없다면 키 그룹에 공개되고 엔드포인트에 호환되는 모델을 고르세요. 한도, 속도, 네트워크, 업스트림 오류는 타임스탬프와 요청 식별자를 보존한 뒤 진단하세요.