Trợ giúp và tham khảo
Trang này giải thích thống nhất các thuật ngữ xuất hiện trong tài liệu và giao diện nền tảng, tránh việc cùng một khái niệm lại có cách gọi khác nhau trên các trang.
| Thuật ngữ | Ý nghĩa |
|---|
| LocoPal Ai | Nền tảng API, đồng thời là lõi của toàn bộ hệ sinh thái: tài khoản, đăng nhập, tính phí, danh mục mô hình, thư viện tư liệu và bản ghi tác vụ đều do nó cung cấp. Lối vào locopalai.com. |
| LocoPal Creation | Nền tảng sáng tạo (bảng làm việc trên web), dành cho việc sáng tạo trực tiếp không cần viết mã. Lối vào creation.locopalai.com. |
| Bảng điều khiển | Giao diện quản lý sau khi đăng nhập LocoPal Ai, bao gồm chợ mô hình, khóa API, nhật ký, quản lý thư viện tư liệu, ví, v.v. |
| Thuật ngữ | Ý nghĩa |
|---|
| API keys | Thông tin xác thực để gọi giao diện nền tảng, có dạng sk-.... Một Key có thể gọi giao diện mô hình, hình ảnh, video, âm thanh và tư liệu. |
| Access Token | Khóa gọi ngắn hạn. Frontend nền tảng chỉ lưu nó trong bộ nhớ, không ghi vào localStorage. |
| Khóa làm mới / Cookie phiên | Dùng để khôi phục trạng thái đăng nhập sau khi làm mới trang. Phạm vi là .locopalai.com, nên hai nền tảng có thể dùng chung đăng nhập. |
| Đăng nhập thống nhất | Chỉ cần đăng nhập một lần tại LocoPal Ai, các nền tảng còn lại tự động có trạng thái đăng nhập. LocoPal Ai là nguồn danh tính duy nhất. |
| Mất hiệu lực đăng nhập | Sau khi đăng xuất, chuyển tài khoản hoặc đổi mật khẩu, phiên trên hai nền tảng mất hiệu lực đồng thời, cần đăng nhập lại. |
| Thuật ngữ | Ý nghĩa |
|---|
| ID mô hình | Giá trị cần điền cho trường model trong yêu cầu, lấy từ data[].id do GET /v1/models trả về. Không phải tên hiển thị trên trang. |
| Chợ mô hình | Lối vào để xem tên mô hình, năng lực, tham số, giá và các nhóm khả dụng. |
| Nhóm gọi / nhóm | Phạm vi cấp quyền quyết định một Key có thể thấy và gọi những mô hình nào. Một nhóm có một số kênh, trên kênh gắn một số mô hình. |
| Kênh | Kênh thực sự chịu tải mô hình dưới một nhóm. Mô hình có khả dụng hay không phụ thuộc vào việc hiện tại có thể định tuyến tới kênh khả dụng hay không. |
| Địa chỉ cơ sở (Base URL) | Tiền tố giao diện, ví dụ https://locopalai.com. Chỉ ghi đến tên miền, không nối thêm /v1 lặp lại. |
us-api.locopalai.com | Địa chỉ tích hợp dự phòng dành cho mô hình hải ngoại hoặc môi trường mạng đặc thù. Dùng địa chỉ nào thì lấy /v1/models của địa chỉ đó làm chuẩn. |
| Gọi đồng bộ | Lệnh gọi nhận kết quả ngay khi yêu cầu trả về, như văn bản, hình ảnh, âm thanh. |
| Tác vụ bất đồng bộ | Lệnh gọi tạo tác vụ lấy ID trước, rồi thăm dò truy vấn kết quả, như tạo video. |
| Thuật ngữ | Ý nghĩa |
|---|
| Thư viện tư liệu | Kho lưu trữ tư liệu thống nhất của nền tảng, được tổ chức theo nhóm. Đưa vào một lần là có thể được mọi mô hình hỗ trợ tham chiếu tư liệu tái sử dụng. |
| Nhóm tư liệu | Vật chứa tư liệu, chia thành hai loại ảo (virtual) và người thật (real). |
| Tư liệu ảo | Tư liệu hình ảnh được tải lên hoặc tạo ra, phù hợp để lưu nhân vật, sản phẩm, phong cách và các tư liệu có thể tái sử dụng. |
| Tư liệu người thật | Tư liệu người thật cần chính người đó dùng điện thoại quét mã để hoàn tất thu thập sống và ủy quyền, không thể thay thế bằng tải ảnh thông thường. |
| ID tư liệu | Định danh duy nhất của tư liệu, giữ nguyên qua các mô hình. |
asset://<asset_id> | Cách viết để tham chiếu tư liệu đã đưa vào thư viện trong yêu cầu. Cần chờ trạng thái tư liệu là Active rồi mới dùng. |
Active | Một trong các trạng thái tư liệu, nghĩa là tư liệu đã xử lý xong, có thể dùng ổn định trên các mô hình hỗ trợ tham chiếu tư liệu. |
Processing | Tư liệu vẫn đang xử lý. Đây không phải lỗi, chỉ cần tiếp tục thăm dò bằng cùng ID tư liệu. |
data_url | Hình thức gửi dữ liệu hình ảnh nội tuyến (data:image/...;base64,...), chỉ có thể gửi một trong hai với image_url. |
| Thuật ngữ | Ý nghĩa |
|---|
| ID tác vụ | Định danh của tác vụ bất đồng bộ. Phải lưu sau khi tạo; khi chờ cục bộ quá thời gian cũng dùng truy vấn thay vì tạo lại để theo dõi. |
| Nhật ký tác vụ | Lối vào xem chi tiết thực thi tác vụ bất đồng bộ, gồm thời gian gửi, ID tác vụ, thời gian xử lý, trạng thái, tiến độ và sản phẩm. |
| Nhật ký sử dụng | Lối vào xem chi tiết gọi đồng bộ, gồm mô hình, Token và chi phí. |
queued / Đang xếp hàng | Tác vụ đã được tiếp nhận, đang chờ thực thi. |
processing / Đang tạo | Tác vụ đang thực thi, có thể rời trang và quay lại bản ghi ban đầu sau để xem. |
succeeded / Đã hoàn thành | Kết quả đã được tạo, có thể tải xuống hoặc tham chiếu. |
failed / Thất bại | Tác vụ thất bại ở trạng thái cuối. Đọc error.code và error.message trong cùng phản hồi. |
video_generation_failed | Mã thất bại trạng thái cuối của tác vụ video, error.message đã là nguyên nhân dễ đọc sau khi làm sạch. |
| Sản phẩm | Đầu ra của tác vụ, hình ảnh, video, âm thanh có thể xem trước hoặc tải xuống trực tiếp. |
| Ảnh chụp yêu cầu | Nội dung yêu cầu và JSON yêu cầu gốc của tác vụ. Chỉ quản trị viên mới xem được, khi người dùng thường truy vấn tác vụ của mình sẽ không nhận được trường này. |
| Thuật ngữ | Ý nghĩa |
|---|
| Tính phí theo Token | Tính phí riêng cho Token đầu vào và đầu ra, đơn vị hiển thị là 1K hoặc 1M Token. |
| Đầu vào bộ nhớ đệm / Ghi bộ nhớ đệm | Khoản tính phí chỉ hiển thị với các mô hình hỗ trợ bộ nhớ đệm câu lệnh. |
| Tính phí theo lần | Mỗi yêu cầu thành công tính theo mức giá cố định. |
| Ma trận giá | Bảng giá của mô hình video được hiển thị theo「có đầu vào video hay không」×「độ phân giải đầu ra」. |
| Quyết toán khi hoàn thành | Khoản trừ thực tế của tác vụ bất đồng bộ xảy ra khi tác vụ hoàn thành; gửi chỉ là tiếp nhận tác vụ, không trừ tiền trước. |
| Ví | Lối vào nạp tiền, gói dịch vụ, đơn hàng và bản ghi hóa đơn. |
| Mức tiêu thụ ước tính | Ước tính chi phí trước khi gửi tác vụ. Khi số dư không đủ bù đắp sẽ trả về thông báo ngay và không tạo tác vụ. |
| Thuật ngữ | Ý nghĩa |
|---|
Giới hạn tần suất / 429 | Yêu cầu quá thường xuyên. Giãn cách thử lại theo hướng dẫn, không thử lại đồng thời. |
task_concurrency_exceeded | Tác vụ đồng thời đạt giới hạn. Giữ lại ID tác vụ hiện có, chờ sau đó để người dùng chủ động gửi lại. |
| Thử lại có giãn cách | Sau khi thất bại, chờ một khoảng thời gian rồi thử lại, và kéo dài dần thời gian chờ, thay vì gửi lại liên tục ngay lập tức. |
| RequestId / ID yêu cầu | Định danh của một lần yêu cầu, dùng để xác định bản ghi cụ thể khi khắc phục sự cố. |
400 kiểm tra tham số thất bại | Yêu cầu chưa được tiếp nhận, thường không phát sinh chi phí tác vụ tạo. |
Trang này có hữu ích không? 