Uncensored API 자주 묻는 질문

기본 사항

Uncensored API을 한 문장으로 설명하면?

id가 uncensored인 단일 모델을 제공하며, 법적인 성인 콘텐츠, 소설 또는 논쟁적인 주제를 거절하지 않는 유료 텍스트 전용 채팅 엔드포인트입니다.

어떤 URL을 호출하나요?

베이스 URL로 https://api.uncensoredapis.com/v1를 사용하세요. 채팅 요청은 POST /v1/chat/completions으로 보내며, 모델 목록은 GET /v1/models에서 확인할 수 있습니다. 다른 모든 경로는 404를 반환합니다.

새로운 SDK를 배워야 하나요?

아닙니다. 요청 및 응답 구조는 일반적인 채팅 완료 관례를 따르므로 기본 URL과 키만 변경하면 공식 Python 및 Node 패키지가 작동합니다. plain curl도 문서에 표시된 대로 작동합니다.

결제 전에 사용해 볼 방법이 있나요?

네. 신규 계정에는 7일 동안 유효한 $0.50 체험 크레딧이 제공되며, 로그인 시 결제 정보를 요청하지 않습니다. 키 페이지에서 이메일과 비밀번호로 등록하면 키가 즉시 표시됩니다.

여러 모델 중에서 선택할 수 있나요?

아니요. 정확히 하나의 모델만 있으며, 그 id는 uncensored입니다. 모델 경로에 대한 호출은 해당 단일 항목만 반환하므로 선택하거나 전환할 항목이 없습니다.

이 서비스는 누구를 위한 것인가요?

소설 도구, 역할극 앱 및 연구 보조 프로그램을 위한 제품을 구축하는 개발자입니다. 출시하는 제품에 대해 자체 연령 확인 및 콘텐츠 규칙을 책임집니다.

키 및 접근

계정에 몇 개의 키가 제공되나요?

하나입니다. 새 값을 얻으려면 계정에서 다시 생성하십시오. 이전 키는 즉시 사용 중지되므로 대체 키를 즉시 배포하십시오.

키는 어디에 보관해야 하나요?

자신이 제어하는 서버의 환경 변수 또는 비밀 관리자 내에 보관하세요. 브라우저 JavaScript 및 모바일 바이너리는 검사될 수 있으므로, 클라이언트 트래픽을 키를 직접 임베드하는 대신 자체 백엔드를 통해 라우팅하세요.

키는 어떻게 전송되나요?

모든 요청에 Authorization: Bearer 헤더로 전송됩니다. 누락되거나 잘못된 값은 401 오류와 함께 JSON 오류 객체를 반환합니다.

팀을 위한 무검열 API 키가 필요합니다. 하나를 공유할 수 있나요?

가능하지만, 모든 프로세스는 동일한 분당 300개 요청 허용량과 동일한 잔액을 공유합니다. 키 앞에 작은 게이트웨이를 두고 각 팀원에게 키 대신 게이트웨이 접근 권한을 부여하세요.

제한 및 가격

프롬프트는 얼마나 클 수 있나요?

컨텍스트 창은 프롬프트와 완성을 합쳐 100,000 토큰입니다. 단일 요청의 본문은 8 MB를 초과할 수 없습니다. 프롬프트와 max_tokens의 합계가 창을 초과하는 요청은 400 오류로 거부됩니다.

대답은 얼마나 길 수 있나요?

기본값은 2048 토큰입니다. 요청당 최대 32,000까지 max_tokens을 높일 수 있습니다. 제한으로 인해 응답이 중단되면 finish_reason은 length로 읽힙니다.

비용은 얼마인가요?

입력 토큰은 토큰 백만 개당 $0.25, 출력 토큰은 토큰 백만 개당 $1.00입니다. 잔액은 선불이며 구독이 없으며 잔액은 만료되지 않습니다. 표는 가격 페이지를 참조하세요.

간단한 견적을 줄 수 있나요?

예를 들어 프롬프트 토큰 1,500개와 생성 토큰 300개로 구성된 채팅 턴을 가정해 보겠습니다. 이는 입력 $0.000375와 출력 $0.0003, 즉 턴당 약 $0.000675이며, $1로 약 1,480개의 해당 턴을 구매할 수 있습니다.

요청을 너무 많이 보내면 어떻게 되나요?

각 키는 분당 300개의 요청을 보낼 수 있습니다. 이를 초과하면 429 상태 코드가 반환되며, 적절한 대응은 속도를 줄이고 지연 후 재시도하는 것입니다.

통합 질문

