Chuyển đến nội dung chính
Youka có một máy chủ MCP. MCP (Model Context Protocol) là cách tiêu chuẩn để các trợ lý AI kết nối với công cụ bên ngoài. Khi bạn kết nối xong, bạn có thể yêu cầu trợ lý những việc như “tạo một video karaoke từ ~/Music/song.mp3” và nó sẽ tạo dự án trong tài khoản Youka của bạn, chờ hoàn tất, rồi cung cấp link trình chỉnh sửa hoặc link tải xuống. Máy chủ hoạt động với bất kỳ client MCP nào hỗ trợ máy chủ remote (Streamable HTTP) với header tuỳ chỉnh, như Claude Code, Cursor và Codex.
Ứng dụng Youka chính thức cho ChatGPT và Claude sẽ sớm ra mắt. Trước mắt, hãy dùng một client trên trang này cùng với Youka API key.

Những gì bạn cần

Thông tin máy chủ:
API key của bạn cho phép truy cập đầy đủ vào tài khoản Youka và credits của bạn. Hãy giữ nó خارج các tệp và kho mã dùng chung. Nếu key bị lộ, hãy xoá nó trên trang tài khoản và tạo key mới.

Kết nối trợ lý của bạn

Chạy lệnh sau trong terminal, thay YOUR_API_KEY bằng key của bạn:
Kiểm tra xem đã kết nối chưa:
Bạn sẽ thấy youka: https://mcp.youka.io/mcp (HTTP) - ✔ Connected.Mặc định, máy chủ chỉ được thêm cho thư mục hiện tại. Thêm --scope user để dùng Youka trong mọi thư mục.

Thử ngay

Hãy hỏi trợ lý bằng ngôn ngữ tự nhiên. Ví dụ:
Một yêu cầu karaoke điển hình sẽ diễn ra như sau:
1

Tải lên

Trợ lý yêu cầu Youka cung cấp link tải lên và tải tệp của bạn lên. Việc tải lên là miễn phí.
2

Kiểm tra chi phí

Nó kiểm tra dự án sẽ dùng bao nhiêu credits và so sánh với số dư của bạn.
3

Tạo dự án

Youka loại bỏ giọng hát và canh đồng bộ lời. Việc này mất vài phút. Trợ lý kiểm tra trạng thái cho đến khi dự án sẵn sàng.
4

Chỉnh sửa hoặc xuất

Bạn nhận được một link để mở dự án trong trình chỉnh sửa Youka. Nếu bạn yêu cầu tệp video, trợ lý sẽ xuất và cung cấp cho bạn link tải xuống.
Việc tạo dự án không tự render video. Bạn quyết định khi nào xuất, để có thể sửa lời hoặc phong cách trước, είτε trong chat hoặc trong Youka editor.

Trợ lý có thể làm gì

Credits và an toàn

  • Cùng credits như web app. Tạo dự án, đồng bộ lại lời và export có chi phí giống như trên online.youka.io.
  • Chi phí được kiểm tra trước. Nếu bạn không đủ credits, Youka sẽ từ chối yêu cầu và thông báo rõ. Không có khoản nào bị trừ.
  • Không bị tính phí hai lần. Nếu trợ lý thử lại yêu cầu sau khi bị timeout, Youka nhận diện lần thử lại và trả về kết quả ban đầu thay vì tính phí lần nữa.
  • Credits được mua trên Youka. Trợ lý không thể mua credits. Để nạp thêm, xem Buy more credits.
  • Các tác vụ mất phí chỉ chạy khi bạn yêu cầu. Trợ lý chỉ được hướng dẫn tạo dự án, đồng bộ lời hoặc export khi bạn yêu cầu.

Khắc phục sự cố

API key bị thiếu hoặc không hợp lệ. Hãy kiểm tra header có đúng chính xác Authorization: Bearer yk_..., với đúng một dấu cách sau Bearer và không có dấu cách thừa hoặc dấu ngoặc kép trong key. Nếu bạn đã xoá key trên trang tài khoản, hãy tạo key mới và cập nhật client của bạn. Với thiết lập Codex và Cursor đọc YOUKA_API_KEY, hãy đảm bảo biến đã được đặt trong môi trường mà ứng dụng được khởi chạy từ đó.
Hãy hỏi trợ lý về số dư, hoặc kiểm tra trên online.youka.io. Sau đó buy more credits và thử lại.
Hãy yêu cầu trợ lý hiển thị dự án. Nó sẽ bao gồm lỗi. Hãy đảm bảo tệp là định dạng audio hoặc video được hỗ trợ và nằm trong giới hạn tải lên hiển thị bởi tài khoản của bạn.
Hãy nói cho trợ lý lời đúng và yêu cầu đồng bộ lại, hoặc mở link trình chỉnh sửa và tự edit the lyrics. Sau đó export lại.

Tài liệu liên quan