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.
youka project create <source> [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 <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
youka project create ./song.mp3 \
--title "My Song" \
--mode transcribe \
--lang en \
--wait \
--json
- Nếu bạn truyền lyrics và bỏ qua
--mode, CLI mặc định là align
align yêu cầu lyricstranscribe 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.
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.
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 |
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.
youka project show <projectId>
ID dự án được trả về bởi project create.
project wait
Thăm dò một dự án cho đến khi nó đạt trạng thái kết thúc.
youka project wait <projectId> --json
project delete
Xóa một dự án và tất cả stem, lyrics và export liên quan.
youka project delete <projectId> --idempotency-key delete-<projectId>
Việc xóa là vĩnh viễn. Truyền --idempotency-key để việc thử lại an toàn.
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ó.
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 |
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ó.
youka project separate <projectId> [--split-model <model>]
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.
youka project settings <projectId>
youka project settings <projectId> --preset <presetId> --body ./settings.json
--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ụ:
youka project settings $PROJECT_ID --json
project stem list
Liệt kê các stem của một dự án.
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.
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
--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ì
