개발자를 위한 통합 가이드

인증 및 Base URL 설정

대시보드에서 API 키를 생성하세요. 베이스 URL은 HTTPS://api.apiaicheap.com/v1입니다. Authorization 헤더에 Bearer 토큰으로 키를 전송하세요.

• "API 키 받기"를 클릭하고 Google 또는 이메일로 로그인하세요.
• 키를 즉시 복사하세요. 한 번만 표시됩니다.

이 키는 채팅 완성 엔드포인트로의 모든 요청을 인증합니다.

예시 헤더

인증: Bearer YOUR_API_KEY

cURL을 사용한 첫 번째 요청

설치를 테스트하기 위해 기본 채팅 완료를 보내십시오. 모델 "uncensored"와 함께 POST /v1/chat/completions 엔드포인트를 사용하십시오.

이 테스트는 크레딧 잔액과 지연 시간을 확인합니다.

• 역할을 "user"로 설정합니다.
• 첫 번째 테스트를 위해 메시지를 간단하게 유지하세요.

생성된 텍스트 필드가 있는지 확인하세요.

• "content" 값을 확인하세요.

200 OK를 받으면 통합이 정상적으로 작동하고 있다는 의미입니다.

Copycurl https://api.apiaicheap.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Fix the null pointer in the login handler"}]
  }'

Python SDK 통합

간단한 통합을 위해 공식 OpenAI Python 라이브러리를 사용하세요. 기본 URL을 가리키고 API 키를 설정하세요.

이 방식은 재시도 및 JSON 파싱을 자동으로 처리합니다.

• pip를 통해 라이브러리를 설치합니다.
• base_url 매개변수를 우리 엔드포인트로 설정하세요.

chat.completions.create 메서드를 호출하세요.

메시지 목록을 인수로 전달하세요.

• 모델 이름 "uncensored"를 포함합니다.

객체의 속성을 통해 응답 텍스트에 액세스하세요.

이 방법은 프로덕션 스크립트에 대해 깔끔하고 가독성이 높습니다.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.apiaicheap.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 SDK 사용법

Node.js SDK는 Python 버전과 유사하게 작동합니다. 키와 당사 베이스 URL로 클라이언트를 초기화합니다.

이렇게 하면 익숙한 async/await 패턴을 사용할 수 있습니다.

• OpenAI 패키지를 가져옵니다.
• 생성자에서 베이스 URL을 구성합니다.

메시지를 사용하여 완료 요청을 생성합니다.

결과를 얻기 위해 프라미스를 처리하세요.

• 응답에서 메시지 내용을 추출합니다.

모델이 올바르게 응답하는지 확인하기 위해 출력을 기록합니다.

이러한 구성은 웹 서버 및 백엔드 서비스에 이상적입니다.

Copyimport OpenAI from "openai";

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

SSE를 통한 스트리밍 응답

요청에 stream을 true로 설정하여 스트리밍을 활성화하세요. API는 생성되는 대로 서버 전송 이벤트를 통해 청크를 반환합니다.

채팅 앱에서 사용자의 지각된 지연 시간을 줄입니다.

• 페이로드에서 stream: true를 설정합니다.
• 도착하는 각 청크를 처리합니다.

청크를 결합하여 최종 응답을 구성하세요.

토큰 사용량 세부 정보는 마지막 청크에 표시됩니다.

• 마지막 청크의 "usage" 필드를 확인하세요.

이 방식은 긴 생성 중에도 사용자 인터페이스가 반응형으로 유지되도록 합니다.

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)

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

계정당 분당 300개의 요청 제한이 있습니다. 컨텍스트 윈도우는 프롬프트와 완성을 합쳐 100,000개의 토큰을 지원합니다.

오류는 표준 HTTP 상태 코드로 처리됩니다.

• 401은 유효하지 않거나 누락된 API 키를 나타냅니다.
• 402는 선불 크레딧이 소진되었음을 의미합니다.
• 429는 속도 제한을 초과했음을 신호합니다.

거절은 크레딧이 들지 않습니다. 오류도 무료입니다.

요청당 최대 출력은 16,000 토큰입니다. 더 적은 양이 필요하면 max_tokens을 설정하세요.

이 구조는 예측 가능한 청구와 성능을 보장합니다.