Skip to main content

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.

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]
​
source
string
required
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

OptionDescription
--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
--exportTạo một export sau khi dự án sẵn sàng
--downloadTạ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
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. 
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

OptionDescription
--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ụ: 
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>
​
projectId
string
required
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]
OptionDescription
--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ụ: 
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>]
Ví dụ: 
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
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ụ: 
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
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ì