ko ▾
트라이얼 크레딧으로 시도하기

API 문서 및 시작하기

이 퀵스타트 가이드는 표준 OpenAI 호환 엔드포인트를 사용하여 당사 무검열 LLM API를 통합하는 방법을 안내합니다. 베이스 URL, 인증 방법, 스트리밍, 함수 호출, 속도 제한 처리 방법을 구독 부담 없이 배웁니다.

Base URL 및 인증

모든 요청의 base URL은 https://api.veniceaiapipricing.com/v1API 키를 전달하여 인증합니다. Authorization header에 Bearer 토큰으로 설정합니다. 이 설정은 모든 표준 OpenAI SDK와 함께 작동합니다. 다음을 대체하세요 YOUR_API_KEY 계정 대시보드에서 생성한 키를 사용하세요.

  • 엔드포인트: POST /v1/chat/completions
  • 헤더: Authorization: Bearer YOUR_API_KEY
curl https://api.veniceaiapipricing.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Return server status code 200"}]
  }'

/v1/chat/completions 엔드포인트

대화 기록을 보내기 /v1/chat/completions 를 사용하여 uncensored 모델 ID입니다. API는 role 및 content 필드들입니다. 입력 토큰은 백만 개당 $0.15, 출력 토큰은 백만 개당 $0.50입니다. 오류 및 거부는 크레딧을 소모하지 않습니다.

이 엔드포인트는 텍스트 전용 생성을 지원합니다. 이미지, 오디오, 임베딩은 처리하지 않습니다. 응답을 스트리밍하거나 전체 텍스트를 단일 JSON 객체로 조회할 수 있습니다.

from openai import OpenAI

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

스트리밍 응답 (SSE)

stream을 true로 설정하여 스트리밍 활성화 stream: true 요청 본문에 포함하세요. API는 생성된 각 토큰에 대해 서버 전송 이벤트(SSE)를 반환합니다. 마지막 청크에는 총 토큰 사용량 통계가 포함됩니다. 이 방법은 긴 응답에 대한 지각된 지연 시간을 줄입니다.

스트림 처리는 실시간 애플리케이션에 필수적입니다. 전체 완료 대기 대신 토큰이 도착하는 대로 처리할 수 있습니다.

stream = 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)

함수 호출 및 JSON 모드

API는 구조화된 출력과 도구 정의를 지원합니다. 사용 response_format: {"type": "json_object"} JSON 출력을 강제합니다. 또한 tools 함수 호출. 모델이 애플리케이션 로직을 위해 구조화된 데이터를 반환합니다.

이 기능은 데이터 추출 또는 작업 트리거에 유용합니다. 모델은 표준화된 형식으로 도구 호출을 반환합니다. 그런 다음 함수를 실행하고 결과를 대화에 다시 피드백할 수 있습니다.

파라미터: Temperature, Top P, Seeds

temperature로 창의성을 제어하십시오 temperature 및 top_pThe seed 매개변수는 테스트를 위한 결정론적 출력을 보장합니다. 이러한 매개변수는 표준 OpenAI 관례를 따릅니다. 조정하면 생성된 텍스트의 무작위성에 영향을 미칩니다.

設定 temperature to 0.7 균형 잡힌 창의성을 위해. 사용 seed 재현 가능한 결과를 위해 API는 지원되지 않는 매개변수를 우아하게 무시합니다.

속도 제한 및 제약 조건

키당 분당 요청 수는 300개로 제한됩니다. 키당 최대 8개의 동시 요청이 허용됩니다. 요청 본문 크기는 8MB로 제한됩니다. 컨텍스트 윈도우는 입력과 출력을 합쳐 100,000토큰입니다. 요청당 최대 출력은 16,000토큰입니다.

이러한 제한을 초과하면 429 오류가 반환됩니다. 클라이언트에서 재시도를 적절히 처리해야 합니다. API 키는 계정당 고유하며, 새 키를 생성하면 이전 키가 대체됩니다.

Node.js

import OpenAI from "openai";

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

자주 묻는 질문

venice AI API의 입력 및 출력 토큰 요금제는 어떻게 되나요?

입력 토큰은 백만 토큰당 $0.15, 출력 토큰은 백만 토큰당 $0.50입니다. 실제 사용량에 대해서만 요금이 부과되며, 오류와 거부 응답은 무료입니다.

401 또는 402와 같은 인증 오류를 어떻게 처리하나요?

401 오류는 유효하지 않거나 누락된 API 키를 나타냅니다. 402 오류는 선불 크레딧 잔액이 부족함을 의미합니다. 접근 권한을 복원하려면 크립토를 통해 충전하십시오.

속도 제한(rate limit)에 도달하면 어떻게 되나요?

API에서 1분당 300회 요청 또는 8개의 동시 연결을 초과할 경우 429 오류가 반환됩니다. 잠시 대기한 후 재시도하거나 요청 빈도를 줄이세요.

API 키 받기

가입하고, 키를 가져온 후, 베이스 URL을 업데이트하세요. 완료.