Tạo nội dung âm thanh

Sẵn có

Trang này ghi lại lộ trình quản lý tài sản Modelflare. Cuộc gọi yêu cầu Khóa API thông minh hợp lệ hoặc khóa API nhóm phương tiện, kênh phương tiện có sẵn và quyền cần thiết.

Ghi chú

Cổng ghi lại ID tài sản của nhà cung cấp, trạng thái và quyền sở hữu của người dùng. Thư viện cục bộ Castaly vẫn tách biệt với không gian tên tài sản của nhà cung cấp.

Điểm cuối

POST https://modelflare.dev/volc/asset/CreateAsset

Xác thực

Sử dụng khóa API Modelflare:

bash

-H "Authorization: Bearer YOUR_MODELFLARE_API_KEY"

Gửi Idempotency-Key với các yêu cầu tạo, cập nhật và xóa. Việc thử lại cùng một khóa cho cùng một người dùng sẽ phát lại phản hồi đã lưu mà không lặp lại đột biến.

Yêu cầu

Thêm bản âm thanh vào nhóm hiện có để hỗ trợ quy trình làm việc Seedance.

Cánh đồng	Loại	Bắt buộc	Mô tả	Ví dụ
GroupId	string	Có	ID nhóm nội dung mục tiêu.	group-20260320141746-zsf6b
AssetType	Audio	Có	Phải là Audio.	Audio
URL	string	Có	URL công khai, URI dữ liệu hoặc Base64 thô. Chỉ WAV hoặc MP3, 2–30 giây, không quá 15 MB.	https://example.com/audio.mp3
file	binary	Không	Nhiều phần thay thế cho URL với cùng giới hạn âm thanh.	audio.mp3
Name	string	Không	Tên hiển thị/tìm kiếm, tối đa 64 ký tự.	background-music
model	string	Có		volc-asset-audio
ProjectName	string	Không	Tên dự án. Nó phải phù hợp với nhóm mục tiêu; mặc định là default.	default

Ví dụ về JSON:

JSON

{
  "model": "volc-asset-audio",
  "GroupId": "group-20260320141746-zsf6b",
  "Name": "background-music",
  "AssetType": "Audio",
  "URL": "https://example.com/audio.mp3",
  "ProjectName": "default"
}

ví dụ về nhiều phần/biểu mẫu dữ liệu:

bash

curl --request POST https://modelflare.dev/volc/asset/CreateAsset \
  --header "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  --form "model=volc-asset-audio" \
  --form "GroupId=group-20260320141746-zsf6b" \
  --form "file=@audio.mp3"

Phản hồi

Âm thanh đã được xử lý không đồng bộ. Thăm dò GetAsset cho đến khi Status là Active hoặc Failed. Không có SLA thời gian tải lên; một tệp âm thanh thông thường mất khoảng 3–6 giây, trong khi hàng đợi xem xét bận rộn có thể mất khoảng 10 giây đến 2 phút.

Cánh đồng	Loại	Bắt buộc	Mô tả	Ví dụ
Id	string	Có	ID nội dung. Chỉ sử dụng asset://<ID> sau khi trạng thái là Active.	asset-20260528140922-d9646

Ví dụ phản hồi:

JSON

{
  "Id": "asset-20260528140922-d9646"
}

Lỗi

Trạng thái	Ý nghĩa
400	Yêu cầu không hợp lệ.
401	Khóa API bị thiếu hoặc trái phép.

Ví dụ về nội dung lỗi (khi được trả về):

JSON

{
  "error": {
    "code": "invalid_request",
    "message": "Request validation failed."
  }
}

Việc tạo hình ảnh, video và âm thanh không đồng bộ. Sau khi nhận được ID nội dung, hãy gọi GetAsset và chỉ sử dụng tham chiếu asset://<ID> khi trạng thái là Active.