> ## Documentation Index > Fetch the complete documentation index at: https://docs.youka.io/llms.txt > Use this file to discover all available pages before exploring further. # Dự án > Tạo, kiểm tra, chờ và chỉnh sửa các dự án karaoke đang thực hiện Một dự án là tài nguyên đang thực hiện cho một bản karaoke. Nó sở hữu media nguồn, lời đã đồng bộ, các stem đã tách, cài đặt render và các bản xuất (export) được tạo từ đó. ## `project create` Tạo một dự án mới từ tệp cục bộ hoặc một URL. ```bash theme={null} youka project create [options] ``` Một đường dẫn tệp cục bộ (`./song.mp3`) hoặc một URL HTTP/HTTPS (`https://example.com/song.mp4`). ### Options | Option | Description | | ------------------------------- | ------------------------------------------------------------------------- | | `--title ` | Tiêu đề dự án | | `--mode <mode>` | `none`, `transcribe`, hoặc `align` | | `--lyrics <text>` | Văn bản lời bài hát | | `--lang <code>` | Mã ngôn ngữ | | `--sync-model <model>` | Mô hình đồng bộ lời bài hát | | `--split-model <model>` | Mô hình tách stem | | `--max-video-quality <quality>` | Chất lượng video tối đa cho nguồn URL: `720p`, `1080p`, `4k`, hoặc `best` | | `--preset <presetId>` | Áp dụng một preset khi tạo dự án | | `--export` | Tạo một export sau khi dự án sẵn sàng | | `--download` | Tạo một export, chờ hoàn tất và tải xuống | | `--output <path>` | Đường dẫn đầu ra cho `--download` | ### Examples <CodeGroup> ```bash local-file theme={null} youka project create ./song.mp3 \ --title "My Song" \ --mode transcribe \ --lang en \ --wait \ --json ``` ```bash url theme={null} youka project create "https://example.com/song.mp4" \ --max-video-quality 4k \ --download \ --output ./karaoke.mp4 \ --json ``` ```bash align theme={null} youka project create ./song.mp3 \ --mode align \ --lyrics "$(cat lyrics.txt)" \ --sync-model audioshake-alignment \ --wait \ --json ``` </CodeGroup> Quy tắc: * Nếu bạn truyền lyrics và bỏ qua `--mode`, CLI mặc định là `align` * `align` yêu cầu lyrics * `transcribe` và `none` không chấp nhận lyrics * `--download` ngụ ý `--export` * `--max-video-quality` chỉ áp dụng cho nguồn URL HTTP/HTTPS. Mặc định là `1080p`, sử dụng chất lượng tốt nhất có sẵn nhưng không vượt quá giới hạn đó, và sẽ rơi về định dạng tốt nhất hiện có khi nền tảng không cung cấp stream có giới hạn chất lượng. ## `project list` Liệt kê tất cả dự án của tài khoản đã xác thực. ```bash theme={null} youka project list youka project list --json ``` ## `project quote` Ước tính số credit cần để tạo một dự án mà không tạo dự án. ```bash theme={null} youka project quote <source> [options] ``` `source` chấp nhận cùng dạng đường dẫn tệp cục bộ hoặc URL HTTP/HTTPS như `project create`. Nếu không có `--duration`, CLI sẽ tải nguồn lên để máy chủ có thể đo thời lượng media chính xác, nhưng sẽ không tạo dự án. ### Options | Option | Description | | ------------------------------- | ------------------------------------------------------------------------- | | `--title <title>` | Tiêu đề dự án | | `--mode <mode>` | `none`, `transcribe`, hoặc `align` | | `--lyrics <text>` | Văn bản lời bài hát cho `align` | | `--lang <code>` | Mã ngôn ngữ | | `--sync-model <model>` | Mô hình đồng bộ lời bài hát | | `--split-model <model>` | Mô hình tách stem | | `--max-video-quality <quality>` | Chất lượng video tối đa cho nguồn URL: `720p`, `1080p`, `4k`, hoặc `best` | | `--duration <seconds>` | Báo giá theo thời lượng đã biết mà không cần tải nguồn lên | Ví dụ: ```bash theme={null} youka project quote ./song.mp3 --mode transcribe --json youka project quote https://example.com/song.mp4 --max-video-quality 4k --mode transcribe --json youka project quote ./song.mp3 --duration 210 --mode none --json ``` ## `project show` Lấy trạng thái dự án hiện tại, bao gồm `state`, `pendingOperation` đã chuẩn hóa, stem, settings và exports. ```bash theme={null} youka project show <projectId> ``` <ParamField path="projectId" type="string" required> ID dự án được trả về bởi `project create`. </ParamField> ## `project wait` Thăm dò một dự án cho đến khi nó đạt trạng thái kết thúc. ```bash theme={null} youka project wait <projectId> --json ``` ## `project delete` Xóa một dự án và tất cả stem, lyrics và export liên quan. ```bash theme={null} youka project delete <projectId> --idempotency-key delete-<projectId> ``` <Warning> Việc xóa là vĩnh viễn. Truyền `--idempotency-key` để việc thử lại an toàn. </Warning> ## `project sync` Chạy lại phiên âm hoặc canh chỉnh lời bài hát trên một dự án hiện có. ```bash theme={null} youka project sync <projectId> [options] ``` | Option | Description | | ---------------------- | --------------------------- | | `--mode <mode>` | `transcribe` hoặc `align` | | `--text <text>` | Văn bản lời bài hát | | `--lang <code>` | Mã ngôn ngữ | | `--sync-model <model>` | Mô hình đồng bộ lời bài hát | Ví dụ: ```bash theme={null} youka project sync $PROJECT_ID \ --mode align \ --text "$(cat lyrics.txt)" \ --wait \ --json ``` ## `project separate` Chạy lại việc tách stem trên một dự án hiện có. ```bash theme={null} youka project separate <projectId> [--split-model <model>] ``` Ví dụ: ```bash theme={null} youka project separate $PROJECT_ID --split-model audioshakeai --wait --json ``` ## `project settings` Đọc hoặc cập nhật cài đặt dự án đang hoạt động. ```bash theme={null} youka project settings <projectId> youka project settings <projectId> --preset <presetId> --body ./settings.json ``` Nếu không có `--preset` cũng như `--body`, lệnh sẽ trả về cài đặt hiện tại. Nếu có một trong hai, lệnh sẽ thực hiện cập nhật. Ví dụ: <CodeGroup> ```bash show theme={null} youka project settings $PROJECT_ID --json ``` ```bash update theme={null} youka project settings $PROJECT_ID \ --preset preset_abc123 \ --body ./project-settings.json \ --json ``` </CodeGroup> ## `project stem list` Liệt kê các stem của một dự án. ```bash theme={null} youka project stem list <projectId> youka project stem list <projectId> --json ``` ## `project stem download` Tải xuống một hoặc nhiều tệp stem về đĩa. Stem được tải xuống theo định dạng được lưu trữ gốc; CLI không chuyển mã (transcode) chúng. ```bash theme={null} youka project stem download <projectId> <stemId> --output ./stems youka project stem download <projectId> --type instrumental --output ./stems youka project stem download <projectId> --type original --type backing-vocals --type vocals --output ./stems youka project stem download <projectId> --all --output ./stems ``` Các giá trị `--type` được hỗ trợ là `original`, `instrumental`, `vocals`, và `backing_vocals`. CLI cũng chấp nhận `backing-vocals`, `backingVocals`, và `backingvocals` như các tên thay thế. ## Tiếp theo là gì * [Exports](/vi/cli/exports) - render bản karaoke hoàn chỉnh * [Presets](/vi/cli/presets) - quản lý các cấu hình render có thể tái sử dụng * [Render settings reference](/en/render-settings-reference) - các trường preset và settings dùng chung