GetAPIGetAPI.ONE
GetAPI.ONE 빠른 시작
계정 생성과 모델 선택부터 범위 제한 API 키, 클라이언트 설정, 검증 가능한 첫 연결까지의 전체 과정입니다.
시작 전
- 공식 https://www.getapi.one 도메인과 인증에 접근 가능한 이메일을 사용하세요.
- Codex CLI, 원본 CCSwitch 절차, 직접 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 기본 주소를 확인하세요.
- 모델을 찾을 수 없다면 키 그룹에 공개되고 엔드포인트에 호환되는 모델을 고르세요. 한도, 속도, 네트워크, 업스트림 오류는 타임스탬프와 요청 식별자를 보존한 뒤 진단하세요.