Nền tảng dành cho nhà phát triển
Chạy, giám sát và cấu hình tích hợp Meshy API của bạn trong Nền tảng dành cho nhà phát triển. Nền tảng này có một Playground để thử các endpoint mà không cần viết code, các bảng điều khiển hiển thị mọi yêu cầu API trên tài khoản của bạn, và quản lý khóa API cùng webhook.
Với gói Free, bạn chỉ có thể thử Ảnh sang 3D trong Playground, thông qua một khóa tích hợp sẵn dành cho mục đích thử nghiệm. Tài khoản Free không thể tạo hoặc quản lý khóa API, và không có Bảng điều khiển sử dụng hay Nhật ký yêu cầu. Các gói Pro, Premium, Ultra, Studio và Enterprise được sử dụng mọi endpoint trong Playground, Bảng điều khiển sử dụng và Nhật ký yêu cầu, cùng với khóa API riêng của họ.
Tổng quan
Mở Nền tảng dành cho nhà phát triển từ ứng dụng web. Thanh bên của nó có ba nhóm:
- Build: Playground, để thử các endpoint một cách tương tác.
- Monitor: Bảng điều khiển sử dụng và Nhật ký yêu cầu.
- Configure: API Keys và Webhooks.
Trang Overview hướng dẫn các tài khoản mới qua ba bước: tạo một khóa, thử một yêu cầu trong Playground, và kiểm tra kết quả trong Nhật ký yêu cầu. Trang này cũng hiển thị một ảnh chụp nhanh về mức sử dụng tài khoản của bạn trong 7 ngày và các mục mới nhất từ nhật ký thay đổi.
Mới làm quen với API? Hãy bắt đầu với Bắt đầu nhanh.
Playground
Playground là một bảng điều khiển tương tác để thử các endpoint mà không cần viết code. Chọn một endpoint, điền các tham số của nó theo hướng dẫn trực tiếp, và gửi yêu cầu. Tác vụ chạy qua cùng một quy trình bất đồng bộ như một tác vụ API. Bạn có thể theo dõi nó chuyển từ PENDING sang SUCCEEDED, sau đó kiểm tra toàn bộ phản hồi và mô hình kết quả.
Trong khi một tác vụ đang chạy, tab Preview truyền trực tiếp các cập nhật trạng thái, vì vậy bạn không cần phải liên tục kiểm tra (poll).
Tab Request hiển thị một đoạn mã sẵn sàng chạy bằng cURL, Python hoặc JavaScript, và tab Response hiển thị toàn bộ JSON. Khác với không gian làm việc của ứng dụng web, Playground cung cấp cho bạn mọi yêu cầu bạn xây dựng dưới dạng code mà bạn có thể sao chép vào ứng dụng của riêng mình.
Bảng điều khiển sử dụng
Bảng điều khiển sử dụng biểu đồ hóa toàn bộ hoạt động API của tài khoản bạn, từ các lệnh gọi API trực tiếp và từ Playground. Nó hiển thị tỷ lệ tạo thành công, tổng số yêu cầu, thời gian xử lý trung bình, và tín dụng đã sử dụng. Nó cũng hiển thị khối lượng yêu cầu theo thời gian, cũng như tỷ lệ thành công và độ trễ theo từng endpoint.
Nhật ký yêu cầu
Nhật ký yêu cầu liệt kê mọi tác vụ API trên tài khoản của bạn, từ các lệnh gọi API trực tiếp và từ Playground. Mỗi mục hiển thị trạng thái, thời gian, và khóa API đã thực hiện yêu cầu.
Chọn một tác vụ để xem toàn bộ đầu vào và đầu ra, nội dung yêu cầu, và tín dụng đã sử dụng. Điều này giúp bạn gỡ lỗi một lệnh gọi mà không cần truy vấn lại API. Để mở tác vụ trong Playground, nhấp vào Open in Playground. Để tải xuống toàn bộ danh sách phục vụ báo cáo hoặc đối chiếu, nhấp vào Export CSV.
Quản lý API
- API Keys: tạo, đặt tên, và thu hồi khóa, thiết lập giới hạn tín dụng hàng tháng cho từng khóa, giới hạn mỗi khóa theo một danh sách IP cho phép, và xem mức sử dụng của từng khóa.
- Webhooks: nhận cập nhật theo thời gian thực khi các tác vụ API của bạn thay đổi trạng thái, thay vì phải liên tục kiểm tra (poll). Để biết các bước thiết lập, yêu cầu gửi dữ liệu, và các payload mẫu, xem Webhooks.
Phản hồi
Mọi trang trong Nền tảng dành cho nhà phát triển đều có một nút Feedback. Hãy dùng nó để báo cáo lỗi, đề xuất tính năng, hoặc cho chúng tôi biết điều gì khiến bạn bối rối. Đội ngũ Meshy đọc mọi phản hồi được gửi đến.
Xác thực và tín dụng
Các yêu cầu từ Playground gửi một khóa API trong header Authorization: Bearer, giống như một lệnh gọi API trực tiếp. Playground chạy trên chính tài khoản của bạn, vì vậy mỗi yêu cầu sử dụng tín dụng gói của bạn và được tính vào giới hạn tốc độ (rate limit), giống như bất kỳ lệnh gọi API nào khác. Để biết thêm thông tin về khóa API và bảo mật, xem Xác thực.