> ## 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에서 마이그레이션

> 베이스 URL과 API 키만 바꿔서 OpenAI 호환 채팅, 임베딩, 이미지 앱을 몇 분 만에 Venice로 옮기세요 — 동일한 SDK, 더 강력한 프라이버시.

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

## 2줄 마이그레이션

<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`을 자동으로 읽습니다. 이러한 환경 변수만 업데이트하면 충분할 수 있습니다. 일부 도구는 동일한 URL에 대해 여전히 `OPENAI_API_BASE`를 사용합니다.
</Tip>

## 모델

Venice 모델 ID, `default`나 `most_uncensored`와 같은 특성(trait), 또는 익숙한 OpenAI 스타일 이름을 전달할 수 있습니다. Venice는 [호환성 매핑](/api-reference/endpoint/models/compatibility_mapping)을 통해 OpenAI 이름을 매핑합니다. 특성은 항상 해당 역할의 현재 모델로 해석됩니다 — [모델 특성](/api-reference/endpoint/models/traits)을 참조하세요.

실시간 카탈로그는 [텍스트 모델](/models/text)과 [가격](/overview/pricing)에서 확인하세요. 첫 요청 안내는 [퀵스타트](/getting-started/quick-start)를 참조하세요.

## 기능 호환성

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

OpenAI 호환 엔드포인트 외의 네이티브 이미지 옵션은 [이미지 생성](/guides/media/image-generation)을 참조하세요.

## Venice 전용 기능

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

```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)에도 적용됩니다. 클라이언트가 요청 본문을 변경할 수 없다면 `default:enable_web_search=auto`와 같은 [모델 기능 접미사](/api-reference/endpoint/chat/model_feature_suffix)를 추가하세요.

Venice는 OpenAI 호환 인터페이스와 함께 네이티브 [비디오](/guides/media/video-generation), [음악](/guides/media/music-and-sound-effects), [웹 검색](/guides/tools/web-retrieval), [x402](/guides/integrations/x402-venice-api) API도 제공합니다.

## 프레임워크

대부분의 AI 프레임워크는 베이스 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 베이스 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">
    Claude Code를 Venice로 라우팅
  </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 에이전트](/guides/integrations/ai-agents)에서 확인할 수 있습니다.

## 검열되지 않은 모델

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

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

`most_uncensored` 특성이나 [텍스트 모델](/models/text)의 현재 검열되지 않은 모델 ID를 사용하세요.

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