Qwen 사용자를 위한 빠른 시작
OpenAI 호환 API를 사용하여 무검열 Qwen 모델을 애플리케이션에 통합하세요. 이 가이드는 빠른 개발을 위한 설정, 기본 요청, 스트리밍 및 오류 처리를 다룹니다.
https://api.uncensoredqwen.com/v1 무검열 uncensored
전제 조건 및 인증
시작하려면 API 키가 필요합니다. API 키 발급 페이지를 방문하여 이메일과 비밀번호만으로 계정을 생성하세요. 시작 시 신용카드가 필요 없으며, 신규 계정에는 7일 동안 유효한 $0.50의 무료 체험 크레딧이 제공됩니다. API 키 페이지에서 한 번의 클릭으로 이 크레딧을 청구하세요. 가입 후 키가 즉시 표시됩니다.
모든 요청에는 Authorization: Bearer <your-api-key> 헤더가 포함되어야 합니다. 401 오류가 발생하면 키가 올바른지 확인하세요. 키를 재생성하면 이전 키가 즉시 무효화되지만, 속도 제한 카운터는 초기화되지 않습니다.
기본 채팅 완료
응답을 생성하기 위해 간단한 텍스트 프롬프트를 보내세요. 당사 API는 표준 OpenAI 페이로드 형식을 지원합니다. 모델 ID는 uncensored이며, 입력과 출력을 합쳐 100,000 토큰의 컨텍스트 창을 지원합니다.
- Base URL:
https://api.uncensoredqwen.com/v1 - 엔드포인트:
POST /v1/chat/completions
cURL을 사용한 기본 요청 예시입니다:
curl https://api.uncensoredqwen.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
}'
Python SDK 통합
공식 OpenAI Python 클라이언트를 사용하여 API에 연결하세요. 클라이언트를 Base URL에 연결하고 키를 제공하면 chat.completions.create과 같은 익숙한 메서드를 사용할 수 있습니다.
- 클라이언트 설치:
pip install openai base_url을https://api.uncensoredqwen.com/v1로 설정하세요
구현 예시:
from openai import OpenAI
client = OpenAI(base_url="https://api.uncensoredqwen.com/v1", api_key="YOUR_KEY")
resp = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)
Node.js SDK 사용법
JavaScript 환경에서는 openai npm 패키지를 사용하세요. Base URL과 API 키를 클라이언트에 구성하여 요청을 보낼 수 있습니다. 이 방법은 서버 측 및 브라우저 기반 애플리케이션 모두에서 작동합니다.
- 설치:
npm install openai baseUrl및apiKey구성
Node.js 샘플 코드:
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.uncensoredqwen.com/v1", apiKey: process.env.API_KEY });
const resp = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);
스트리밍 응답
스트리밍을 활성화하여 토큰을 실시간으로 받으세요. 요청에 stream: true을 설정하면 SSE 스트림을 받을 수 있습니다. 이는 긴 응답을 기다리는 사용자의 지각된 지연 시간을 줄여줍니다.
- 스트림을 청크 단위로 처리하세요
- 토큰을 연결하여 최종 응답을 구성하세요
스트리밍 예시:
stream = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Tell the story in second person."}],
stream=True,
)
for chunk in stream:
if chunk.choices and chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="", flush=True)
제한, 오류 및 컨텍스트
중단을 피하려면 사용량을 모니터링하세요. API는 키당 분당 300개의 요청 제한을 적용합니다. 이를 초과하면 429 오류가 발생합니다. 요청 본문은 8 MB 미만이어야 합니다.
일반적인 오류에는 다음이 포함됩니다:
- 401 Unauthorized: 유효하지 않거나 무효화된 API 키입니다.
- 402 결제 필요: 선불 크레딧 잔액이 부족합니다. $20부터 충전하세요.
- 429 Too Many Requests: 속도 제한을 초과했습니다.
키를 재생성하면 이전 키가 무효화되지만 속도 제한 카운터는 초기화되지 않습니다.
API 사양
크레딧을 구매하기 전에 확인할 수 있도록 API의 실제 한도와 기능을 한곳에 정리했습니다.
| 항목 | 내용 |
|---|---|
| 형식 | OpenAI 호환: 어떤 OpenAI SDK든 base URL과 키만 바꾸면 동작 |
| 모델 ID | uncensored |
| Base URL | https://api.uncensoredqwen.com/v1 |
| 엔드포인트 | POST /v1/chat/completions · GET /v1/models |
| 인증 | Authorization: Bearer YOUR_KEY |
| 최대 출력 | 100,000 토큰 윈도우의 남은 만큼; max_tokens는 선택 사항(별도 상한 없음) |
| 스트리밍 | 지원 — SSE, 마지막 청크에 토큰 사용량 포함 |
| 함수 호출 | 지원 — tools, tool_choice; 응답에 tool_calls (스트리밍 포함), 결과는 role: tool로 전송 |
| 파라미터 | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| JSON 모드 | response_format: {"type": "json_object"} |
| 컨텍스트 창 | 100,000 토큰 (입력 + 출력) |
| 요청 크기 | 최대 8 MB |
| 응답 헤더 | X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency |
| 속도 제한 | 키당 분당 300회 |
| 동시 요청 | 키당 동시 8개 |
| 유효기간 | 유료 크레딧은 만료되지 않으며 구독 없음 |
| 충전 | USDT (TRC20) 또는 USDC (Base), $20~$500 사이 원하는 정수 금액 |
| 과금 | 선불 크레딧에서 실제 사용량만큼 차감, 오류·거부는 무료 |
| 무료 체험 | $0.50, 7일, 카드 불필요 · 체험 키: 동시 요청 2건, 분당 60건. 첫 충전 후 전체 한도(8건, 300건) 적용 |
| 가격 | 입력 100만 토큰당 $0.15 · 출력 100만 토큰당 $0.50 |
| 보너스 | $50 이상 +5%, $100 이상 +10%, $200 이상 +15% |
| 로그인 | Google 또는 이메일과 비밀번호 |
| 키 | 계정당 활성 키 1개, 새 키를 만들면 이전 키는 무효 |
| 콘텐츠 | 성인 콘텐츠 허용, 미성년자가 관련된 성적 콘텐츠는 거부 |
오류 코드
오류는 고정된 type을 가진 JSON으로 반환되며, 실패하거나 거부된 요청은 과금되지 않습니다.
| 코드 | 유형 | 의미 |
|---|---|---|
400 | bad_request | 잘못된 JSON, 빈 메시지, 잘못된 파라미터 또는 컨텍스트 초과 |
401 | missing_key · invalid_key · key_revoked | 키 없음·잘못됨·새 키로 교체됨 |
402 | no_credit | 잔액 없음 — 충전하면 즉시 재개 |
403 | content_blocked | 미성년자 관련 성적 콘텐츠 — 거부, 과금 없음 |
404 | not_found | 알 수 없는 엔드포인트 |
413 | request_too_large | 본문 8 MB 초과 |
429 | rate_limited · concurrency | 분당 300회 또는 동시 8개 초과 — 잠시 후 재시도 |
503 | upstream_busy | 모델 혼잡 — 몇 초 후 재시도 |
질문과 답변
컨텍스트 창 크기는 얼마인가요?
이 모델은 프롬프트와 응답을 모두 포함하여 100,000개의 토큰을 처리할 수 있는 컨텍스트 창을 지원합니다. 이를 통해 단일 요청 내에서 대량의 입력과 출력이 가능합니다.
API 키를 재생성하면 속도 제한이 초기화되나요?
아니요. 키를 재생성하면 이전 키가 즉시 무효화되지만, 속도 제한 카운터는 이전 상태에서 계속됩니다. 카운터가 새로 시작하지 않습니다.
콘텐츠 제한이 있나요?
모델은 성인, 픽션, 논쟁적 주제에 대해 무검열입니다. 하지만 미성년자가 포함된 성적인 콘텐츠 요청은 항상 차단됩니다.
키는 양식 하나만 작성하면 받을 수 있습니다
계정을 생성하고 키를 복사한 후 Base URL을 변경하세요. 설정은 이것으로 끝입니다.
API 키 받기