Dự á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.

youka project create <source> [options]

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

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

youka project create "https://example.com/song.mp4" \
  --max-video-quality 4k \
  --download \
  --output ./karaoke.mp4 \
  --json

youka project create ./song.mp3 \
  --mode align \
  --lyrics "$(cat lyrics.txt)" \
  --sync-model audioshake-alignment \
  --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

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ụ:

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>

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]

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ụ:

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

youka project settings $PROJECT_ID \
  --preset preset_abc123 \
  --body ./project-settings.json \
  --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ì

Exports - render bản karaoke hoàn chỉnh
Presets - quản lý các cấu hình render có thể tái sử dụng
Render settings reference - các trường preset và settings dùng chung

Overview

How To

Customization

Audio

Settings

Exporting

Account

`project create`

Options

Examples

`project list`

`project quote`

Options

`project show`

`project wait`

`project delete`

`project sync`

`project separate`

`project settings`

`project stem list`

`project stem download`

Tiếp theo là gì

​project create

​Options

​Examples

​project list

​project quote

​Options

​project show

​project wait

​project delete

​project sync

​project separate

​project settings

​project stem list

​project stem download

​Tiếp theo là gì

`project create`

Options

Examples

`project list`

`project quote`

Options

`project show`

`project wait`

`project delete`

`project sync`

`project separate`

`project settings`

`project stem list`

`project stem download`

Tiếp theo là gì