무검열 API FAQ: 가입, 요금제, 엔드포인트, 오류 코드 및 콘텐츠 한계

가입 및 무료 체험

회원가입 방법은 무엇이며, 은행 카드 바인딩이 필요한가요?

/get-api-key/ 페이지에서 이메일과 비밀번호로 회원가입하면 됩니다. 카드 바인딩이 필요하지 않습니다. 회원가입이 완료되면 키가 즉시 화면에 표시되며, 심사 대기 기간이 없습니다.

신규 계정의 무료 체험 크레딧은 얼마나 제공되며, 얼마나 사용할 수 있나요?

신규 계정에는 $0.50의 무료 체험 크레딧이 제공되며, 7일 동안 유효합니다. 출력 기준 $1.00 / 백만 토큰으로 계산 시 약 50만 토큰의 응답 생성이 가능하며, 통합 테스트 및 소규모 검증에 충분합니다.

계정당 생성할 수 있는 키의 개수는 얼마이며, 키를 분실한 경우 어떻게 해야 하나요?

계정당 키는 하나만 생성할 수 있습니다. 키가 유출되거나 분실된 경우 계정에서 키를 재생성할 수 있으며, 기존 키는 즉시 무효화됩니다. 기존 키를 사용하는 모든 서비스에서는 401 오류가 반환되므로, 키 변경 후 환경 변수를 함께 업데이트해야 합니다.

무료 체험 크레딧이 만료되면 어떻게 되나요?

체험 크레딧이 만료된 후 요청을 보내면 402 오류가 반환되며, 오류 코드는 no_credit입니다. 계속 사용하려면 계정에 선불 잔액을 충전하면 되며, 코드 변경은 필요하지 않습니다.

요금제 및 잔액

가격은 얼마이며, 어떻게 과금되나요?

토큰 기반 과금: 입력 $0.25 / 백만 토큰, 출력 $1.00 / 백만 토큰. 구독료나 월 요금이 없으며, 사용한 만큼만 차감됩니다. 전체 요금 정보는 가격 페이지를 참조하세요.

잔액은 만료되나요?

만료되지 않습니다. 충전한 선불 크레딧에는 유효 기간이 없으며, 신규 계정에게 제공된 $0.50 무료 체험 크레딧에만 7일 제한이 적용됩니다.

요청당 비용은 어떻게 확인하나요?

각 응답의 usage 필드에 입력 및 출력 토큰 수가 제공되며, 단가를 곱하면 비용이 계산됩니다. 스트리밍 요청의 마지막 데이터 블록에도 usage가 포함되므로, 읽을 때 이 블록의 choices가 빈 배열임을 주의하세요.

예상치 못한 고액 요금이 발생하는 것을 어떻게 방지하나요?

주요 방법은 두 가지입니다. 먼저 max_tokens를 사용하여 단일 응답의 길이를 제한합니다. 기본값은 2048입니다. 다중 턴 대화 시에는 대화 기록을 잘라내어 입력이 계속 늘어나지 않도록 합니다. 선불 방식이므로 잔액이 소진되면 요청이 중단되어 잔액을 초과하는 요금이 발생하지 않습니다.

일반적인 요청의 비용은 얼마나 되나요?

입력 2,000 토큰, 출력 500 토큰인 경우를 가정하면: 입력 비용은 약 $0.0005, 출력 비용은 약 $0.0005로, 합계는 약 $0.001입니다. 즉, 이러한 요청을 1,000회 수행하는 데 약 $1이 소요됩니다. 실제 비용은 응답의 usage 필드를 기준으로 합니다.

잔액이 고갈되면 어떻게 되나요?

엔드포인트에서 402 오류가 반환되며, 오류 코드는 no_credit입니다. 충전하면 API 키를 재생성하지 않고도 계속 사용할 수 있습니다.

엔드포인트 및 파라미터

엔드포인트 주소와 모델명은 무엇인가요?

Base URL은 https://api.wuxianzhiapi.com/v1이며, 모델명은 고정적으로 uncensored로 작성합니다. 사용 가능한 엔드포인트는 POST /v1/chat/completions 및 GET /v1/models입니다.

OpenAI 호환 SDK를 지원하나요?

호환됩니다. 공식 Python의 openai v1 이상과 npm의 openai v4 이상은 Base URL과 API 키만 수정하면 사용할 수 있습니다. 구체적인 코드 작성 방법은 코드 예제를 참조하세요. 다른 엔드포인트에서 마이그레이션하는 방법은 마이그레이션 가이드를 참조하세요.

컨텍스트 창 길이는 얼마이며, max_tokens은 최대 얼마까지 설정할 수 있나요?

컨텍스트 창은 100,000 토큰이며, 프롬프트와 출력의 합계가 이 값을 초과할 수 없습니다. max_tokens의 기본값은 2048이며, 최대 32,000까지 설정 가능합니다. 요청 본문 크기는 8 MB를 초과할 수 없습니다.

스트리밍 출력과 함수 호출을 지원하나요?

모두 지원됩니다. 스트리밍은 stream: true을 사용하며, 서버는 마지막에 usage가 포함된 데이터 블록을 자동으로 추가합니다. 함수 호출은 OpenAI 형식의 tools 및 tool_choice를 사용하며, 도구 결과는 role: "tool" 메시지 형태로 반환됩니다.

스트리밍 응답의 마지막 블록에 텍스트가 없는 이유는 무엇입니까?

이는 자동으로 추가되는 사용량 통계 블록입니다. choices는 빈 배열이며, usage에는 이번 요청의 토큰 수가 포함됩니다. 파싱 시 choices가 비어 있는지 먼저 확인한 후 내용을 추출하면 인덱스 범위 초과 오류가 발생하지 않습니다.

