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

# Connector và API key

> Kết nối ElevenLabs, OpenRouter, Vbee, Epidemic Sound và Freesound bằng key của riêng bạn.

Connector nối CoClip với các dịch vụ online bằng tài khoản của riêng bạn. Chúng nằm ở **Settings** → **Connectors**. Mọi connector đều không bắt buộc: CoClip vẫn chỉnh sửa và xuất video khi không có chúng.

Mỗi connector có một thẻ. Đầu thẻ hiện **Connected**, **Not set up** hoặc **Re-enter key**.

Ảnh minh hoạ sẽ được bổ sung

Settings → Connectors
Trạng thái: Thẻ ElevenLabs đang mở, đã lưu key
Làm nổi bật: Ô API key và nút Test connection

## Mỗi connector mở thêm gì

| Connector | Thêm tính năng | Bạn cần | Lấy ở đâu |
| - | - | - | - |
| **ElevenLabs** | **Generate voice** (chuyển văn bản thành giọng nói), engine tạo transcript thứ hai, tạo nhạc và hiệu ứng âm thanh | API key | elevenlabs.io → Developers → API keys |
| **OpenRouter** | **Generate** ảnh và video ngắn từ prompt | API key | openrouter.ai → Keys |
| **Vbee** | Giọng đọc tiếng Việt | Token và App ID | vbee.vn → API: tạo một app, rồi sao chép token và App ID |
| **Epidemic Sound** | Tìm và chèn hiệu ứng âm thanh từ gói đăng ký của bạn | Personal API key | [epidemicsound.com/account/api-keys](https://www.epidemicsound.com/account/api-keys) |
| **Freesound** | Tìm và chèn hiệu ứng âm thanh miễn phí (chỉ CC0 và CC BY) | Client ID, client secret và đăng nhập | [freesound.org/apiv2/apply](https://freesound.org/apiv2/apply/) |

Mỗi dịch vụ tính phí trực tiếp với bạn. Những gì bạn tạo hoặc tải về được trừ vào tài khoản của bạn ở dịch vụ đó.

## Thêm key

**1. Mở connector**

Mở **Settings** → **Connectors** và mở rộng thẻ của dịch vụ.

**2. Dán key**

Dán key vào ô **API key** (Vbee: **Token** và **App ID**) rồi bấm **Save**.

**3. Kiểm tra**

Bấm **Test connection**. Dấu ✓ nghĩa là dịch vụ đã chấp nhận key.

Thẻ giờ hiện **Connected** và `Configured ✓ ••••` kèm 4 ký tự cuối của key. Để thay key, dán key mới rồi bấm **Save**. Để xoá, bấm **Remove**.

## Tuỳ chọn ElevenLabs

* **Test connection** kiểm tra **Text to speech** và **Speech to text**, rồi hiện số ký tự bạn đã dùng và ngày reset.
* **Defaults**: giọng đọc (tìm và nghe thử), **Model**, **Language** (English hoặc Vietnamese), **Format** và **Trim silence around generated speech**. Eleven v4 là model mặc định; Flash v2.5 tốn một nửa credit. **WAV lossless** cần gói trả phí của ElevenLabs.
* Thanh trượt **Stability**, **Similarity**, **Style** và **Speed**.
* **Music under the voice**: nhạc được tạo mà chưa đặt âm lượng sẽ nhỏ hơn giọng đọc bao nhiêu khi giọng đang nói (6–30 LU, mặc định 16).
* **Ask before spending**: **Ask before jobs over** một số credit, và **Ask before transcribing over** một số phút. Áp dụng cho agent và panel script.

## Tuỳ chọn OpenRouter

* **Test connection** hiện `Images and videos work` và số credit còn lại.
* **Default image model** và **Default video model** chọn sẵn model trong **Generate**. Xem [Media và tạo bằng AI](/docs/vi/library/media-and-generate.md).

## Tuỳ chọn Vbee

* **Default voice** và **Speed** (0.8× đến 1.3×).
* **Trim silence around generated speech**.
* **Use Vbee for text to speech by default**: yêu cầu không ghi rõ nhà cung cấp sẽ dùng Vbee, kể cả yêu cầu của agent.

Vbee không trả về thời điểm của từng từ. CoClip tự căn thời gian từng từ bằng nhận dạng giọng nói ngay trên máy bạn, để làm phụ đề và cắt gọt.

## Từ điển phát âm

Thẻ ElevenLabs và Vbee có mục **Pronunciation dictionaries**. Dùng khi giọng đọc đọc sai một từ.

1. Bấm **New dictionary**, đặt tên, rồi thêm các dòng **Word** → **Say as**. Ví dụ: Google → Gu-gồ.
2. Bấm **Create dictionary**. Sau này dùng **Add rule** để thêm dòng.
3. Đánh dấu tối đa 3 từ điển để dùng cho mọi lần tạo giọng.

Phụ đề vẫn giữ từ gốc. Với ElevenLabs, **Advanced (IPA)** thêm quy tắc phiên âm, chỉ dùng được với eleven\_v4, flash\_v2 và v3. Từ điển Vbee được lưu trên máy bạn.

## Epidemic Sound và Freesound

**Epidemic Sound**: dán personal API key rồi bấm **Save**. Âm thanh bạn chèn được tải bằng key của bạn và tính vào gói đăng ký Epidemic Sound.

**Freesound** cần API credential miễn phí của riêng bạn và một lần đăng nhập:

**1. Tạo credential**

Tạo một API credential miễn phí trên Freesound. Giữ đúng **Callback URL** hiện trong thẻ cho credential đó.

**2. Dán credential**

Dán **Client ID** và **Client secret** vào thẻ và lưu từng ô.

**3. Đăng nhập**

Bấm **Sign in with Freesound**. Muốn đăng nhập bằng trình duyệt, mở **Sign in in your browser instead**, bấm **Copy sign-in link**, mở link đó, rồi dán mã Freesound hiện ra và bấm **Sign in**.

Tìm kiếm và nghe thử dùng được trước khi đăng nhập. Muốn chèn âm thanh thì cần đăng nhập. CoClip chỉ liệt kê âm thanh CC0 và CC BY; âm thanh CC BY cần ghi công tác giả ở nơi bạn đăng video. Bạn đồng ý với điều khoản API của Freesound, có link trong thẻ. Xem [Hiệu ứng âm thanh](/docs/vi/library/sound-effects.md).

## CoClip giữ key của bạn thế nào

* Key được mã hoá và lưu trên máy bạn: bằng Windows DPAPI, hoặc trong mục Keychain "CoClip Safe Storage" trên macOS.
* CoClip chỉ hiện 4 ký tự cuối của key đã lưu.
* Key không bao giờ được lưu trong dự án, nên chia sẻ thư mục dự án không làm lộ key.
* CoClip chỉ dùng key để gọi đúng dịch vụ đó. Key không bao giờ được gửi tới SilaFlow.
* Agent không bao giờ thấy key và không cần key. Chỉ nhập key ở **Settings** → **Connectors**, không bao giờ dán vào khung chat với agent.

Văn bản, audio, prompt và ảnh bạn gửi tới một dịch vụ sẽ được dịch vụ đó xử lý.

Nếu thẻ hiện **Re-enter key**, xem [Khắc phục sự cố](/docs/vi/reference/troubleshooting.md).

## Trang liên quan

* [Cài đặt](/docs/vi/reference/settings.md)
* [Script](/docs/vi/library/script.md)
* [Media và tạo bằng AI](/docs/vi/library/media-and-generate.md)
* [Hiệu ứng âm thanh](/docs/vi/library/sound-effects.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.