> ## 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、相同的代码 —— 只需更改两行。即可获得隐私优先的推理、无审查的模型和有竞争力的定价。

## 两行迁移

### 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 对应                                  | 类型         | 定价（每 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` 或 `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）或 `flux-2-pro` | Image      | 自 \$0.01 起     |
| whisper                | `nvidia/parakeet-tdt-0.6b-v3`              | STT        | \$0.0001/秒     |
| tts-1                  | `tts-kokoro`                               | TTS        | \$3.50/1M 字符   |

## 特性兼容性

| 特性                | OpenAI | Venice | 说明                                   |
| ----------------- | ------ | ------ | ------------------------------------ |
| Chat Completions  | ✅      | ✅      | 完全兼容                                 |
| Streaming         | ✅      | ✅      | SSE 格式相同                             |
| Function Calling  | ✅      | ✅      | 相同的 `tools` 参数                       |
| Structured Output | ✅      | ✅      | 相同的 `response_format`                |
| Vision            | ✅      | ✅      | 相同的 content 数组格式                     |
| Embeddings        | ✅      | ✅      | 相同 API                               |
| Image Generation  | ✅      | ✅      | 通过 `/images/generations` 兼容 OpenAI\* |
| TTS               | ✅      | ✅      | 兼容                                   |
| STT               | ✅      | ✅      | 兼容                                   |
| Assistants API    | ✅      | ❌      | 改用 Characters 或 Minds                |
| Batch API         | ✅      | ❌      | 暂不可用                                 |
| Fine-tuning       | ✅      | ❌      | 不可用                                  |

\*Venice 还在 `POST /images/generations` 提供了 OpenAI 兼容端点，便于从 DALL-E 迁移。如需使用 Venice 原生图像 API 及其额外选项，请参阅 [Image Generate](/api-reference/endpoint/image/generate)。

## Venice 独有功能

Venice 提供 OpenAI 没有的能力：

### 1. 内置 Web 搜索

```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. Web 抓取

```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"]
```

## 为什么迁移？

### 隐私

* 私有模型上**零数据保留** —— 您的 prompt 永远不会被存储
* **绝不**用您的数据进行训练
* OpenAI 保留数据 30 天，并可能用于安全研究

### 成本

* 私有模型**通常比** OpenAI 等价模型**更便宜**
* `qwen3-4b` 输入 \$0.05/1M 比 gpt-4o-mini 便宜 10 倍
* `venice-uncensored` 输入 $0.20/1M vs gpt-4o $2.50/1M

### 自由

* 无审查模型上**没有内容过滤**
* 不会因有争议的用例被暂停账户
* 原生支持 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       | 配置中的 `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>