GetAPI.ONE
GetAPI.ONE에서 원본 CCSwitch 절차 사용
CCSwitch가 제공하는 호환 Codex 대상을 위한 범위 제한 데스크톱 설정 가이드이며, 공식 ChatGPT 소비자 앱의 미확인 경계를 명시합니다.
호환성 범위
GetAPI 원본은 이 절차를 “Codex/ChatGPT”라 부르며 타사 CCSwitch 앱으로 OpenAI 호환 공급자를 추가하도록 안내합니다. 2026-09-07에 검토한 공식 ChatGPT 데스크톱 페이지는 앱 설치와 ChatGPT 계정 로그인을 설명하지만 임의의 타사 API 공급자 필드는 설명하지 않습니다.
사전 조건
- 현재 CCSwitch 릴리스에서 이미 확인한 호환 Codex 클라이언트 또는 연동 대상.
- 프로젝트 릴리스 페이지에서 CCSwitch를 받아 해당 프로젝트의 현재 지침에 따라 설치한 상태.
- 범위가 제한된 비공개 GetAPI.ONE 키와 Responses 엔드포인트를 명시하는 모델.
- ONE 기본 URL은 https://www.getapi.one/v1 입니다. 다른 서비스의 키나 URL과 섞지 마세요.
1. 사용자 지정 공급자 추가
- CCSwitch를 열고 Codex 공급자 영역을 선택하세요.
- 추가를 선택한 뒤 사용자 지정 설정을 선택하세요. 처음 보이는 화면 아래에 있다면 스크롤하세요.
- 공급자 이름을 GetAPI One으로 지정하고 필요하면 웹사이트에 https://www.getapi.one 을 입력하세요.
- API Key 필드에 GetAPI.ONE 키를, API 요청 주소 필드에 https://www.getapi.one/v1 을 붙여 넣으세요.
- YOUR_RESPONSES_MODEL을 키 그룹에서 볼 수 있고 Responses 엔드포인트를 명시하는 정확한 카탈로그 모델로 바꾸고 저장하세요.
| 필드 | ONE 값 |
|---|---|
| 공급자 이름 | GetAPI One |
| 웹사이트(요청되는 경우) | https://www.getapi.one |
| API Key | 비공개 GetAPI.ONE 키 |
| API 요청 주소 | https://www.getapi.one/v1 |
| 기본 모델 | YOUR_RESPONSES_MODEL(교체 필요) |

2. 활성화, 재시작, 대상 확인
- 공급자 목록으로 돌아가 GetAPI One을 활성화하세요.
- 호환 대상을 완전히 종료했다가 다시 열어 공급자 설정을 다시 읽게 하세요.
- 무엇이든 보내기 전에 선택한 공급자가 GetAPI One이고 모델이 입력한 정확한 카탈로그 모델인지 확인하세요.
3. 연결 확인
- 현재 요금을 검토한 후에만 과금 가능성을 수락하는 최소 메시지 하나를 보내세요.
- 대상이 유효한 응답을 받는지 확인하세요.
- GetAPI.ONE 콘솔에 일치하는 요청 또는 사용 기록이 나타나는지 확인하세요. 이 가이드를 만드는 동안 실제 모델 요청을 보내지 않았습니다.
일반적인 실패별 처리
| 증상 | 확인 |
|---|---|
| 401 / Unauthorized | ONE 키를 다시 복사하고 활성 여부를 확인하며 ONE 주소와만 조합하세요. |
| 404 / Not Found | CCSwitch 요청 주소에 /v1을 유지하고 대상이 호환되지 않는 경로를 추가했는지 확인하세요. |
| Model not found | 키 그룹에서 볼 수 있고 필요한 엔드포인트가 표시된 정확한 모델 이름을 사용하세요. |
| 활성화 후 변화 없음 | 올바른 CCSwitch 대상과 공급자가 활성화되었는지 확인하고 대상을 완전히 재시작한 뒤 설치 버전의 해당 절차 지원을 확인하세요. |
| 시간 초과 또는 응답 없음 | 잔액, 키 한도와 만료, 속도 제한, 네트워크, 게이트웨이 상태, 업스트림 오류 상세를 순서대로 확인하세요. |