The OpenRouter API 설명됨

OpenAI 호환 API란 무엇인가요?

OpenAI chat-completions 인터페이스를 따르는 REST API입니다. 표준 JSON 페이로드를 사용하여 프롬프트를 전송하고 텍스트 출력을 받습니다. 이 호환성으로 인해 기존 클라이언트 코드를 크게 변경하지 않고도 작동합니다.

주요 엔드포인트는 POST /v1/chat/completions입니다. 역할과 내용을 객체로 하는 배열인 messages를 받습니다. GET /v1/models를 통해 사용 가능한 모델을 나열할 수도 있습니다. 이러한 표준화는 통합 시간을 크게 줄여줍니다.

당사 서비스는 정확히 이 인터페이스를 제공합니다. "uncensored" ID로 하나의 uncensored 모델을 제공합니다. 이 모델은 당사 자체 서버에서 실행됩니다. 다른 벤더로 라우팅하지 않습니다. 필요한 모델에 직접 접근할 수 있습니다.

컨텍스트 윈도우는 총 100,000개의 토큰까지 지원합니다. 출력 제한은 요청당 16,000개의 토큰입니다. Server-Sent Events를 통해 스트리밍이 가능합니다. 함수 호출 및 JSON 모드가 완전히 지원됩니다.

Base URL 및 API 키 이해하기

기본 URL은 요청을 처리하는 서버를 가리킵니다. 기본 OpenAI URL을 당사 특정 엔드포인트로 대체합니다. 당사 기본 URL은 HTTPS://api.openrouterabliterated.com/v1입니다. 이 변경은 트래픽을 당사 uncensored 인프라로 유도합니다.

API 키는 요청을 인증합니다. 계정당 하나의 키를 생성합니다. 키는 가입 직후 표시됩니다. 필요한 경우 교체할 수 있습니다. 각 계정은 동시에 하나의 활성 키를 보유합니다.

Rate limits는 키별로 적용됩니다. 분당 300회 요청을 보낼 수 있으며, 최대 8개의 요청을 동시에 실행할 수 있습니다. 요청 본문 크기는 8MB로 제한됩니다. 이러한 한도는 대용량 사용에도 잘 대응합니다.

가입에는 이메일 또는 Google 계정만 필요합니다. 전화번호가 필요하지 않습니다. 키가 즉시 표시됩니다. 즉시 요청을 시작할 수 있습니다. 프라이버시가 유지되며 프롬프트는 학습에 사용되지 않습니다.

사용 사례에 비제약 모델을 선택해야 하는 이유?

Uncensored 모델은 합법적인 성인, 픽션, 또는 논쟁적인 주제를 거절하지 않습니다. 이들은 창작 글쓰기, 역할극 또는 연구에 이상적입니다. 주류 모델은 종종 엄격한 가드레일을 적용합니다. 이는 생성 흐름을 방해할 수 있습니다.

당사의 모델은 직접적으로 답변하도록 튜닝되었습니다. 푸시백 없이 NSFW 콘텐츠를 처리합니다. 정치 철학이나 틈새 장르에 잘 작동합니다. 추가 프롬프팅 없이 일관된 동작을 얻습니다.

툴 사용이 지원됩니다. 애플리케이션을 위한 툴을 정의할 수 있습니다. 모델은 툴 선택을 존중합니다. 이는 복잡한 워크플로우에 적합합니다. 오류와 거절이 무료입니다. 실제 사용량에 대해서만 요금이 부과됩니다.

콘텐츠 제한이 여전히 적용됩니다. 미성년자가 관련된 성적인 콘텐츠는 항상 거부됩니다. 이는 하드 제한입니다. 기본 안전 기준을 보장합니다. 그 외의 모든 것은 귀하의 사용 사례에 적합합니다.

토큰 가격: 비용 계산 방법

가격은 토큰 사용량을 기준으로 책정됩니다. 입력 토큰은 100만 개당 $0.15입니다. 출력 토큰은 100만 개당 $0.50입니다. 사용한 만큼만 지불합니다. 숨겨진 요금이 없습니다.

크레딧은 선불입니다. 암호화폐로만 충전합니다. TRC20의 USDT 또는 Base의 USDC가 허용됩니다. $20에서 $500 사이의 모든 정수 금액이 허용됩니다. 크레딧은 만료되지 않습니다. 이는 구독 잠금을 피합니다.

충전 시 보너스 크레딧을 받을 수 있습니다. $50부터 +5%, $100부터 +10%, $200부터 +15%를 받습니다. 이는 유효 비용을 낮춥니다. 오류는 무료입니다. 거절도 무료입니다. 성공한 토큰에만 비용을 지불합니다.

트라이얼 계정에는 $0.50가 제공됩니다. 유효 기간은 7일입니다. 이를 통해 API를 철저히 테스트할 수 있습니다. 자금 투입 전에 통합을 확인할 수 있습니다.

스트리밍 vs 비스트리밍 응답

