하나의 API: 빠른 시작 가이드

기본 URL 및 인증

클라이언트를 전용 엔드포인트로 연결하세요. 이 OpenAI 호환 API는 표준 인증 헤더를 사용하므로 구성 파일의 두 값만 변경하면 됩니다.

기본 URL은 https://api.onekeyllmapi.com/v1입니다. 가입 페이지에서 고유한 API 키를 생성하세요. 시작 시 카드가 필요 없으며, 등록 직후 키가 표시됩니다. 이 키를 안전하게 보관하세요; 이 키는 서비스로의 모든 요청을 인증합니다.

기본 완성

단순 텍스트 프롬프트를 보내 직접 응답을 받으세요. 이는 개발자를 위한 ai api 제공의 핵심입니다. 모델은 합법적인 성인 용도에 콘텐츠 거부 없이 텍스트를 반환하므로 창의적이거나 제한 없는 작업에 이상적입니다.

• 모델 ID: uncensored
• 엔드포인트: POST /v1/chat/completions
• 컨텍스트: 100,000 토큰

다음 예시로 첫 번째 요청을 수행하세요:

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

Python SDK 통합

공식 OpenAI Python 라이브러리를 사용하여 서비스에 연결하세요. 필요한 변경사항은 base_url과 api_key뿐입니다. 기존 로직은 수정 없이 그대로 작동합니다.

• pip install openai를 통해 설치하세요
• 환경 변수를 설정하거나 클라이언트 초기화 시 직접 전달하세요
• 일반적으로 chat.completions.create()를 호출하세요

클라이언트를 다음과 같이 구성하세요:

Copyfrom openai import OpenAI

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

표준 OpenAI Node 패키지를 사용하여 JavaScript 또는 TypeScript 프로젝트와 통합하세요. 클라이언트를 해당 URL로 향하게 하고 키를 제공하세요. 이 접근 방식은 모든 OpenAI 호환 클라이언트 구조와의 호환성을 유지합니다.

• npm install openai로 설치하세요
• 사용자 정의 기본 URL로 초기화하세요
• 표준 async/await 패턴을 사용하세요

초기화 예시:

Copyimport OpenAI from "openai";

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

스트리밍 응답

지각된 지연 시간을 줄이기 위해 토큰별로 응답을 받으세요. 당사 스트리밍 api는 Server-Sent Events(SSE)를 지원하므로 생성되는 대로 출력을 표시할 수 있습니다. 이는 채팅 인터페이스나 실시간 애플리케이션에 유용합니다.

• 요청에 stream: true를 설정하세요
• 클라이언트에서 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는 긴 문서나 대화 내용을 처리할 수 있는 100k 컨텍스트 창을 지원합니다. 요청 본문 크기는 8 MB를 초과할 수 없습니다.

일반적인 오류로는 유효하지 않은 키에 대한 401, 선불 크레딧이 고갈되었을 때의 402, 분당 300개 요청을 초과한 429이 있습니다. 종량제 크레딧은 만료되지 않으며, $10부터 충전할 수 있습니다. 함수 실행을 위한 함수 호출이 지원됩니다.