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

# Venice CLI

> 공식 Venice 명령줄 인터페이스는 채팅, 웹 검색, 이미지 생성, TTS, 전사, 비디오, 임베딩을 선택적 종단 간 암호화와 함께 터미널로 제공합니다.

[Venice CLI](https://github.com/veniceai/venice-cli)는 Venice를 위한 공식 명령줄 인터페이스입니다. AI 모델과 채팅하고, 이미지를 생성하고, 텍스트를 음성으로 변환하고, 오디오를 전사하고, 비디오를 생성하는 등 모든 작업을 선택적 종단 간 암호화와 함께 터미널에서 수행할 수 있습니다.

<Card title="GitHub: veniceai/venice-cli" icon="github" href="https://github.com/veniceai/venice-cli">
  npm에는 [`veniceai-cli`](https://www.npmjs.com/package/veniceai-cli)로 게시되어 있습니다. MIT 라이선스.
</Card>

<CardGroup cols={3}>
  <Card title="프라이버시 우선" icon="lock">
    선택적 E2EE 및 TEE 증명. 텔레메트리 없음, 브라우저 추적 없음.
  </Card>

  <Card title="모든 모달리티" icon="layer-group">
    Chat, search, image, upscale, TTS, transcription, video, embeddings
  </Card>

  <Card title="스크립팅 친화적" icon="terminal">
    JSON 및 raw 출력, stdin 파이핑, bash, zsh, fish용 셸 자동 완성
  </Card>
</CardGroup>

## 빠른 시작

<Steps>
  <Step title="CLI 설치">
    npm으로 전역 설치:

    ```bash theme={"system"}
    npm install -g veniceai-cli
    ```

    또는 설치 없이 바로 실행:

    ```bash theme={"system"}
    npx veniceai-cli chat 'Hello, world!'
    ```
  </Step>

  <Step title="Venice API 키 발급">
    [venice.ai/settings/api](https://venice.ai/settings/api)에서 발급받으세요. 단계별 안내는 [API 키 가이드](/guides/getting-started/generating-api-key)를 참고하세요.
  </Step>

  <Step title="키 구성">
    대화형 설정을 실행하고 프롬프트가 표시되면 키를 붙여넣으세요. 이렇게 하면 셸 히스토리나 프로세스 목록에 키가 노출되지 않습니다:

    ```bash theme={"system"}
    venice config init
    ```

    또는 환경 변수를 사용하세요:

    ```bash theme={"system"}
    export VENICE_API_KEY=YOUR_API_KEY
    ```
  </Step>

  <Step title="채팅 시작">
    ```bash theme={"system"}
    venice chat "What is the meaning of life?"
    ```
  </Step>
</Steps>

<Note>
  Node.js 18.0.0 이상이 필요합니다. `VENICE_API_KEY`는 구성 파일에 저장된 값보다 우선합니다.
</Note>

## 명령어

| 명령어                                   | 기능                                        |
| ------------------------------------- | ----------------------------------------- |
| `venice chat <prompt>`                | 도구, 캐릭터, 스트리밍을 지원하는 모든 Venice 텍스트 모델과의 채팅 |
| `venice search <query>`               | AI 합성과 선택적 인용을 갖춘 웹 검색                    |
| `venice image <prompt>`               | 텍스트 프롬프트로 이미지 생성                          |
| `venice upscale <file>`               | 기존 이미지를 최대 4×까지 업스케일                      |
| `venice tts <text>`                   | 35개 이상의 음성을 지원하는 text-to-speech           |
| `venice transcribe <file>`            | 선택적 타임스탬프가 포함된 speech-to-text             |
| `venice video <subcommand>`           | AI 생성 비디오를 큐 등록, 폴링, 다운로드                 |
| `venice embeddings <text>`            | 임베딩 벡터 생성                                 |
| `venice models`                       | 실시간 모델 카탈로그 목록 및 필터링                      |
| `venice tee <subcommand>`             | TEE 증명 조회 및 검증                            |
| `venice config <subcommand>`          | API 키 및 기본값 관리                            |
| `venice history <subcommand>`         | 대화 목록, 조회, 내보내기, 삭제                       |
| `venice usage`                        | 시간 경과에 따른 토큰 사용량 표시                       |
| `venice characters` / `venice voices` | 내장 페르소나 및 TTS 음성 목록                       |
| `venice completions <shell>`          | 셸 자동 완성 생성                                |

### Chat

```bash theme={"system"}
# Basic chat
venice chat "Explain quantum computing in simple terms"

# Use a specific model and system prompt
venice chat -m deepseek-v3.2 -s "You are a helpful coding assistant" "Write fizzbuzz in Python"

# Continue the previous conversation
venice chat --continue "What about the next step?"

# Function calling with built-in tools
venice chat -t calculator,datetime "What's 25 * 4.5, and what day is it?"

# JSON output for scripting
venice chat -f json "List 3 colors" | jq '.content'
```

주요 chat 옵션:

| 옵션                       | 설명                                          |
| ------------------------ | ------------------------------------------- |
| `-m, --model <model>`    | 사용할 모델 (기본값: `kimi-k2-5`)                   |
| `-s, --system <prompt>`  | 시스템 프롬프트                                    |
| `-c, --character <name>` | 캐릭터 페르소나                                    |
| `-t, --tools <tools>`    | 내장 도구의 쉼표 구분 목록                             |
| `--continue`             | 마지막 대화 계속                                   |
| `--web-search`           | 최신 정보를 위한 웹 검색 활성화                          |
| `--no-stream`            | 스트리밍 출력 비활성화                                |
| `-f, --format <format>`  | 출력 형식 (`pretty`, `json`, `markdown`, `raw`) |
| `--e2ee` / `--no-e2ee`   | 종단 간 암호화 강제 또는 비활성화                         |
| `--tee-verify`           | TEE 증명 세부 정보 표시                             |
| `-q, --quiet`            | E2EE/TEE 상태 메시지 숨김                          |

### 웹 검색

```bash theme={"system"}
venice search "Latest developments in fusion energy"
venice search -n 10 --citations "Best practices for TypeScript"
venice search --scrape "Company research on Anthropic"
```

### 이미지 생성 및 업스케일

```bash theme={"system"}
# Generate and save an image
venice image -o sunset.png "A serene mountain lake at sunset"

# Custom dimensions and model
venice image -w 1024 -h 768 -m flux-1-dev "Landscape photograph"

# Upscale an existing image 4×
venice upscale photo.jpg -s 4 -o photo_4x.jpg
```

### Text-to-speech 및 전사

```bash theme={"system"}
# Speak with a specific voice
venice tts -v bf_emma -o greeting.mp3 "Good morning, everyone!"

# Pipe text in from stdin
echo "Text to speak" | venice tts -o output.mp3

# Transcribe audio with timestamps
venice transcribe -t recording.mp3

# Choose a model and language hint
venice transcribe -m openai/whisper-large-v3 -l es spanish_audio.mp3
```

### 비디오 생성

비디오 생성은 비동기(큐 기반)입니다.

```bash theme={"system"}
# Queue a text-to-video generation
venice video generate -m veo3-fast-text-to-video "Cinematic sunset over mountains"

# Image-to-video with a reference image
venice video generate -m wan-2.6-image-to-video -i photo.jpg "The scene comes alive"

# Poll until done, then download
venice video status -w <queue_id>
venice video retrieve <queue_id> -o my_video.mp4

# List available video models
venice video models
```

### 모델 및 임베딩

```bash theme={"system"}
# List and filter the catalog
venice models -t image
venice models --privacy
venice models --e2ee

# Generate embeddings
venice embeddings -o vectors.json "Text to embed"
```

### 구성

```bash theme={"system"}
# Interactive setup
venice config init

# Set and inspect values
venice config set default_model kimi-k2-5
venice config get default_model
venice config show
venice config path
```

| 키                     | 설명             |
| --------------------- | -------------- |
| `api_key`             | Venice API 키   |
| `default_model`       | 기본 chat 모델     |
| `default_image_model` | 기본 이미지 생성 모델   |
| `default_voice`       | 기본 TTS 음성      |
| `output_format`       | 기본 출력 형식       |
| `show_usage`          | 요청 후 토큰 사용량 표시 |

## 프라이버시: E2EE와 TEE

Venice CLI는 프라이버시를 위해 설계되었습니다. 텔레메트리를 전혀 전송하지 않고, API 키를 제한된 권한으로 로컬에 저장하며, Venice의 기밀 컴퓨트 모델을 지원합니다.

* **종단 간 암호화(E2EE)**: 메시지는 클라이언트 측에서 암호화되어 TEE 내부에서만 복호화되므로 Venice가 사용자 데이터를 읽을 수 없습니다. 모델이 해당 기능을 광고할 경우 CLI는 자동으로 E2EE를 활성화하고, 세션당 임시 키 쌍(ECDH + AES-GCM)을 생성합니다.
* **TEE 증명**: 데이터를 전송하기 전에 모델이 보안 엔클레이브에서 실행되고 있는지 암호학적으로 검증합니다.

```bash theme={"system"}
# Discover confidential-compute models
venice models --e2ee
venice models --tee

# Chat with E2EE (auto-enabled for capable models)
venice chat -m <e2ee-capable-model> "Your private message here"

# TEE-only mode: verify attestation without encryption
venice chat -m <e2ee-capable-model> --no-e2ee "TEE verified, not encrypted"

# Fetch and verify attestation directly
venice tee attestation <model>
venice tee verify <model>
```

<Note>
  E2EE 모드는 종단 간 암호화를 보장하기 위해 도구와 웹 검색을 비활성화합니다.
</Note>

## 출력 형식

| 형식         | 사용 사례                            |
| ---------- | -------------------------------- |
| `pretty`   | 대화형 사용을 위한 색상 및 서식이 적용된 출력 (기본값) |
| `json`     | 스크립팅과 파이핑을 위한 기계 판독 가능한 JSON     |
| `markdown` | 문서화를 위한 마크다운 형식 출력               |
| `raw`      | 파이프용, 장식 없는 일반 텍스트               |

CLI는 출력이 파이핑될 때를 자동으로 감지하고 `raw`로 전환합니다.

```bash theme={"system"}
venice chat -f json "List items" | jq '.'
venice chat "Generate code" | pbcopy
```

## 리소스

<CardGroup cols={2}>
  <Card title="GitHub" icon="github" href="https://github.com/veniceai/venice-cli">
    소스 코드, 이슈, 릴리스
  </Card>

  <Card title="npm" icon="npm" href="https://www.npmjs.com/package/veniceai-cli">
    `veniceai-cli`
  </Card>

  <Card title="Venice MCP 서버" icon="plug" href="/guides/integrations/venice-mcp">
    동일한 Venice 도구를 모든 MCP 호스트에 노출
  </Card>

  <Card title="Venice API 레퍼런스" icon="book" href="/api-reference/api-spec">
    전체 엔드포인트 및 파라미터 문서
  </Card>
</CardGroup>