> ## Documentation Index
> Fetch the complete documentation index at: https://veniceai-docs-revamp.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# OpenAI에서 마이그레이션

> OpenAI에서 Venice AI로 몇 분 안에 전환 — 동일한 SDK, 더 강력한 개인정보 보호, 검열되지 않음

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

## 2줄 마이그레이션

### Python

```python theme={"dark"}
# Before (OpenAI)
from openai import OpenAI
client = OpenAI()

# After (Venice) — change api_key and base_url
from openai import OpenAI
client = OpenAI(
    api_key="your-venice-api-key",          # ← Change 1
    base_url="https://api.venice.ai/api/v1"  # ← Change 2
)
```

### Node.js

```javascript theme={"dark"}
// Before (OpenAI)
import OpenAI from 'openai';
const client = new OpenAI();

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

### cURL

```bash theme={"dark"}
# Before
curl https://api.openai.com/v1/chat/completions ...

# After — just change the URL and key
curl https://api.venice.ai/api/v1/chat/completions ...
```

### 환경 변수

```bash theme={"dark"}
# Before
OPENAI_API_KEY=sk-...
OPENAI_BASE_URL=https://api.openai.com/v1

# After
OPENAI_API_KEY=your-venice-api-key
OPENAI_BASE_URL=https://api.venice.ai/api/v1
```

<Tip>
  많은 라이브러리와 도구는 `OPENAI_API_KEY`와 `OPENAI_BASE_URL`을 자동으로 읽습니다. 이러한 환경 변수만 업데이트하면 충분할 수도 있습니다.
</Tip>

## 모델 매핑

| OpenAI 모델              | Venice 동등 모델                                   | 유형         | 가격 (입력/출력 per 1M) |
| ---------------------- | ---------------------------------------------- | ---------- | ----------------- |
| gpt-4o                 | `zai-org-glm-4.7` (Private)                    | Text       | $0.55 / $2.65     |
| gpt-4o                 | `openai-gpt-52` (Anonymized)                   | Text       | $2.19 / $17.50    |
| gpt-4o-mini            | `qwen3-4b`                                     | Text       | $0.05 / $0.15     |
| gpt-4-turbo            | `mistral-31-24b`                               | Text       | $0.50 / $2.00     |
| o1 / o3                | `qwen3-235b-a22b-thinking-2507` (Private)      | Reasoning  | $0.45 / $3.50     |
| o1 / o3                | `grok-41-fast` (Anonymized)                    | Reasoning  | $0.50 / $1.25     |
| gpt-4-vision           | `mistral-31-24b` or `qwen3-vl-235b-a22b`       | Vision     | $0.50 / $2.00     |
| text-embedding-3-small | `text-embedding-bge-m3`                        | Embeddings | $0.15 / $0.60     |
| dall-e-3               | `qwen-image` (Private, \$0.01) or `flux-2-pro` | Image      | From \$0.01       |
| whisper                | `nvidia/parakeet-tdt-0.6b-v3`                  | STT        | \$0.0001/sec      |
| tts-1                  | `tts-kokoro`                                   | TTS        | \$3.50/1M chars   |

## 기능 호환성

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

\*Venice는 또한 DALL-E에서 마이그레이션을 더 쉽게 하기 위해 `POST /images/generations`에서 OpenAI 호환 엔드포인트를 제공합니다. 추가 옵션이 있는 Venice의 네이티브 이미지 API는 [Image Generate](/api-reference/endpoint/image/generate)를 참조하세요.

## Venice 전용 기능

Venice는 OpenAI가 제공하지 않는 기능을 제공합니다:

### 1. 내장된 웹 검색

```python theme={"dark"}
response = client.chat.completions.create(
    model="venice-uncensored",
    messages=[{"role": "user", "content": "Latest AI news today"}],
    extra_body={
        "venice_parameters": {
            "enable_web_search": "auto"
        }
    }
)
```

### 2. 웹 스크래핑

```python theme={"dark"}
response = client.chat.completions.create(
    model="venice-uncensored",
    messages=[{"role": "user", "content": "Summarize https://example.com/article"}],
    extra_body={
        "venice_parameters": {
            "enable_web_scraping": True
        }
    }
)
```

### 3. Characters (AI 페르소나)

```python theme={"dark"}
response = client.chat.completions.create(
    model="venice-uncensored",
    messages=[{"role": "user", "content": "Tell me about yourself"}],
    extra_body={
        "venice_parameters": {
            "character_slug": "venice-ai"
        }
    }
)
```

### 4. 검열되지 않은 모델

Venice의 비공개 모델에는 콘텐츠 필터링이 없어 다음에 적합합니다:

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

### 5. 비디오 생성

```python theme={"dark"}
# Queue a video generation job
import requests

response = requests.post(
    "https://api.venice.ai/api/v1/video/queue",
    headers={"Authorization": f"Bearer {api_key}", "Content-Type": "application/json"},
    json={
        "model": "wan-2.6-text-to-video",
        "prompt": "A serene lake at sunset with gentle waves",
        "resolution": "720p",
        "duration": 5,
    }
)
job_id = response.json()["id"]
```

## 마이그레이션해야 하는 이유?

### 개인정보 보호

* 비공개 모델에 대한 **제로 데이터 보존** — 프롬프트는 절대 저장되지 않음
* **데이터로 훈련하지 않음** — 절대로
* OpenAI는 데이터를 30일 동안 보관하며 안전 연구에 사용할 수 있습니다

### 비용

* 비공개 모델은 OpenAI 동등 모델보다 **종종 더 저렴**합니다
* \$0.05/1M 입력의 `qwen3-4b`는 gpt-4o-mini보다 10배 저렴합니다
* $0.20/1M 입력의 `venice-uncensored` vs $2.50/1M의 gpt-4o

### 자유

* 검열되지 않은 모델에 대한 **콘텐츠 필터링 없음**
* 논란이 되는 사용 사례에 대한 계정 정지 없음
* 크립토 결제 옵션이 있는 Web3 네이티브
* 일일 크레딧을 위한 DIEM 스테이킹

### 모델 다양성

* 여러 제공자의 모델에 액세스 (Qwen, Llama, Mistral, Gemma, Claude, GPT, Grok 등)
* 요청별로 비공개 및 익명화된 모델 사이를 전환
* 새로운 모델이 정기적으로 추가됨

## 프레임워크 마이그레이션

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

| 프레임워크         | 필요한 변경 사항                         |
| ------------- | --------------------------------- |
| LangChain     | `ChatOpenAI`의 `base_url`          |
| Vercel AI SDK | `createOpenAI`의 `baseURL`         |
| CrewAI        | `OPENAI_API_BASE` 환경 변수           |
| LlamaIndex    | `OpenAI`의 `api_base`              |
| AutoGen       | config의 `base_url`                |
| Haystack      | `OpenAIGenerator`의 `api_base_url` |
| Claude Code   | `--api-base` 플래그 또는 환경 변수         |
| Cursor        | 설정의 사용자 지정 API 엔드포인트              |
| Continue.dev  | config.json의 `apiBase`            |

<Card title="API 키 받기" icon="key" href="https://venice.ai/settings/api">
  Venice API 키를 생성하고 몇 분 안에 마이그레이션을 시작하세요
</Card>