속도 제한이 있나요?

키당 분당 300회 요청이 허용됩니다. 제한을 초과하면 429 상태 코드가 반환되며, 잠시 후 재시도하면 됩니다. 지수 백오프(exponential backoff)를 사용하는 것을 권장합니다.

벡터, 이미지, 음성 또는 파인튜닝을 지원하나요?

모두 지원하지 않습니다. 텍스트 대화만 제공하며, uncensored 모델 하나만 있습니다. 임베딩(embeddings)은 제공하지 않으며, 이미지, 오디오, 비디오 생성 및 파인튜닝도 지원하지 않습니다.

오류 코드

모든 오류 응답은 {"error":{"code":...,"message":...}} 형식의 JSON입니다. 아래에서 상태 코드별로 처리 방법을 하나씩 설명합니다.

400 오류는 무엇인가요?

요청 자체에 문제가 있습니다. 가장 흔한 경우는 프롬프트와 max_tokens의 합계가 100,000 토큰을 초과하거나, JSON 형식이 잘못되었거나 필드 타입이 오류인 경우입니다. 요청을 수정해야 하며, 재시도만으로는 해결되지 않습니다.

401 오류는 어떻게 조사하나요?

키가 유효하지 않거나 누락되었습니다. 요청 헤더가 Authorization: Bearer <키>인지 확인하고, 환경 변수가 적용되었는지, 키가 재생성되지 않았는지 확인하세요. 키가 재생성되면 기존 키는 즉시 무효화됩니다.

402 no_credit는 무엇을 의미하나요?

잔액이 소진되었거나 무료 체험 크레딧이 만료되었습니다. 계정에 충전하면 복구되며, 키를 변경할 필요가 없습니다.

403 content_blocked는 무엇을 의미하나요?

요청이 콘텐츠 필터링을 트리거했습니다. 미성년자 관련 성 콘텐츠는 항상 필터링되며, 이는 조정 불가능합니다. 요청 내용을 수정한 후 다시 시도하세요. 원본 요청을 그대로 재전송해도 결과는 동일합니다.

404 오류는 무엇인가요?

존재하지 않는 엔드포인트에 접근했습니다. 흔한 원인은 URL을 잘못 입력한 경우입니다. 예를 들어 /v1를 누락했거나, embeddings이나 이미지 생성과 같이 지원하지 않는 엔드포인트를 호출한 경우입니다.

429와 503은 어떻게 처리하나요?

429는 분당 300회의 속도 제한을 초과했음을 의미합니다. 503 오류 코드는 upstream_busy이며, 이는 모델이 일시적으로 바쁘다는 것을 의미합니다. 몇 초 후 다시 시도하세요. 두 경우 모두 지수 백오프 방식으로 재시도하는 것이 적합하며, 예제는 코드 예제 페이지를 참조하세요.

콘텐츠 경계

"무검열"이면 모든 것을 생성할 수 있나요?

아닙니다. 합법적인 성인 콘텐츠, 픽션 및 논쟁적인 주제는 거부되지 않지만, 미성년자 관련 성 콘텐츠는 항상 필터링되어 403이 반환됩니다. 이는 픽션 여부나 역할극 여부와 무관합니다. 사용은 합법적이어야 합니다.

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

18세 이상 성인 사용자에게만 제공됩니다. 최종 사용자를 대상으로 하는 제품에 이 API를 사용하는 경우, 자체 애플리케이션에서 성인 확인을 수행하고 신고 및 계정 관리 메커니즘을 유지해야 합니다.

역할극, 소설, 게임에 사용할 수 있나요?

가능합니다. 이는 가장 일반적인 사용 사례입니다. 각 시나리오의 프롬프트 예제 및 비용 추계는 응용 시나리오 문서를 참조하세요.

역할극에서 어떤 경우에 403이 반환되나요?

콘텐츠 필터링이 트리거될 때만 반환됩니다. 대표적인 경우가 미성년자 관련 성 콘텐츠(픽션 설정 포함)입니다. 성인 간의 합법적인 콘텐츠는 역할극이라는 이유로 거부되지 않습니다. 403이 발생하면 캐릭터 설정이나 플롯을 조정한 후 요청하세요.

모델 출력의 사실 관계가 항상 신뢰할 수 있나요?

반드시 그렇지는 않습니다. 응답을 거부하지 않는다고 해서 콘텐츠가 정확함을 의미하지는 않습니다. 사실, 데이터, 법률 또는 의료 관련 결론의 경우, 직접 확인한 후에 사용해야 합니다.

개인정보

내 프롬프트가 모델 학습에 사용되나요?

아닙니다. 전송한 프롬프트는 학습에 사용되지 않습니다.

키는 어떻게 보관해야 하나요?

키는 서버의 환경 변수에 보관하고, 프론트엔드 페이지, 모바일 앱 패키징 파일 또는 공개 코드 저장소에는 포함하지 마세요. 유출이 의심되면 계정에서 즉시 재생성하세요. 이전 키는 즉시 무효화됩니다.

애플리케이션의 사용자 데이터는 어떻게 처리해야 하나요?

이 부분은 귀하의 제품에 따라 다릅니다. 작업 수행에 필요한 내용만 전송하는 것을 권장하며, 사용자의 실명, 신분증 번호, 연락처 등 민감한 정보를 프롬프트에 포함하지 마세요. 데이터 흐름에 대해서는 자체 개인정보 처리방침에 명확히 명시해야 합니다.