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

# 从 OpenAI 迁移

> 只需更换 base URL 和 API 密钥，即可在几分钟内将兼容 OpenAI 的聊天、嵌入和图像应用迁移到 Venice —— 同一套 SDK，更高的隐私性。

Venice AI 是 OpenAI 的**直接替代品**。相同的 SDK、相同的代码 —— 只需更改两行。即可获得隐私优先的推理、无审查的模型和有竞争力的定价。

## 两行迁移

<CodeGroup>
  ```python Python theme={null}
  # 迁移前（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
  )
  ```

  ```javascript Node.js theme={null}
  // 迁移前（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",
  });
  ```

  ```bash cURL theme={null}
  # 迁移前
  curl https://api.openai.com/v1/chat/completions ...

  # 迁移后 —— 只需更改 URL 和密钥
  curl https://api.venice.ai/api/v1/chat/completions ...
  ```
</CodeGroup>

前往 [venice.ai/settings/api](https://venice.ai/settings/api) 生成密钥，或参阅 [API 密钥指南](/guides/getting-started/generating-api-key)。

### 环境变量

```bash theme={null}
# 迁移前
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
```

<Tip>
  许多库和工具会自动读取 `OPENAI_API_KEY` 和 `OPENAI_BASE_URL`。仅仅更新这些环境变量可能就已足够。部分工具仍然使用 `OPENAI_API_BASE` 表示相同的 URL。
</Tip>

## 模型

你可以传入 Venice 的模型 ID、诸如 `default` 或 `most_uncensored` 等 trait，或熟悉的 OpenAI 风格模型名称。Venice 会通过 [兼容性映射](/api-reference/endpoint/models/compatibility_mapping) 转换 OpenAI 名称。Trait 始终会解析为该角色当前对应的模型 —— 详见 [模型 traits](/api-reference/endpoint/models/traits)。

在 [文本模型](/models/text) 和 [定价](/overview/pricing) 页面查看实时目录。若需完整的首次请求演示，请参阅 [快速开始](/getting-started/quick-start)。

## 特性兼容性

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

如需使用兼容 OpenAI 端点之外的原生图像选项，请参阅 [图像生成](/guides/media/image-generation)。

## Venice 独有功能

通过 `extra_body` 以 `venice_parameters` 传入 Venice 专有选项。内置的 Web 搜索通常是最常见的额外参数：

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

同样的模式也适用于网页抓取、引用与 [Characters](/guides/features/characters)。如果客户端无法修改请求体，可以附加一个 [模型特性后缀](/api-reference/endpoint/chat/model_feature_suffix)，例如 `default:enable_web_search=auto`。

在兼容 OpenAI 的接口之外，Venice 还提供原生的 [视频](/guides/media/video-generation)、[音乐](/guides/media/music-and-sound-effects)、[网页检索](/guides/tools/web-retrieval) 和 [x402](/guides/integrations/x402-venice-api) API。

## 框架

大多数 AI 框架只需更改 base URL 即可与 Venice 协同工作：

<CardGroup cols={3}>
  <Card title="LangChain" icon="link" href="/guides/integrations/langchain">
    `ChatOpenAI` 中的 `base_url`
  </Card>

  <Card title="Vercel AI SDK" icon="link" href="/guides/integrations/vercel-ai-sdk">
    `createOpenAI` 中的 `baseURL`
  </Card>

  <Card title="LlamaIndex" icon="link" href="/guides/integrations/llamaindex">
    兼容 OpenAI 的客户端上的 `api_base`
  </Card>

  <Card title="CrewAI" icon="link" href="/guides/integrations/crewai">
    `OPENAI_API_BASE` 环境变量
  </Card>

  <Card title="PydanticAI" icon="link" href="/guides/integrations/pydanticai">
    使用 Venice base URL 的 OpenAI 兼容模型
  </Card>

  <Card title="Cursor" icon="link" href="/guides/integrations/cursor">
    设置中的自定义 API 端点
  </Card>

  <Card title="Claude Code" icon="link" href="/guides/integrations/claude-code">
    通过 Venice 路由 Claude Code
  </Card>

  <Card title="Codex CLI" icon="link" href="/guides/integrations/codex-cli">
    `config.toml` 中的模型提供方
  </Card>

  <Card title="Aider" icon="link" href="/guides/integrations/aider">
    `OPENAI_API_BASE` 环境变量
  </Card>
</CardGroup>

更多编码代理和工具已列在 [AI Agents](/guides/integrations/ai-agents) 页面。

## 无审查模型

Venice 的私有无审查模型没有任何内容过滤，适用于：

* 没有护栏的创意写作
* 安全研究和红队测试
* 没有拒答模式的诚实分析
* 没有额外免责声明的医学和法律信息

使用 `most_uncensored` trait，或从 [文本模型](/models/text) 页面选择当前的无审查模型 ID。

<Card title="获取你的 API 密钥" icon="key" href="https://venice.ai/settings/api">
  生成 Venice API 密钥，几分钟内开始迁移
</Card>