빠른 시작: 클라이언트 연결

필수 조건 및 SDK 설치

인증 및 요청 직렬화를 자동으로 처리하려면 언어별 공식 SDK를 설치하세요. 유효한 API 키와 클라이언트 환경에 구성된 기본 URL이 필요합니다. 당사 서비스는 사용자 지정 헤더 없이도 temperature 및 top_p와 같은 표준 매개변수를 지원합니다.

환경 변수에 토큰을 실행 전에 안전하게 저장하세요. SDK 버전은 스트리밍 및 JSON 모드 기능을 올바르게 지원하기 위해 최신 상태여야 합니다. 텍스트 전용 생성에는 추가 드라이버가 필요하지 않습니다.

베이스 URL 및 키 구성

클라이언트를 저희 특정 베이스 URL로 연결하여 uncensored 인프라를 통해 요청을 라우팅하세요. 모든 호출에 인증하려면 Authorization: Bearer YOUR_KEY 헤더를 사용하세요. 이 설정은 로컬 테스트나 프로덕션 배포 스크립트 모두에서 동일하게 작동합니다.

기본 OpenAI 엔드포인트를 다른 제공업체와의 혼동을 피하기 위해 우리 호스트로 교체하세요. 키를 비공개로 유지하고 공개 저장소에 노출하지 마세요. 구성은 키를 교체할 때까지 고정됩니다.

첫 번째 요청 보내기

연결성 및 응답 형식을 확인하기 위해 표준 채팅 완료 호출을 실행합니다. 모델이 거부 없이 텍스트를 반환하는지 확인하기 위해 간단한 프롬프트를 보내세요. 이 테스트는 키에 사용량에 충분한 선불 크레딧이 있음을 확인합니다.

Copycurl https://api.keyapiminimax.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Generate a JSON object with keys id and name"}]
  }'

콘텐츠 및 토큰 사용량 세부 정보를 확인하세요. 401 오류가 발생하면 키 형식을 확인하세요. 402는 크레딧 잔액을 충전해야 함을 나타냅니다.

ストリーミングレスポンスの処理

스트리밍을 활성화하여 생성되는 대로 토큰을 실시간으로 수신하세요. 이는 긴 출력물을 기다리는 사용자의 지각된 지연 시간을 줄여줍니다. 마지막 청크에는 과금 정확성을 위한 최종 토큰 수가 포함되어 있습니다.

Copystream = 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)

클라이언트 코드에서 부분 응답을 우아하게 처리하세요. 스트림이 종료되거나 오류가 발생할 때까지 내용을 버퍼링하세요. 스트리밍은 온도 조정 등 모든 표준 파라미터와 함께 작동합니다.

Python SDK 통합

Python 라이브러리를 사용하여 최소한의 보일러플레이트 코드로 요청을 관리하세요. base URL과 키로 클라이언트를 초기화하여 즉시 사용하세요. 이 접근 방식은 오류 처리 및 응답 파싱을 단순화합니다.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.keyapiminimax.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 및 제한 사항

공식 JavaScript SDK를 사용하여 Node.js 애플리케이션에 통합하세요. 요청이 우리 무검열 엔드포인트에 도달하도록 베이스 URL을 설정하세요. 사용량을 모니터링하여 속도 제한 내에서 유지하세요.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.keyapiminimax.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);

분당 300개의 요청을 보낼 수 있으며, 동시 요청 수는 8개입니다. 각 요청 본문은 8 MB 미만이어야 합니다. 컨텍스트 윈도우는 총 100,000 토큰을 지원합니다. 오류와 거절은 크레딧을 소모하지 않지만, 성공적인 출력은 소모합니다. 키를 안전하게 관리하고 필요시 교체하세요.

토큰 사용량 이해하기

결제는 프롬프트 및 완성에서 실제로 사용된 토큰을 기반으로 합니다. 입력 토큰은 100만 개당 $0.15, 출력 토큰은 100만 개당 $0.50입니다. 선불 크레딧은 월별 수수료 없이 모든 사용량을 커버합니다.

에러와 거부는 무료이므로 성공적인 응답에 대해서만 요금이 부과됩니다. 스트림의 마지막 청크에는 토큰 수가 포함됩니다. 지출을 추적하고 크레딧이 고갈되지 않도록 대시보드를 모니터링하세요. USDT 또는 USDC로 충전하여 즉시 액세스하세요.