Migrate from OpenAI | Venice API Docs

Venice AI는 OpenAI를 위한 드롭인 대체품입니다. 동일한 SDK, 동일한 코드 — 두 줄만 변경하면 됩니다. 개인정보 우선 추론, 검열되지 않은 모델, 경쟁력 있는 가격을 얻으세요.

2줄 마이그레이션

# 변경 전 (OpenAI)
from openai import OpenAI
client = OpenAI()

# 변경 후 (Venice) — api_key와 base_url을 변경
from openai import OpenAI
client = OpenAI(
    api_key="your-venice-api-key",           # ← 변경 1
    base_url="https://api.venice.ai/api/v1",  # ← 변경 2
)

// 변경 전 (OpenAI)
import OpenAI from "openai";
const client = new OpenAI();

// 변경 후 (Venice)
import OpenAI from "openai";
const client = new OpenAI({
  apiKey: "your-venice-api-key",
  baseURL: "https://api.venice.ai/api/v1",
});

# 변경 전
curl https://api.openai.com/v1/chat/completions ...

# 변경 후 — URL과 키만 변경
curl https://api.venice.ai/api/v1/chat/completions ...

venice.ai/settings/api에서 키를 생성하거나 API 키 가이드를 따르세요.

환경 변수

# 변경 전
OPENAI_API_KEY=sk-...
OPENAI_BASE_URL=https://api.openai.com/v1

# 변경 후
OPENAI_API_KEY=your-venice-api-key
OPENAI_BASE_URL=https://api.venice.ai/api/v1

많은 라이브러리와 도구가 OPENAI_API_KEY와 OPENAI_BASE_URL을 자동으로 읽습니다. 이러한 환경 변수만 업데이트하면 충분할 수 있습니다. 일부 도구는 동일한 URL에 대해 여전히 OPENAI_API_BASE를 사용합니다.

모델

Venice 모델 ID, default나 most_uncensored와 같은 특성(trait), 또는 익숙한 OpenAI 스타일 이름을 전달할 수 있습니다. Venice는 호환성 매핑을 통해 OpenAI 이름을 매핑합니다. 특성은 항상 해당 역할의 현재 모델로 해석됩니다 — 모델 특성을 참조하세요. 실시간 카탈로그는 텍스트 모델과 가격에서 확인하세요. 첫 요청 안내는 퀵스타트를 참조하세요.

기능 호환성

기능	OpenAI	Venice	참고
Chat Completions	✅	✅	완전히 호환
스트리밍	✅	✅	동일한 SSE 형식
Function Calling	✅	✅	동일한 `tools` 매개변수
구조화된 출력	✅	✅	동일한 `response_format`
Vision	✅	✅	동일한 content 배열 형식
Embeddings	✅	✅	동일한 API
이미지 생성	✅	✅	`/images/generations`를 통한 OpenAI 호환
TTS	✅	✅	호환
STT	✅	✅	호환
Responses API	✅	✅	알파
Assistants API	✅	❌	Characters 또는 function calling을 사용하세요
Batch API	✅	❌	아직 사용 불가
Fine-tuning	✅	❌	사용 불가

OpenAI 호환 엔드포인트 외의 네이티브 이미지 옵션은 이미지 생성을 참조하세요.

Venice 전용 기능

Venice 전용 옵션은 extra_body의 venice_parameters로 전달합니다. 내장된 웹 검색이 대표적인 첫 번째 추가 옵션입니다:

response = client.chat.completions.create(
    model="default",
    messages=[{"role": "user", "content": "Latest AI news today"}],
    extra_body={
        "venice_parameters": {
            "enable_web_search": "auto"
        }
    },
)

동일한 패턴이 웹 스크래핑, 인용, Characters에도 적용됩니다. 클라이언트가 요청 본문을 변경할 수 없다면 default:enable_web_search=auto와 같은 모델 기능 접미사를 추가하세요. Venice는 OpenAI 호환 인터페이스와 함께 네이티브 비디오, 음악, 웹 검색, x402 API도 제공합니다.

프레임워크

대부분의 AI 프레임워크는 베이스 URL만 변경하면 Venice와 함께 작동합니다:

LangChain

ChatOpenAI의 base_url

Vercel AI SDK

createOpenAI의 baseURL

LlamaIndex

OpenAI 호환 클라이언트의 api_base

CrewAI

OPENAI_API_BASE 환경 변수

PydanticAI

Venice 베이스 URL을 사용한 OpenAI 호환 모델

Cursor

설정의 사용자 지정 API 엔드포인트

Claude Code

Claude Code를 Venice로 라우팅

Codex CLI

config.toml의 모델 제공자

Aider

OPENAI_API_BASE 환경 변수

더 많은 코딩 에이전트와 도구는 AI 에이전트에서 확인할 수 있습니다.

검열되지 않은 모델

Venice의 비공개 검열되지 않은 모델은 콘텐츠 필터링이 없어 다음에 적합합니다:

가드레일 없는 창의적 글쓰기
보안 연구 및 레드 팀
거부 패턴 없는 정직한 분석
추가 면책 조항 없는 의료 및 법률 정보

most_uncensored 특성이나 텍스트 모델의 현재 검열되지 않은 모델 ID를 사용하세요.

API 키 받기

Venice API 키를 생성하고 몇 분 안에 마이그레이션을 시작하세요

문서

시작하기

텍스트 및 채팅

이미지, 비디오 및 오디오

검색 및 RAG

에이전트 및 통합

코딩 도구

에이전트 도구

SDK 및 프레임워크

OpenAI에서 마이그레이션

2줄 마이그레이션

환경 변수

모델

기능 호환성

Venice 전용 기능

프레임워크

LangChain

Vercel AI SDK

LlamaIndex

CrewAI

PydanticAI

Cursor

Claude Code

Codex CLI

Aider

검열되지 않은 모델

API 키 받기

​2줄 마이그레이션

​환경 변수

​모델

​기능 호환성

​Venice 전용 기능

​프레임워크

LangChain

Vercel AI SDK

LlamaIndex

CrewAI

PydanticAI

Cursor

Claude Code

Codex CLI

Aider

​검열되지 않은 모델

API 키 받기

2줄 마이그레이션

환경 변수

모델

기능 호환성

Venice 전용 기능

프레임워크

검열되지 않은 모델