Developer Platform
Developer Platform là nơi bạn chạy, giám sát và cấu hình mọi thứ liên quan đến tích hợp Meshy API của mình — một Playground để thử các endpoint mà không cần viết code, các dashboard bao quát 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.
Tài khoản Free chỉ có thể thử Playground trên endpoint Ảnh sang 3D, thông qua một khóa dùng thử tích hợp sẵn dành riêng cho việc kiểm thử — tài khoản Free không thể tạo hoặc quản lý khóa API của riêng mình, và không có Usage dashboard hay Request Logs. Các gói Pro, Premium, Ultra, Studio, và Enterprise được sử dụng mọi endpoint trong Playground, toàn quyền truy cập Usage dashboard và Request Logs, cùng với khóa API riêng.
Tổng quan
Mở Developer Platform từ ứng dụng web. Thanh bên của nó được tổ chức thành:
- Build — Playground, để thử các endpoint theo cách tương tác.
- Monitor — Usage dashboard và Request Logs.
- Configure — API Keys và Webhooks.
Trang Overview sẽ hướng dẫn các tài khoản mới qua ba bước dưới đây (tạo khóa, thử một yêu cầu trong Playground, kiểm tra kết quả trong Request Logs), sau đó hiển thị ảnh chụp nhanh mức sử dụng trong 7 ngày của hoạt động trên chính tài khoản của bạn cùng các mục mới nhất từ nhật ký thay đổi của Meshy API.
Mới làm quen với API? 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 bất kỳ đoạn code nào. Chọn một endpoint, điền các tham số với hướng dẫn ngay trong giao diện, rồi gửi — các tác vụ chạy qua cùng một pipeline bất đồng bộ như API, vì vậy bạn sẽ thấy tác vụ chuyển từ PENDING sang SUCCEEDED và có thể kiểm tra toàn bộ phản hồi cũng như mô hình kết quả.
Trong khi tác vụ đang chạy, tab Preview phát trực tiếp các cập nhật trạng thái — không cần phải polling.
Chuyển sang tab Request để có đoạn mã sẵn sàng chạy bằng cURL, Python, hoặc JavaScript, hoặc tab Response để kiểm tra toàn bộ JSON — đây là nơi Playground thể hiện giá trị của nó so với không gian làm việc trên webapp: mọi yêu cầu bạn tạo ra chỉ cách một thao tác copy-paste là có thể chạy trong code của riêng bạn.
Usage dashboard
Usage dashboard trực quan hóa toàn bộ hoạt động API của tài khoản bạn — mọi yêu cầu, dù được thực hiện trực tiếp qua API hay 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 đã tiêu thụ, cùng với khối lượng yêu cầu theo thời gian và phân tích tỷ lệ thành công cùng độ trễ theo từng endpoint.
Nhật ký yêu cầu
Request Logs liệt kê mọi tác vụ API trên tài khoản của bạn — cả các lệnh gọi API trực tiếp lẫn các yêu cầu từ Playground — cùng với 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 — hữu ích để gỡ lỗi một lệnh gọi cụ thể mà không cần truy vấn lại API — hoặc chuyển thẳng đến tác vụ đó trong Playground. Sử dụng Export CSV để tải toàn bộ danh sách phục vụ báo cáo hoặc đối chiếu.
Quản lý API
- API Keys — tạo, đặt tên, và thu hồi khóa, đặt giới hạn tín dụng hàng tháng cho từng khóa, 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 trạng thái tác vụ API của bạn thay đổi, thay vì phải polling. Xem hướng dẫn Webhooks để 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.
Phản hồi
Mỗi trang trong Developer Platform đều có nút Feedback ở góc dưới bên phải — sử dụng nút này để báo lỗi, yêu cầu tính năng, hoặc cho chúng tôi biết điều gì đang gây khó hiểu. Chúng tôi đọc từng phản hồi được gửi đến.
Xác thực & tín dụng
Các yêu cầu được ủy quyền bằng một khóa API được truyền trong header Authorization: Bearer, hoàn toàn 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 đều sử dụng tín dụng của gói và tính vào giới hạn tần suất của bạn, giống như bất kỳ lệnh gọi API nào khác. Xem hướng dẫn Xác thực để biết chi tiết về định dạng khóa và bảo mật.