Câu hỏi thường gặp về thư viện tư liệu

Câu hỏi thường gặp

Nhóm tạo trong bảng điều khiển không thấy trong API

Nhóm tạo trong bảng điều khiển sẽ xuất hiện trong GET /api/v1/materials/groups. Nếu chỉ có ID nhóm, cũng có thể dùng trực tiếp làm group_id trong POST /api/v1/materials/assets; nền tảng sẽ xác nhận nhóm tồn tại trước, rồi liên kết nó với tài khoản hiện tại, sau đó nhóm sẽ xuất hiện trong danh sách nhóm.

Xem nguyên nhân kiểm duyệt thất bại ở đâu

data.asset.error_message trả về khi truy vấn tư liệu chính là nguyên nhân thất bại, chỉ có nội dung khi status là Failed, trạng thái bình thường và khả dụng là null.

Kiểm duyệt hình ảnh mất bao lâu

Kiểm duyệt và tiền xử lý là bất đồng bộ, thời gian phụ thuộc vào bản thân tư liệu, nền tảng không cam kết thời lượng thống nhất cho tất cả hình ảnh. Chương trình nên truy vấn lặp lại cùng một ID tư liệu, không gửi lặp lại chỉ vì trạng thái ban đầu là Processing.

Truy vấn thường xuyên có bị giới hạn không

Truy vấn trạng thái là API nhẹ, nhưng không nên gửi yêu cầu đồng thời lặp lại trong một chu kỳ truy vấn; khuyến nghị truy vấn cùng một ID tư liệu mỗi 5～10 giây. Khi yêu cầu quá thường xuyên, API trả về HTTP 429, chỉ cần thử lại sau, tư liệu đã gửi không bị ảnh hưởng.

Địa chỉ ảnh có yêu cầu gì

Phải là địa chỉ http(s) mà máy chủ nền tảng có thể tải trực tiếp (http và https đều hỗ trợ), không được phụ thuộc vào Cookie, Referer, trang đăng nhập hoặc danh sách IP cho phép. Nếu hình ảnh nằm sau địa chỉ cần đăng nhập, trong mạng nội bộ hoặc chỉ có tệp cục bộ, hãy chuyển lưu vào lưu trữ đối tượng hoặc dùng data_url, nếu không sẽ gặp lỗi xử lý tư liệu.

Chỉ cần có địa chỉ công khai thì ưu tiên dùng image_url: nền tảng truyền nguyên địa chỉ, không tải và chuyển lưu, gửi kiểm duyệt nhanh nhất; data_url cần tải lên base64 của toàn bộ ảnh, chậm hơn rõ rệt và chiếm dung lượng lưu trữ của nền tảng.