설정할 수 있는 샘플링 매개변수는 무엇인가요?

temperature, top_p, stop 등의 표준 파라미터는 생성 과정에 그대로 전달됩니다. 요청 본문에서 다른 곳과 동일하게 설정하세요.

API가 이전 대화 내용을 기억합니까?

아니요. 각 요청은 독립적이므로 매번 messages에 대화 내용을 다시 전송해야 합니다. 총 토큰 수가 100,000 컨텍스트 창 한도에 가까워지면 가장 오래된 턴을 제거하십시오.

브라우저로 토큰을 스트리밍할 수 있습니까?

예, stream: true를 보내고 서버 전송 이벤트를 읽으십시오. 백엔드에서 수행하고 텍스트를 페이지로 중계하면 키가 클라이언트에 도달하지 않습니다.

시스템 메시지를 지원합니까?

네. 대화의 어조, 형식 및 범위를 설정하려면 배열의 첫 번째 요소에 system 역할을 가진 메시지를 배치하세요.

출력이 잘려 보일 때 가장 먼저 확인할 것은 무엇입니까?

finish_reason을 확인하세요. 값이 length이면 한도에 도달했다는 의미이므로 max_tokens을 늘리거나 프롬프트를 줄이세요. 모든 값의 목록은 reference을 참조하세요.

잔액 및 청구

자금을 어떻게 추가합니까?

계정에서 선불 잔액을 충전하세요. 구독할 것이 없으며, 사용하지 않은 잔액은 만료되지 않으므로 계속 사용 가능합니다.

무료 체험 크레딧이 소진되면 어떻게 됩니까?

무료 체험 크레딧은 7일 동안 유효합니다. 크레딧이 소진되거나 만료되면 잔액을 충전할 때까지 요청 시 402 상태 코드와 함께 no_credit 코드가 반환됩니다.

요청 비용을 확인할 수 있습니까?

각 응답에는 프롬프트, 생성 및 총 토큰을 포함하는 usage 블록이 포함됩니다. 백만 토큰당 비율을 곱하여 청구 금액을 계산하고, 거래 내역 장부를 유지하려면 자체 기록을 유지하십시오.

실패한 요청은 재시도 시 무료입니까?

재시도는 가능하지만 제한을 두어야 합니다. 429 및 503에는 짧은 백오프를 사용하고, 400, 401, 402, 403에서는 무한 루프를 피하세요. 이러한 오류는 자체적으로 해결되지 않습니다. errors playbook에 준비된 정책이 있습니다.

콘텐츠 및 동작

모델이 수행하지 않을 작업은 무엇입니까?

합법적인 성인 콘텐츠, 소설 또는 논쟁적인 주제는 거부되지 않습니다. 단, 미성년자가 포함된 성적인 콘텐츠는 스토리나 역할극을 포함해 항상 403 오류로 차단됩니다. 이 서비스는 18세 이상 성인을 위한 것입니다.

프롬프트가 모델 학습에 사용됩니까?

아니요. 프롬프트는 학습에 사용되지 않습니다.

에그리게이터를 통해 라우팅하는 것과 어떻게 다른가요?

에그리게이터는 여러 모델로 요청을 전달하며 각 모델마다 고유한 규칙이 있습니다. 이 서비스는 하나의 정책 아래 하나의 모델을 제공합니다. uncensored OpenRouter guide에서 이 비교를 자세히 살펴볼 수 있습니다.

이미지를 보거나 임베딩을 생성할 수 있습니까?

아니요. 텍스트만 처리하며 임베딩, 이미지, 오디오, 비디오, 파인튜닝은 지원하지 않습니다.

문제 해결

402 오류와 함께 no_credit이 반환됩니다. 어떻게 해야 합니까?

잔액이 고갈되었거나 무료 체험 기간이 만료되었습니다. 선불 잔액을 충전한 후 요청을 다시 보내세요.

요청이 upstream_busy 503 오류를 반환합니다.

일시적인 현상입니다. 잠시 기다렸다가 재시도하세요. 여러 워커를 실행 중이라면 점증하는 지연 시간과 약간의 무작위성을 사용하세요.

스트리밍이 종료되었고 토큰 수를 찾을 수 없습니다.

스트리밍이 활성화되면 data: [DONE] 직전에 usage를 포함하는 마지막 청크가 자동으로 추가됩니다. 이 청크의 choices 목록은 비어 있으므로 인덱싱 전에 이를 확인하세요.

도구 및 함수 호출이 작동합니까?

네. 표준 형식을 따릅니다: tools 배열을 전달하고 응답에서 tool_calls을 확인하세요.