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 채팅 및 임베딩 모델 이름을 매핑합니다. 오디오를 포함한 그 외 엔드포인트에는 Venice 모델 ID를 사용해야 합니다. 특성은 항상 해당 역할의 현재 모델로 해석됩니다. 자세한 내용은 모델 특성을 참조하세요. 실시간 카탈로그는 텍스트 모델과 가격에서 확인하세요. 첫 요청 안내는 퀵스타트를 참조하세요.

기능 호환성

기능	OpenAI	Venice	참고
Chat Completions	✅	✅	호환. `logit_bias`, `service_tier` 같은 OpenAI 전용 필드를 포함해 알 수 없는 최상위 필드는 HTTP 400을 반환합니다
스트리밍	✅	✅	동일한 SSE 형식에 마지막 usage 청크가 추가됩니다. 스트리밍 형식을 참조하세요
Function Calling	✅	✅	동일한 `tools` 매개변수
구조화된 출력	✅	✅	동일한 `response_format`
Vision	✅	✅	동일한 content 배열 형식
Embeddings	✅	✅	텍스트만 지원; 토큰 배열은 HTTP 400 반환
이미지 생성	✅	✅	`/images/generations`를 통한 OpenAI 호환
이미지 편집	✅	❌	`/images/edits` 엔드포인트 없음. 네이티브 `/image/edit` 엔드포인트를 사용하세요
TTS	✅	✅	요청 형식은 호환되며, Venice 모델 ID를 사용하세요(OpenAI 오디오 모델 이름은 HTTP 400을 반환합니다)
STT	✅	✅	요청 형식은 호환되며, Venice 모델 ID를 사용하세요. `response_format`은 `json` 또는 `text`만 지원합니다. `/audio/translations`는 지원하지 않습니다
Responses API	✅	✅	베타. OpenAI 모델은 네이티브, 그 외 모델은 변환 방식으로 처리됩니다. 제한 사항을 참조하세요
Assistants API	✅	❌	Characters 또는 function calling을 사용하세요
Batch API	✅	❌	아직 사용 불가
Fine-tuning	✅	❌	사용 불가

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

스트리밍 형식

Chat Completions 스트림은 OpenAI 청크 형식을 사용하며 data: [DONE]으로 끝납니다. 두 가지 세부 사항이 다릅니다:

Usage 청크. stream_options.include_usage가 false인 경우에도 모든 스트림은 [DONE] 전에 usage 청크로 끝납니다. 이 청크의 choices 배열은 비어 있으며 usage와 cost 객체를 담고 있습니다. 모든 청크에서 choices[0]을 읽는 클라이언트는 choices가 없는 청크를 건너뛰어야 합니다.
스트림 시작 후 오류. HTTP 상태는 이미 200이므로 오류는 error 객체(message, type, code)를 담은 data: 이벤트로 전달되고, 그 뒤에 data: [DONE]이 이어집니다. 모델이 과부하 상태일 때는 객체에 초 단위의 retry_after도 포함됩니다.

data: {"error":{"message":"...","type":"server_error","code":"...","param":null}}

data: [DONE]

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"
        }
    },
)

venice_parameters 안의 알 수 없는 키는 거부되지 않고 무시되므로, 각 키의 철자를 API 레퍼런스와 대조해 확인하세요. 동일한 패턴이 웹 스크래핑, 인용, Characters에도 적용됩니다. 클라이언트가 요청 본문을 변경할 수 없다면 default:enable_web_search=auto와 같은 모델 기능 접미사를 추가하세요. Venice는 OpenAI 호환 인터페이스와 함께 네이티브 비디오, 음악, 웹 검색, x402 API도 제공합니다.

프레임워크

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

LangChain

ChatOpenAI의 base_url; OpenAIEmbeddings의 check_embedding_ctx_length=False

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 전용 기능

프레임워크

검열되지 않은 모델