Tạo nội dung hình ảnh

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 hình ảnh vào nhóm hiện có. Sau khi xử lý, hãy tham chiếu nó dưới dạng asset://<ID> trong yêu cầu Seedance được hỗ trợ.

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	Image	Có	Phải là Image.	Image
URL	string	Có	URL công khai, URI dữ liệu hoặc Base64 thô. Hình ảnh phải nhỏ hơn 30 MB, 300–6000 px mỗi bên và có tỷ lệ khung hình 0,4–2,5.	https://example.com/image.jpg
file	binary	Không	Nhiều phần thay thế cho URL. Chấp nhận JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC và HEIF.	image.jpg
Name	string	Không	Tên hiển thị/tìm kiếm, tối đa 64 ký tự. Nó không được gửi đến mô hình.	character-reference
model	string	Không		volc-asset
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",
  "GroupId": "group-20260320141746-zsf6b",
  "Name": "character-reference",
  "AssetType": "Image",
  "URL": "https://example.com/image.jpg"
}

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" \
  --form "GroupId=group-20260320141746-zsf6b" \
  --form "file=@image.jpg"

Phản hồi

Hình ảnh đã đượ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 hình ảnh thông thường mất khoảng 6–9 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.