빠른 시작: apertus ai 채팅 통합하기

필수 조건 및 설정

계정을 생성하고 API 키를 얻는 것으로 시작하세요. 키 생성 페이지에서 Google 또는 이메일 비밀번호로 가입하세요. 시스템은 키를 즉시 표시하므로 지연 없이 복사할 수 있습니다. 등록에 전화번호가 필요하지 않습니다. 7일 동안 유효한 $0.50의試用 크레딧을 받으므로 자금을 추가하지 않고도 연결성을 테스트할 수 있습니다.

환경 변수 또는 SDK 클라이언트를 올바른 베이스 URL로 지정하세요. 이 URL은 표준 OpenAI 라이브러리와 호환됩니다. 베이스 URL과 키만 변경하세요. 모델 ID는 "uncensored"입니다. 이 단일 엔드포인트는 모든 텍스트 완료를 처리합니다. 라우팅을 관리하거나 다른 모델을 선택할 필요가 없습니다.

클라이언트 라이브러리가 OpenAI 채팅 완료 프로토콜을 지원하는지 확인하세요. 대부분의 최신 SDK는 즉시 작동합니다. 네트워크가 아웃바운드 HTTPS 요청을 허용하는지 확인하세요. 서비스는 표준 JSON 페이로드를 받습니다. 인증 외에도 특수 헤더는 필요하지 않습니다.

API 키들 인증

매번 요청 시 Authorization 헤더에 API 키를 전달하세요. Bearer 스키마를 키 문자열 앞에 붙여 사용하세요. 서비스는 키를 계정에 대해 검증합니다. 유효하지 않은 키는 401 Unauthorized 오류를 반환합니다. 만료되거나 잔액이 부족하면 402 Payment Required 응답이 발생합니다. 요청이 실패할 경우 대시보드에서 잔액을 확인하세요.

키는 안전하게 보관하세요. 각 계정에는 동시에 활성 상태인 키가 하나만 보유됩니다. 새 키를 생성하면 이전 키가 무효화됩니다. 키를 공개 저장소에 공유하지 마세요. API 키는 사용량의 유일한 식별자입니다. 속도 제한은 계정당이 아닌 키별로 적용됩니다.

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

인증은 상태 비저장 방식입니다. 서버는 호출마다 토큰을 확인합니다. 키를 교체하는 경우 실행 중인 모든 클라이언트를 즉시 업데이트하세요. 헤더가 누락되면 즉시 거부됩니다. 오류 메시지는 인증 실패를 명확히 명시합니다.

첫 번째 요청 보내기

채팅 완료 엔드포인트로 POST 요청을 보내십시오. 모델 ID "uncensored"와 메시지 기록을 포함하십시오. API는 텍스트 응답을 반환합니다. 출력을 스트리밍하거나 전체 완료를 기다릴 수 있습니다. 각 요청은 입력 및 출력 토큰을 소모합니다. 오류는 크레딧을 청구하지 않습니다. 거부도 무료입니다.

Copyfrom openai import OpenAI

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

응답에는 사용량 통계가 포함됩니다. 토큰 소비를 추적하여 선불 크레딧을 관리하세요. 이 모델은 합법적인 성인 용도에 대해 콘텐츠 거부 없이 응답합니다. 동작을 정의하기 위해 시스템 프롬프트를 보낼 수 있습니다. 사용자 메시지가 대화를 주도합니다. 컨텍스트 윈도우는 총 100,000개의 토큰을 지원합니다.

간단한 두 메시지 교환으로 시작하세요. 이는 연결성과 응답 품질을 검증합니다. 창의적이거나 정확한 출력을 위해 temperature와 top_p를 조정하세요. API는 표준 매개변수를 지원합니다. 중지 시퀀스는 예상대로 작동합니다. 시드 값은 재현 가능한 결과를 보장합니다.

SSE를 통한 스트리밍 응답

stream 파라미터를 true로 설정하여 스트리밍을 활성화하세요. API는 단일 JSON 객체 대신 서버 전송 이벤트(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는 기록을 다시 보내지 않습니다. 스트림이 실패한 경우 새 요청을 시작하세요. 마지막 청크의 토큰 수는 전체 생성을 반영합니다.

파라미터 및 모드 처리

생성 동작을 제어하기 위해 표준 매개변수를 사용하세요. 무작위성을 위해 temperature를 설정하세요. nucleus sampling을 위해 top_p을 조정하세요. 생성을 조기에 중단하기 위해 stop 시퀀스를 정의하세요. 결정론적 출력을 위해 seed를 전달하세요. response_format을 json_object로 설정하여 JSON 모드를 활성화하세요. 모델은 요청 시 유효한 JSON을 반환합니다.

함수 호출이 지원됩니다. 요청에 도구를 정의하세요. 모델은 적절한 경우 도구 호출을 반환합니다. 코드에서 도구 인수를 구문 분석하세요. 대화를 계속하기 위해 결과를 다시 전달하세요. 이는 복잡한 에이전트 워크플로우를 가능하게 합니다.

Copyimport OpenAI from "openai";

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

max_tokens은 출력 길이를 제한합니다. 기본값은 2,048 토큰입니다. 필요시 더 높은 값을 설정하세요. 요청당 하드 제한은 16,000 토큰입니다. 컨텍스트 윈도우는 100,000 토큰입니다. 이에 따라 히스토리 길이를 계획하세요. 빈도 및 존재 페널티는 반복을 줄이는 데 도움이 됩니다.

제한 사항 및 오류 이해하기

レート制限はサービスの安定性を保護します。1分あたり300リクエストを送信できます。同時実行数はキーごとに8つの同時リクエストに制限されています。リクエストボディは8 MBを超えてはなりません。制限を超えると429 Too Many Errorsが返されます。再試行する前に待機してください。

진단을 위한 오류 코드 확인. 401은 유효하지 않거나 누락된 키를 의미합니다. 402는 미결제 크레딧 부족을 나타냅니다. 서비스를 재개하려면 암호화폐로 충전하세요. 429는 속도 제한을 의미합니다. 400는 잘못된 요청 구문을 나타냅니다. 세부 사항은 오류 메시지를 참조하세요.

컨텍스트 윈도우 관리가 중요합니다. 프롬프트 토큰과 완성 토큰을 합산하세요. 100,000 토큰보다 훨씬 아래로 유지하세요. 필요시 이전 메시지를 잘라내세요. API는 자동으로 잘라내지 않습니다. 대화 길이를 직접 제어하세요. 효율적인 컨텍스트 사용은 비용을 절감합니다.