API 문서

Base URL 및 인증

API 엔드포인트는 https://api.openrouteraiapi.com/v1. API 키를 다음에 전달하세요 Authorization header에 Bearer 토큰으로 설정합니다. 이 header는 현재 제공업체에서 당사 무검열 모델로 트래픽을 리디렉션하기 위해 필요한 유일한 변경 사항입니다.

인증은 엄격합니다. 키가 없거나 유효하지 않으면 서버가 즉시 401 오류를 반환합니다. 대시보드에서 Google 또는 이메일을 통해 키를 즉시 생성할 수 있습니다. 키를 안전하게 보관하세요. 이 키는 선불 잔액에 대한 접근 권한을 부여합니다.

채팅 완료 엔드포인트

POST 요청을 다음으로 보내기 /v1/chat/completions messages 배열과 함께. 모델 식별자는 uncensored. 이 단일 모델은 복잡한 라우팅 로직 없이 모든 텍스트 생성 필요를 처리합니다.

연결성 및 응답 형식을 확인하기 위한 cURL 표준 요청입니다.

Copycurl https://api.openrouteraiapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "list the top five python libraries for data science"}]
  }'

응답에는 생성된 텍스트가 choices[0].message.content 필드입니다. 이를 애플리케이션 워크플로우로 직접 구문 분석할 수 있습니다.

Python SDK 통합

공식 OpenAI Python 클라이언트를 사용하여 손쉽게 연결하세요. 설정 base_url 및 api_key 우리의 인프라를 가리키도록 변수를 설정하세요. 이렇게 하면 공급업체를 전환할 때 코드 변경을 최소화할 수 있습니다.

Copyfrom openai import OpenAI

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

커스텀 베이스 URL을 사용하여 OpenAI Node.js 클라이언트를 초기화합니다. 이를 통해 JavaScript 애플리케이션은 친숙한 메서드를 사용하여 uncensored 모델과 상호작용할 수 있습니다. SDK는 HTTP 요청을 효율적으로 관리합니다.

Copyimport OpenAI from "openai";

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

호출 chat.completions.create() 메시지를 사용합니다. 응답 객체는 생성된 콘텐츠와 사용 데이터에 접근할 수 있게 합니다. 이 통합은 웹 서버와 엣지 함수에 잘 맞습니다.

스트리밍 응답

stream을 true로 설정하여 스트리밍 활성화 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)

각 청크는 부분 콘텐츠를 포함합니다. 마지막 청크에는 완전한 토큰 사용량 통계가 포함됩니다. 클라이언트에서 이러한 이벤트를 처리하여 UI를 단계적으로 업데이트하세요.

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

컨텍스트 윈도우는 입력과 출력을 합쳐 100,000개의 토큰을 지원합니다. 각 요청은 최대 16,000개의 토큰을 출력할 수 있으며, 설정하지 않을 경우 2,048개입니다. max_tokens 설정되지 않음). 속도 제한은 키당 분당 300회 요청을 허용합니다.

오류는 표준 HTTP 코드입니다. 401은 유효하지 않은 키를 나타냅니다. 402는 선불 크레딧이 고갈되었음을 의미합니다. 429는 속도 제한을 초과했음을 신호합니다. 실패한 요청은 크레딧을 소모하지 않습니다. 오류는 무료입니다.