Character AI API: 세 줄로 클라이언트 전환

사전 준비 사항

코드를 작성하기 전에 characteraiapi.com에서 활성 계정이 필요합니다. API 키 가져오기 페이지를 방문하여 이메일과 비밀번호로만 가입하세요. 시작하려면 신용카드가 필요 없으며, 새 계정에는 7일 동안 유효한 $0.50의 무료 체험 크레딧이 제공됩니다. 등록하면 API 키가 즉시 표시됩니다. 이 키는 엔드포인트의 모든 요청을 인증하므로 안전하게 보관하세요. 개발 환경에 지원되는 언어 SDK도 설치해야 합니다. character ai api 엔드포인트는 표준 OpenAI 매개변수를 지원하므로 기존 OpenAI 호환 클라이언트는 최소한의 변경으로 작동할 수 있습니다.

SDK 설치

Python 프로젝트의 경우 pip를 사용하여 공식 OpenAI 패키지를 설치하세요. 이 라이브러리는 JSON 직렬화 및 HTTP 요청을 자동으로 처리합니다. Node.js 애플리케이션의 경우 npm을 사용하여 openai 패키지를 추가하세요. 두 라이브러리 모두 이 가이드의 뒷부분에서 설명하는 스트리밍 및 도구 호출 기능을 지원합니다. 실시간 토큰 스트리밍을 위한 Server-Sent Events(SSE)를 지원할 만큼 SDK 버전이 최신인지 확인하세요. SDK 대신 사용자 정의 HTTP 클라이언트를 사용하는 경우 OpenAI API 사양에 따라 JSON 페이로드 및 SSE 스트림 파싱을 수동으로 처리해야 합니다.

인증

모든 API 요청에는 Authorization 헤더에 API 키를 포함해야 합니다. Bearer YOUR_API_KEY 형식을 사용하세요. 모든 요청의 기본 URL은 https://api.characteraiapi.com/v1입니다. SDK를 사용하는 경우 base_url 구성을 이 값으로 설정하고 api_key 매개변수를 통해 키를 제공하세요. 키를 분실하거나 유출된 것으로 의심되는 경우 대시보드에서 재생성할 수 있습니다. 이전 키는 즉시 무효화됩니다. 계정당 활성 키는 하나만 허용됩니다. 표준 OpenAI 엔드포인트로의 요청은 404 또는 401 오류로 실패하므로 올바른 기본 URL을 사용하고 있는지 확인하세요.

기본 채팅 완료

핵심 기능은 /v1/chat/completions 엔드포인트를 통해 제공됩니다. uncensored 모델 이름과 메시지 기록을 사용하여 POST 요청을 보내세요. 모델은 합법적인 성인 콘텐츠에 대한 표준 콘텐츠 필터를 적용하지 않고 텍스트 출력을 반환합니다. 아래는 간단한 텍스트 완료 요청을 보여주는 curl 예제입니다.

Copycurl https://api.characteraiapi.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."}]
  }'

이 요청은 생성된 텍스트를 포함하는 완료 객체를 반환합니다. temperature과 같은 매개변수를 조정하여 무작위성을 제어하거나 max_tokens을 사용하여 출력 길이를 제한할 수 있습니다. 모델은 100,000개의 토큰 컨텍스트 창을 지원하여 단일 요청에서 상당한 대화 기록이나 긴 문서를 처리할 수 있습니다.

스트리밍 응답

더 나은 사용자 경험을 위해 요청에 stream: true을 설정하여 스트리밍을 활성화하세요. API는 생성되는 대로 부분 토큰 청크를 포함하는 Server-Sent Events(SSE)를 반환합니다. 이는 채팅봇 애플리케이션의 지각된 지연 시간을 줄입니다. 마지막 이벤트에서 최종 사용량 통계를 받으려면 stream_options 매개변수를 사용하세요. 스트리밍은 텍스트를 단어 단위로 표시하여 몰입감을 높이는 실시간 캐릭터 역할극에 특히 유용합니다. 클라이언트 코드가 각 청크를 순차적으로 파싱할 수 있도록 SSE 형식을 올바르게 처리해야 합니다.

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)

속도 제한 및 오류

API는 키당 분당 300개의 요청 제한을 시행합니다. 이를 초과하면 429 Too Many Requests 오류가 발생합니다. 요청 본문은 8 MB로 제한됩니다. 일반적인 오류로는 유효하지 않거나 누락된 키에 대한 401 오류와 선불 크레딧이 고갈된 경우 402 오류가 있습니다. 크립토(USDT 또는 USDC)를 사용하여 $10부터 충전할 수 있으며, 더 큰 예치금에는 보너스 크레딧이 제공됩니다. 일부 제공업체와 달리 숨겨진 수수료나 구독 잠금이 없으며, 소비한 토큰에 대해서만 지불합니다. 가격은 투명합니다: 입력 토큰 100만 개당 $0.25, 출력 토큰 100만 개당 $1.00. 오류 처리 로직이 429 오류 발생 시 지수 백오프로 재시도하도록 확인하세요.

Copyfrom openai import OpenAI

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