스트리밍은 생성되는 대로 토큰을 전송합니다. 이는 지각된 지연 시간을 줄입니다. 사용자는 텍스트가 실시간으로 나타나는 것을 볼 수 있습니다. 이는 채팅 인터페이스에 필수적입니다. 비스트리밍은 전체 응답이 준비될 때까지 기다립니다. 이는 긴 출력의 경우 느리게 느껴질 수 있습니다.

SSE 스트리밍을 지원합니다. 마지막 청크에는 토큰 사용량이 포함됩니다. 이를 통해 정확한 청구 추적이 가능합니다. 부분 응답을 우아하게 처리할 수 있습니다. 오류가 일관되게 처리됩니다.

비스트리밍은 구현이 더 단순합니다. 요청을 보내고 전체 응답을 기다립니다. 이는 백그라운드 작업이나 전체 출력이 처리 전에 필요할 때 적합합니다. 부분 응답 처리의 복잡성을 줄입니다.

함수 호출은 스트리밍할 수 있습니다. 도구는 식별되는 즉시 실행됩니다. 이는 상호작용성을 향상시킵니다. 입력을 조기에 처리할 수 있습니다. API가 복잡함을 처리해 줍니다.

함수 호출 및 구조화된 출력

함수 호출은 모델이 도구를 호출하게 합니다. 요청에 도구 스키마를 정의합니다. 모델이 함수 호출을 반환합니다. 귀하의 코드가 이를 실행합니다. 이를 통해 복잡한 워크플로우를 가능하게 합니다. 에이전트나 어시스턴트를 구축할 수 있습니다.

JSON 모드는 구조화된 출력을 강제합니다. 모델은 유효한 JSON을 반환합니다. 이는 데이터 추출에 유용합니다. 일관된 형식을 얻습니다. 파싱이 쉬워집니다. 오류가 거의 없습니다.

온도 및 top_p 같은 매개변수는 동작을 제어합니다. 종료 시퀀드는 출력을 제한합니다. 시드는 재현성을 보장합니다. 패널티는 반복을 줄입니다. 세밀한 제어가 가능합니다.

툴 선택은 자동 또는 강제일 수 있습니다. 모델의 선호도를 지정합니다. 이는 생성 과정을 안내합니다. 신뢰성을 향상시킵니다. 애플리케이션이 견고하게 유지됩니다.

일반적인 클라이언트 라이브러리 및 SDK

대부분의 SDK는 약간의 변경으로 작동합니다. base URL만 업데이트하면 됩니다. 나머지 코드는 동일하게 유지됩니다. 이는 Python, Node.js 및 기타 언어에 적용되며 통합이 매우 간단합니다.

OpenAI SDK는 표준입니다. 인증과 재시도를 처리합니다. API 키를 전달합니다. 베이스 URL은 당사 서비스를 가리킵니다. 요청은 정상적으로 전송됩니다.

스트리밍은 모든 SDK에서 지원됩니다. 청크를 반복하여 처리합니다. 토큰 사용량은 마지막 청크에서 사용할 수 있습니다. 이는 당사 과금 모델과 일치합니다. 오류는 일관되게 포착됩니다.

함수 호출은 현대적인 SDK에 내장되어 있습니다. 도구 정의를 전달하면 SDK가 응답을 구문 분석합니다. 코드가 도구를 실행합니다. 루프는 완료될 때까지 계속됩니다. 이는 효율적이고 신뢰할 수 있습니다.

일반적인 API 오류トラブルシュー팅

Rate limits는 429 오류를 반환합니다. 분당 300개의 요청을 보낼 수 있습니다. 이를 초과하면 기다려야 합니다. 지수 백오프를 구현하여 서버에 과부하가 걸리는 것을 방지하세요.

잘못된 키는 401 오류를 반환합니다. API 키를 확인하세요. 활성화 상태인지 확인하고 필요시 교체하세요. 각 계정에는 하나의 키가 있습니다. 분실한 경우 새 키를 생성하세요.

JSON 모드에서 오류가 발생합니다. 스키마가 유효한지 확인하세요. 모델은 유효한 JSON을 반환해야 합니다. 실패할 경우 재시도하세요. 안정성을 높이기 위해 온도를 조정하세요.

타임아웃은 긴 생성 과정에서 발생할 수 있습니다. 타임아웃 값을 늘리세요. 스트리밍은 타임아웃 위험을 줄입니다. 부분 응답이 처리되며 전체 출력을 복원할 수 있습니다.

다음 단계: 첫 번째 API 키 받기

가입 페이지를 방문하세요. Google 또는 이메일 사용. 전화번호가 필요하지 않습니다. 과정이 빠릅니다. 즉시 액세스할 수 있습니다.

API 키가 표시됩니다. 안전하게 복사한 후 SDK에 사용하세요. 베이스 URL을 당사 엔드포인트로 설정한 후 요청을 보내기 시작하세요.

암호화폐로 충전하세요. 큰 금액일수록 보너스 크레딧을 받습니다. 크레딧은 만료되지 않습니다. 자신의 속도에 따라 사용하세요.

시험 크레딧으로 테스트하세요. 7일 동안 유효합니다. 스트리밍과 함수 호출을 확인하세요. 모델의 기능을 탐색하세요. 앱에 통합하세요. API는 프로덕션 준비가 되었습니다.