주요 포인트
- 프록시는 OpenAI 채팅 완성 형식을 사용합니다. 요청을 OpenAI로 전달하지 않습니다.
- 어떤 클라이언트든 https://api.openaiapiproxy.com/v1을 가리키게 하고, 키를 사용하며 모델을 uncensored로 설정하십시오.
- 지원: 채팅 완성, 모델 목록, 스트리밍, 함수 호출 및 JSON 모드. 미지원: 이미지, 오디오, 임베딩, 파인튜닝.
- 대부분의 오류는 경로에 /v1이 중복으로 포함되거나 모델 이름이 잘못되었거나 속도 제한으로 인한 429 오류에서 비롯됩니다.
여기서 프록시라는 단어의 의미
사람들은 "프록시"라는 단어를 광범위하게 사용하므로 정확한 이해가 필요합니다. 이러한 openai 호환 api 프록시의 경우 이 단어는 인터페이스를 의미합니다. 서버는 OpenAI 요청 형식을 받고 OpenAI 응답 형식을 반환합니다. 코드만으로는 전송된 데이터 형식에서 차이를 알 수 없습니다.
트래픽이 OpenAI나 다른 회사로 중계된다는 의미는 아닙니다. 요청은 독립적인 제공업체가 운영하는 단일 오픈 웨이트 모델로 전송되며, 합법적인 성인 사용에 적합하도록 콘텐츠 거부 없이 답변하도록 조정되었습니다. 이는 OpenAI, Meta, Mistral, Qwen, DeepSeek, Google, Anthropic 또는 xAI의 공식 API가 아니며, 벤더 간 라우터도 아닙니다. 이 구별은 기대치에 중요합니다: 단일 모델만 있으며 그 ID는 uncensored입니다.
개발자가 모델 앞에 호환 레이어를 두는 이유
OpenAI 요청 형식은 LLM 도구 생태계의 공통 언어가 되었습니다. 라이브러리, 에디터, 에이전트 프레임워크 및 노코드 도구는 모두 이를 지원합니다. 호환 엔드포인트를 사용하면 클라이언트를 새로 작성하지 않고도 모든 것을 재사용할 수 있습니다.
- 새로운 SDK 불필요. Base URL만 변경하면 공식 OpenAI 라이브러리가 작동합니다.
- 무료 도구 지원. 사용자 정의 엔드포인트 필드가 있는 모든 것이 대상이 됩니다: 채팅 프론트엔드, 에디터 플러그인, 스크립트 등.
- 쉬운 롤백. 새 모델이 적합하지 않다면 이전 URL로 되돌리면 코드에서 다른 변경 사항 없이 이전 상태로 복귀할 수 있습니다.
- 정책의 단일 관리 지점. 엔드포인트에서 원하는 모델 동작을 선택하면 모든 프롬프트에서 거부와 싸울 필요가 없습니다.
대가로 구현된 인터페이스의 제한을 수용해야 합니다. 다음 섹션의 표가 전체 목록입니다.
지원 및 미지원 항목
| 항목 | 상태 |
|---|---|
POST /v1/chat/completions | 지원됨 |
GET /v1/models | 지원됨, 모델 uncensored 반환 |
| 스트리밍 (SSE) | stream: true를 지원하며, 스트리밍 종료 시 사용량을 보고합니다 |
| 도구 호출 | 지원: tools, tool_choice, 스트리밍 tool_calls, role: "tool" 결과 |
| JSON 모드 | response_format을 통해 지원됨 |
| 샘플링 매개변수 | temperature, top_p, stop, seed 및 페널티가 전달됩니다 |
| 이미지, 오디오, 비디오 | 사용 불가, 텍스트 전용 |
| 임베딩 | 사용 불가 |
| 파인튜닝 | 사용 불가 |
| 다른 모델 ID | 사용 불가, 단일 모델만 존재 |
컨텍스트 창은 프롬프트와 완성을 합쳐 100,000 토큰입니다. 요청 본문 크기는 8 MB를 초과할 수 없습니다. 검색 라이브러리 내 임베딩 호출과 같이 위의 두 엔드포인트 이외의 엔드포인트에 의존하는 클라이언트 코드는 해당 호출에서 실패하므로 해당 부분을 다른 서비스와 함께 유지하도록 계획하십시오.
5분 이내에 연결
가장 빠른 방법은 환경 변수를 사용하는 것입니다. OpenAI Python 및 Node SDK는 코드에서 전달하지 않을 때 OPENAI_API_KEY 및 OPENAI_BASE_URL을 읽으므로 기존 스크립트 수정 없이 작동합니다.
export OPENAI_API_KEY="YOUR_KEY"
export OPENAI_BASE_URL="https://api.openaiapiproxy.com/v1"
curl "$OPENAI_BASE_URL/chat/completions" \
-H "Authorization: Bearer $OPENAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"Reply with the word ready."}]}'다른 제공업체와 통신하는 코드베이스에서 더 안전한 명시적 구성을 선호한다면 값을 클라이언트에 전달하십시오:
from openai import OpenAI
client = OpenAI(base_url="https://api.openaiapiproxy.com/v1", api_key="YOUR_KEY")
for model in client.models.list():
print(model.id)
out = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Summarize the plot of a heist film in two sentences."}],
)
print(out.choices[0].message.content)먼저 키가 필요합니다. 새 계정은 API 키 페이지에서 한 번의 클릭으로 $0.50의 체험 크레딧을 청구할 수 있습니다. 유효 기간은 7일이며 카드가 필요하지 않습니다. Claude Code에서 작업하는 경우 사이트에는 Claude Code와 함께 사용하는 방법에 대한 별도 페이지가 있습니다.
요청 헤더도 중요합니다. 항상 Content-Type: application/json을 보내고 본문 크기를 8 MB 이하로 유지하십시오. 긴 채팅 기록과 함께 매우 큰 문서를 붙여넣으면 100,000 토큰 제한에 도달하기 전에 8 MB 제한에 도달할 수 있으므로 큰 텍스트를 업로드할 때 본문 크기를 확인하십시오.
프록시를 신뢰하기 전 5분 테스트
선택한 엔드포인트에 관계없이 동일한 검증을 수행하십시오. 이 작업은 몇 분 정도 걸리며, 사용자가 문제를 겪기 전에 대부분의 예상치 못한 상황을 감지할 수 있습니다.
- 모델 목록을 나열하십시오.
GET /v1/models호출은 키와 주소가 모두 확인됩니다. 여기에서uncensored를 확인해야 합니다. - 짧은 완성 요청 보내기. 한 단어를 요청하고
max_tokens을 제한하십시오. 응답 헤더, 특히X-Balance-USD를 확인하고 잔액이 합리적인 금액만큼 감소했는지 확인하십시오. - 긴 답변 스트리밍. 토큰이 점진적으로 도착하고 스트림이 끝에 사용량과 함께 깔끔하게 종료되는지 확인하십시오.
- 도구 호출 테스트. 함수 스키마 하나를 보내고
tool_calls이 반환되는지 확인한 후role: "tool"메시지를 반환하고 최종 답변을 읽으십시오. - 의도적으로 발생시킵니다. 전체 키로 동시에 아홉 개의 요청을 보내거나, 체험 키로 세 개의 요청을 보내고, 상태
concurrency로 429를 받으며, 재시도 상태가 복구되는지 확인합니다.
모든 테스트가 통과하면 프로토콜 수준에서 통합이 안정적입니다. 남은 작업은 모델 자체를 평가하는 것이며, 이는 오직 사용자 자신의 프롬프트로만 가능합니다.
일반적인 문제 해결
호환성 문제는 모델보다는 거의 항상 구성 문제입니다. 가장 자주 발생하는 문제들은 다음과 같습니다.
모든 호출에서 찾을 수 없음 오류
기본 URL이 이미 /v1로 끝나고 클라이언트가 /v1을 다시 추가하거나 그 반대입니다. 클라이언트 로그의 최종 URL을 확인하십시오. 올바른 요청 경로는 https://api.openaiapiproxy.com/v1/chat/completions입니다.
인증 오류
키가 누락되었거나, 불필요한 공백이나 개행이 포함되어 있거나, 잘못된 헤더로 전송되었습니다. 형식은 Authorization: Bearer <key>입니다. 터미널에서 복사한 키에는 후행 개행이 포함될 수 있습니다.
모델 이름이 거부됩니다
소문자로 uncensored를 사용하십시오. 벤더 모델 ID와 같은 이름은 일치하지 않습니다. 여기에는 단일 모델만 있기 때문입니다. 일부 도구는 하드코딩된 드롭다운을 유지하므로 이 경우 사용자 정의 모델 이름을 추가하십시오.
HTTP 429
오류 코드는 초과한 제한을 나타냅니다. rate_limited은 분당 요청 수를 초과했음을 의미합니다(전체 키는 300, 체험 키는 60). concurrency은 동시에 너무 많은 요청이 발생했음을 의미합니다(전체 키는 8, 체험 키는 2). 일시적인 과부하도 429와 Retry-After: 5를 반환합니다. 명시된 시간을 기다렸다가 다시 시도합니다. 스트리밍 요청은 스트림이 끝날 때까지 슬롯을 유지한다는 점을 기억하세요.
비용, 청구 및 개인정보 보호
가격은 선불 크레딧 기준 입력 토큰 1M당 $0.15, 출력 토큰 1M당 $0.50입니다. 구독 요금제는 없으며 크레딧은 만료되지 않습니다. 실패하거나 거부된 요청에는 요금이 부과되지 않습니다. 프롬프트는 학습에 사용되지 않습니다.
계산 예시: 지원용 도구에서 호출당 3,000개의 입력 토큰을 보내고 400개의 출력 토큰을 받습니다. 입력 비용은 3,000 / 1,000,000 x $0.15 = $0.00045이며, 출력 비용은 400 / 1,000,000 x $0.50 = $0.0002입니다. 따라서 한 번 호출 비용은 $0.00065이며, 10,000회 호출 비용은 $6.50입니다.
충전은 암호화폐(USDT on TRC20, USDC on Base)로 $20부터 $500까지의 정수 금액으로 가능합니다. $200 충전 시 15% 보너스가 포함되어 총 $230의 크레딧이 제공됩니다. 나머지 정보는 요금제 페이지에서 확인할 수 있습니다.
호환되는 엔드포인트 선택 시 확인 사항
이 카테고리는 경쟁이 치열하므로 명확한 기준이 필요합니다. 어떤 모델을 실행하는지 명시하지 않는 제공업체는 주의하세요. 이는 기대할 수 있는 동작과 그로 인해 책임을 져야 할 주체를 알려주기 때문입니다. 여기서는 독립적인 제공업체가 운영하는 오픈 웨이트 모델이며, 해당 페이지에서 이를 명확히 밝히고 있습니다.
- 공개된 제한. 재시도 로직을 설계하기 전에 요청 및 동시 요청 한도를 알아야 합니다. 전용 키 기준 분당 요청 수는 300회, 동시 요청 수는 8개입니다.
- 명확한 청구 규칙. 선불 크레딧, 구독 요금제 없음, 실패한 호출에 대한 명시적 안내를 확인하세요. 이 서비스에서는 실패하거나 거부된 요청에 요금이 부과되지 않으며 크레딧은 만료되지 않습니다.
- 개인정보 처리방침. 프롬프트는 여기서 학습용으로 사용되지 않습니다. 귀하에게 중요한 세부 사항을 위해 문서과 약관을 읽으세요.
- 정직한 범위. 누락된 항목을 짧게 나열하는 것은 좋은 신호입니다. 텍스트 전용, 임베딩 없음, 파인튜닝 없음, 단일 모델.
결제 수단도 중요한 요소입니다. 충전은 암호화폐(USDT on TRC20, USDC on Base)로 $20부터 $500까지 가능합니다.
사용 전 확인 사항
거부 없이 작동하는 모델은 가드레일이 적은 도구이므로 신중하게 사용해야 합니다. 서비스에는 하나의 하드 제한이 있으며, 미성년자가 관련된 성적인 콘텐츠는 일절 허용되지 않습니다. 귀하의 제품에는 사용자 및 현지 법률에 맞는 필터링을 추가해야 합니다. 전체 파라미터 목록은 문서에서 확인하고, 이 엔드포인트가 처리하지 않는 작업에 대해 두 번째 제공업체를 구성해 두세요.
