빠른 시작: 클라이언트 연결
다음으로 요청을 보내세요 https://api.isgeminiuncensored.com/v1 표준 OpenAI SDK 사용. 당사 서비스는 다른 제공업체의 드롭인 대체재 역할을 하므로 베이스 URL만 업데이트하고 API 키를 제공하면 됩니다. 대시보드에서 Google 또는 이메일을 사용하여 키를 즉시 생성할 수 있습니다. 이 설정은 복잡한 프록시 설정이나 사용자 정의 재우기 프롬프트가 필요하지 않습니다.
인증은 계정당 하나의 활성 API 키에 기반합니다. 새 키를 생성하면 이전 키가 즉시 무효화됩니다. 이는 사용량에 대한 엄격한 제어와 데이터 프라이버시를 유지합니다. 프롬프트는 학습에 사용되지 않으므로 창작물은 yours입니다.
첫 번째 요청: curl 예시
간단한 텍스트 완성 요청을 보내 연결을 검증하세요. 모델 ID를 사용하여 표준 채팅 완성 엔드포인트를 사용하세요. uncensored. 응답은 표준 콘텐츠 거부 없이 입력에 기반한 생성된 텍스트를 반환합니다.
이 기본 테스트는 키가 유효하고 엔드포인트에 접근 가능함을 확인합니다. 그런 다음 이 패턴을 애플리케이션 로직에 통합할 수 있습니다. 응답 구조는 OpenAI 형식을 반영하여 대부분의 기존 도구와의 호환성을 보장합니다.
curl https://api.isgeminiuncensored.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "List the top five Linux commands for network troubleshooting."}]
}'출력 품질을 확인하기 위해 간단한 프롬프트로 시작하세요. 그런 다음 필요에 따라 더 복잡한 상호작용으로 확장할 수 있습니다. 시스템이 컨텍스트 관리의 무거운 작업을 처리해 드립니다.
Python SDK 통합
공식 Python 라이브러리를 사용하여 스크립트에 API를 통합하세요. base URL을 우리 엔드포인트로 설정하고 API 키를 제공하세요. 이 방법은 기존 코드베이스를 최소한의 변경으로 활용할 수 있게 합니다. 필요에 따라 스트리밍 또는 동기 호출을 사용할 수 있습니다.
Python SDK는 요청의 직렬화를 자동으로 처리합니다. 출력에 영향을 주기 위해 temperature 및 top_p과 같은 매개변수를 전달할 수 있습니다. 이 유연성은 특정 사용 사례에 맞게 모델 동작을 미세 조정할 수 있게 합니다. 채팅봇을 구축하든 분석 도구를 만들든 SDK는 프로세스를 단순화합니다.
from openai import OpenAI
client = OpenAI(base_url="https://api.isgeminiuncensored.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)SDK는 쉽게 구문 분석할 수 있는 구조화된 데이터를 반환하므로 응답 객체를 올바르게 처리하세요. 이렇게 하면 디버깅과 테스트가 간편해집니다. 높은 처리량이 필요한 애플리케이션의 경우 비동기 클라이언트도 사용할 수 있습니다.
Node SDK 통합
공식 OpenAI npm 패키지를 사용하여 Node.js 애플리케이션에 통합하세요. 클라이언트를 우리 베이스 URL을 가리키도록 설정하고 API 키를 지정하세요. 이를 통해 JavaScript 프로젝트에서 익숙한 패턴을 사용할 수 있습니다. 동기식 또는 비동기식 요청을 쉽게 수행할 수 있습니다.
Node SDK는 promise와 async/await과 같은 최신 JavaScript 기능을 지원합니다. 이는 오류 처리 및 응답 처리를 깔끔하게 만듭니다. Python SDK와 동일한 매개변수를 전달하여 모델의 동작을 조정할 수 있습니다. 이 언어 간 일관성은 여러 기술을 사용하는 팀의 학습 곡선을 줄입니다.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.isgeminiuncensored.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);간단한 쿼리로 통합을 테스트하세요. 응답은 설정이 올바른지 확인할 수 있습니다. 그런 다음 더 복잡한 상호작용을 구축할 수 있습니다. SDK는 HTTP 요청을 효율적으로 처리하여 낮은 지연 시간을 보장합니다.
스트리밍 응답
스트리밍을 활성화하려면 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)네트워크 중단 사항을 우아하게 처리하세요. 스트리밍은 클라이언트의 기능에 따라 일시 중지하거나 다시 시작할 수 있습니다. 이 유연성은 불안정한 연결에서도 원활한 사용자 경험을 보장합니다. 사용자가 입력을 변경하는 경우 스트림을 조기에 중지할 수 있습니다.
제한 사항, 오류 및 컨텍스트
계정당 분당 300개의 요청과 키당 8개의 동시 요청에 대한 속도 제한이 있습니다. 이 제한을 초과하면 429 오류가 발생합니다. 중단 없이 사용량을 대시보드에서 모니터링할 수 있습니다. 이 제한은 모든 사용자에게 공정한 접근을 보장합니다.
컨텍스트 윈도우 지원은 프롬프트와 완성을 합산해 최대 100,000 토큰입니다. 요청당 최대 출력을 16,000 토큰으로 설정할 수 있습니다. 제한을 지정하지 않으면 기본값은 2,048 토큰입니다. 오류와 거부는 선불 크레딧을 소모하지 않습니다.
자주 발생하는 오류에는 키가 잘못되어 401, 크레딧 부족으로 402가 포함됩니다. 암호화폐로만 충전할 수 있습니다. TRC20의 USDT 또는 Base의 USDC가 허용됩니다. 이중 청구와 같은 실수는 지원을 통해 수정됩니다. 선불 크레딧은 만료되지 않으므로 원하는 속도로 충전할 수 있습니다. 이 구조는 비용을 예측 가능하고 투명하게 유지합니다.
