Hướng dẫn
Nhật ký cập nhật
Bản ghi các thay đổi cấu trúc và mô tả giao diện của sổ tay sử dụng
Nhật ký cập nhật
Trang này ghi lại các thay đổi về cấu trúc và mô tả giao diện của tài liệu sổ tay sử dụng, giúp các nhà phát triển đã tích hợp dễ đối chiếu kiểm tra.
Tài liệu chỉ mô tả hành vi hiện đang có hiệu lực; nếu không nhất quán với cách triển khai trước đây của bạn, hãy lấy sổ tay này và kết quả thời gian thực của GET /v1/models làm chuẩn.
Cập nhật lần này (chuẩn hóa tài liệu)
Cấu trúc điều hướng
Sổ tay sử dụng được tổ chức lại theo lộ trình sử dụng, gồm sáu phân vùng:
| Phân vùng | Nội dung |
|---|---|
| Bắt đầu nhanh | Bắt đầu nhanh, hướng dẫn tính năng nền tảng, chợ mô hình và tính phí, tích hợp công cụ thường dùng |
| Tổng quan nền tảng | Định vị, tính năng và câu hỏi thường gặp của bốn nền tảng |
| Tích hợp API | Quy chuẩn xác thực, tổng quan giao diện, văn bản, hình ảnh, video, âm thanh, mã lỗi |
| Thư viện tư liệu | Hướng dẫn thư viện tư liệu, giao diện thư viện tư liệu, quy trình chân dung, video tham chiếu |
| Sáng tạo trên web | Bảng làm việc và Agent của Creation, tạo video và thử lại, câu hỏi thường gặp |
| Trợ giúp và tham khảo | Tổng hợp câu hỏi thường gặp, tính phí và hóa đơn, giới hạn tần suất và hạn ngạch, nhật ký cập nhật, bảng thuật ngữ |
Các thẻ trên cùng và thanh bên được cập nhật đồng bộ. Mọi địa chỉ cũ vẫn giữ nguyên, các liên kết đã chia sẻ cho khách hàng tiếp tục có hiệu lực.
Nội dung mới
- Thêm phân vùng「Trợ giúp và tham khảo」: tổng hợp câu hỏi thường gặp, tính phí và hóa đơn, giới hạn tần suất và hạn ngạch, nhật ký cập nhật, bảng thuật ngữ;
- Thêm trang mô tả riêng cho giao diện chuyển văn bản thành giọng nói;
- Bổ sung danh sách tính năng, quy trình làm việc điển hình và câu hỏi thường gặp cho bốn trang nền tảng;
- Trang Canvas bổ sung loại nút, thao tác thường dùng, phím tắt và ví dụ quy trình sáng tạo đầy đủ;
- Mục lục tài liệu bổ sung lối vào giao diện âm thanh và tổng quan nền tảng.
Nội dung chỉnh sửa
- Sửa liên kết hỏng trên trang Canvas trỏ tới trang chưa phát hành;
- Sửa liên kết giao diện video ở lối vào chính của tài liệu, đổi thành dẫn thẳng tới trang tạo tác vụ;
- Sửa mục giao diện âm thanh bị thiếu trong mục lục tài liệu, giữ nhất quán với tổng quan giao diện.
Làm rõ khái niệm
Các hành vi sau đã được giải thích rõ trong sổ tay, khi tích hợp xin đặc biệt lưu ý:
| Chủ đề | Mô tả |
|---|---|
| Quyết toán khi hoàn thành | Tác vụ bất đồng bộ quyết toán khi hoàn thành, gửi chỉ là tiếp nhận tác vụ, không trừ tiền trước |
| Truy vấn không tính phí | Truy vấn trạng thái tác vụ không phát sinh chi phí, chỉ tạo tác vụ mới bị tính phí |
| Không gộp yêu cầu trùng lặp | Gửi lặp lại với tham số giống nhau sẽ tạo tác vụ mới và mỗi bên tự tính phí, nền tảng không tự động gộp |
| Tư liệu chỉ cần đưa vào thư viện một lần | ID tư liệu giữ nguyên qua các mô hình, chuyển mô hình chỉ cần đổi trường model |
| Tư liệu người thật không thể hạ cấp | Khi chuyển sang mô hình không hỗ trợ tư liệu người thật sẽ không tự động đổi thành ảnh tham chiếu thông thường |
| Quyền ảnh chụp yêu cầu | Nội dung yêu cầu và JSON yêu cầu chỉ quản trị viên mới xem được, người dùng thường khi truy vấn sẽ không nhận được trường đó |
Cách xác nhận hành vi hiện tại
Tài liệu mô tả hành vi thiết kế, phạm vi hiển thị thực tế của mô hình phải lấy kết quả thời gian thực làm chuẩn:
curl "$LOCOPAL_BASE_URL/v1/models" \
-H "Authorization: Bearer $LOCOPAL_API_KEY"Danh mục mô hình sẽ thay đổi theo quyền cấp của tài khoản, địa chỉ tích hợp và tính khả dụng của nền tảng. Nên truy vấn lại khi dịch vụ khởi động, khi người dùng chuyển mô hình, hoặc khi nhận「Mô hình không khả dụng」; không nên cố định tên mô hình.