Khởi động nhanh Raw HTTP

Dùng hướng dẫn này khi bạn muốn các ví dụ HTTP trực tiếp. Nếu bạn đang phát triển bằng Node.js hoặc Bun, hãy bắt đầu với Khởi động nhanh SDK Node.js thay vì vậy.

1. Tạo một đích tải lên

curl -X POST https://api.youka.io/vi/api/v1/uploads \
  -H "Authorization: Bearer yk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "filename": "song.mp3",
    "contentType": "audio/mpeg",
    "contentLength": 12345678
  }'

Tải lên các byte của tệp tới uploadUrl được trả về.

2. Tạo một dự án

curl -X POST https://api.youka.io/vi/api/v1/projects \
  -H "Authorization: Bearer yk_..." \
  -H "Idempotency-Key: create-project-song-1" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Artist - Song",
    "inputFileId": "file_123",
    "lyricsSource": {
      "type": "align",
      "lyrics": "First line\nSecond line\n...",
      "syncModel": "musicai-alignment",
      "language": "en"
    },
    "splitModel": "mdx23c"
  }'

3. Thăm dò tác vụ

curl https://api.youka.io/vi/api/v1/tasks/task_123 \
  -H "Authorization: Bearer yk_..."

Khi tác vụ ở trạng thái kết thúc, output của nó sẽ chứa các ID kết quả chính cho thao tác.

4. Đọc trạng thái dự án

curl https://api.youka.io/vi/api/v1/projects/proj_123 \
  -H "Authorization: Bearer yk_..."

Lệnh này trả về trạng thái dự án tồn tại lâu dài, bao gồm stems, căn chỉnh, xuất, và các thiết lập dự án đang hoạt động.

5. Tạo một bản xuất

curl -X POST https://api.youka.io/vi/api/v1/projects/proj_123/exports \
  -H "Authorization: Bearer yk_..." \
  -H "Idempotency-Key: export-song-1" \
  -H "Content-Type: application/json" \
  -d '{
    "resolution": "1080p",
    "quality": "high"
  }'

Sau đó thăm dò tác vụ được trả về hoặc đọc trực tiếp bản xuất:

curl https://api.youka.io/vi/api/v1/exports/export_123 \
  -H "Authorization: Bearer yk_..."