Character api 통합 빠른 시작

SDK 설치

언어용 공식 클라이언트 라이브러리를 설치하세요. 이는 제공되는 OpenAI 호환 엔드포인트와의 호환성을 보장합니다. 라이브러리는 직렬화 및 재시도 로직을 처리합니다.

Python의 경우 pip를 사용하세요. Node.js의 경우 npm을 사용하세요. 이 단계는 몇 초가 걸리며 이후의 코드 샘플을 위한 환경을 설정합니다.

기본 URL 구성

무장비 모델에 접근하기 위해 SDK 클라이언트를 우리의 엔드포인트로 설정하세요. 기본 URL은 HTTPS://api.apicharacter.com/v1입니다. 이는 구성에서 기본 OpenAI URL을 대체합니다.

이 변경 사항이 없으면 요청이 실패하거나 잘못된 서비스에 도달합니다. 클라이언트 인스턴스를 초기화할 때 이 값을 한 번만 설정하면 됩니다.

API 키 설정

키를 환경 변수나 클라이언트 구성에 삽입하세요. 모든 요청에는 사전 지불된 크레딧 사용량을 추적하기 위해 인증이 필요합니다. 키는 uncensored LLM 엔드포인트에 대한 접근 권한을 부여합니다.

이 값을 안전하게 보관하세요. 이 값은 계정에 대한 유일한 자격 증명입니다. 기본 접근에는 전화번호나 추가 인증이 필요하지 않습니다.

첫 번째 요청하기

연결성 확인을 위해 간단한 채팅 완료를 보내세요. 모델 ID는 "uncensored"입니다. 이는 애플리케이션을 구축하기 전에 인증 및 기본 URL이 올바른지 확인합니다.

표준 cURL 요청 예시는 아래를 참조하세요.

Copycurl https://api.apicharacter.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "set my name to Alex"}]
  }'

스트리밍 응답 처리

채팅 인터페이스에서 낮은 지연 시간을 위해 스트리밍을 활성화하세요. 요청에서 stream 파라미터를 true로 설정하세요. SDK는 생성되는 대로 토큰을 생성합니다.

반응형 사용자 경험을 위해 중요합니다. 서버 전송 이벤트를 통해 도착하는 부분 청크를 처리합니다.

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)

제한 사항, 오류 및 컨텍스트

서비스 중단을 방지하기 위해 제약 사항을 이해하세요. 100,000개의 토큰 컨텍스트 윈도우가 제공됩니다. 별도 지시가 없는 한 최대 출력은 16,000개 토큰입니다.

속도 제한은 분당 300회 요청입니다. 401 오류는 유효하지 않은 키를 의미하며, 402는 크레딧이 없음을 의미합니다. 429는 속도 제한에 도달했음을 의미합니다. 프로덕션 확장 시 이를 염두에 두세요.

Python

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.apicharacter.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

Copyimport OpenAI from "openai";

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