소개

​

인증

Authorization: Bearer VENICE_API_KEY

​

OpenAI 호환성

​

설정

curl https://api.venice.ai/api/v1/chat/completions \
  -H "Authorization: Bearer $VENICE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "venice-uncensored",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

​

Venice 전용 기능

​

시스템 프롬프트

1. 기본 동작: 시스템 프롬프트가 Venice의 기본값에 추가됨
2. 사용자 지정 동작: Venice의 시스템 프롬프트를 완전히 비활성화

​

Venice 시스템 프롬프트 비활성화

curl https://api.venice.ai/api/v1/chat/completions \
  -H "Authorization: Bearer $VENICE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "venice-uncensored",
    "messages": [
      {"role": "system", "content": "Your custom system prompt"},
      {"role": "user", "content": "Why is the sky blue?"}
    ],
    "venice_parameters": {
      "include_venice_system_prompt": false
    }
  }'

​

Venice 매개변수

​

프롬프트 캐싱

​

응답 헤더 참조

​

중요 참고 사항

• 헤더 이름 대소문자: HTTP 헤더는 대소문자를 구분하지 않지만 Venice는 일관성을 위해 소문자와 하이픈을 사용합니다
• 문자열 값: 헤더의 부울 값은 문자열 ("true" 또는 "false")로 반환됩니다
• 숫자 값: 정밀도 손실을 방지하기 위해 큰 숫자와 잔액 값은 문자열로 반환될 수 있습니다
• 선택적 헤더: 모든 헤더가 모든 응답에 반환되는 것은 아닙니다; 존재 여부는 엔드포인트와 요청 컨텍스트에 따라 다릅니다
• 압축: 지원되는 경우 압축된 응답을 받으려면 요청에 Accept-Encoding: gzip, br을 사용하세요

​

예제: 응답 헤더 접근

// After making an API request, access headers from the response object
const requestId = response.headers.get('CF-RAY');
const remainingRequests = response.headers.get('x-ratelimit-remaining-requests');
const remainingTokens = response.headers.get('x-ratelimit-remaining-tokens');
const usdBalance = response.headers.get('x-venice-balance-usd');

// Check for model deprecation warnings
const deprecationWarning = response.headers.get('x-venice-model-deprecation-warning');
if (deprecationWarning) {
  console.warn(`Model Deprecation: ${deprecationWarning}`);
}

​

모범 사례

1. 속도 제한: x-ratelimit-remaining-requests 및 x-ratelimit-remaining-tokens 헤더를 모니터링하고 지수 백오프 구현
2. 잔액 모니터링: 서비스 중단을 방지하기 위해 x-venice-balance-usd 및 x-venice-balance-diem 헤더 추적
3. 시스템 프롬프트: Venice의 시스템 프롬프트를 사용하거나 사용하지 않고 테스트하여 사용 사례에 가장 적합한 것 찾기
4. API 키: API 키를 안전하게 보관하고 정기적으로 회전
5. 요청 로깅: 지원과의 문제 해결을 위해 CF-RAY 헤더 값 기록
6. 모델 지원 중단: 모델 사용 시 x-venice-model-deprecation-warning 헤더 확인

​

OpenAI API와의 차이점

1. venice_parameters: 확장 기능을 위한 enable_web_search, character_slug, strip_thinking_response와 같은 추가 구성
2. 시스템 프롬프트: Venice는 검열되지 않은 응답에 최적화된 기본값에 시스템 프롬프트를 추가합니다 (include_venice_system_prompt: false로 비활성화)
3. 모델 생태계: Venice는 검열되지 않은 모델과 추론 모델을 포함한 자체 모델 라인업을 제공합니다 - OpenAI 매핑이 아닌 Venice 모델 ID를 사용하세요
4. 응답 헤더: 잔액 추적(x-venice-balance-usd, x-venice-balance-diem), 모델 지원 중단 경고 및 콘텐츠 안전 플래그를 위한 고유 헤더
5. 콘텐츠 정책: 전용 검열되지 않은 모델과 선택적 콘텐츠 필터링이 있는 보다 허용적인 정책

​

API 안정성

​

OpenAPI 사양 & 원시 데이터

• OpenAPI Spec (YAML) — YAML 형식의 전체 API 사양
• API Docs Source — 다운로드 가능한 아카이브로 제공되는 모든 문서 페이지(.mdx 형식)