Developer Platform

เรียกใช้ ตรวจสอบ และกำหนดค่าการเชื่อมต่อ Meshy API ของคุณใน Developer Platform ที่นี่มี Playground สำหรับลองใช้เอนด์พอยต์โดยไม่ต้องเขียนโค้ด มีแดชบอร์ดแสดงคำขอ API ทั้งหมดในบัญชีของคุณ และมีการจัดการ API คีย์และ webhook

ในแผนฟรี คุณสามารถลองใช้เฉพาะรูปภาพเป็น 3D ใน Playground ได้เท่านั้น ผ่านคีย์ในตัวสำหรับทดสอบ บัญชีฟรีไม่สามารถสร้างหรือจัดการ API คีย์ได้ และไม่มีแดชบอร์ดการใช้งานหรือบันทึกคำขอ แผน Pro, Premium, Ultra, Studio และ Enterprise จะได้รับทุกเอนด์พอยต์ใน Playground แดชบอร์ดการใช้งานและบันทึกคำขอ รวมถึง API คีย์ของตัวเอง

ภาพรวม

เปิด Developer Platform จากเว็บแอป แถบด้านข้างของมันมีสามกลุ่ม:

Build: Playground สำหรับลองใช้เอนด์พอยต์แบบโต้ตอบ
Monitor: แดชบอร์ดการใช้งานและบันทึกคำขอ
Configure: API Keys และ Webhooks

หน้า Overview จะนำบัญชีใหม่ผ่านสามขั้นตอน: สร้างคีย์ ลองส่งคำขอใน Playground และตรวจสอบผลลัพธ์ใน Request Logs นอกจากนี้ยังแสดงภาพรวมการใช้งานของบัญชีคุณในช่วง 7 วัน และรายการล่าสุดจาก Changelog

หน้า Overview ของ Developer Platform แสดงการ์ดเริ่มต้นใช้งานสามขั้นตอน ภาพรวมการใช้งาน 7 วัน และรายการบันทึกการเปลี่ยนแปลงล่าสุดของ Meshy API

ใหม่กับ API ใช่ไหม? เริ่มต้นด้วย เริ่มต้นอย่างรวดเร็ว

Playground

Playground คือคอนโซลแบบโต้ตอบสำหรับลองใช้เอนด์พอยต์โดยไม่ต้องเขียนโค้ด เลือกเอนด์พอยต์ กรอกพารามิเตอร์ของมันตามคำแนะนำในหน้า แล้วส่งคำขอ งานจะรันผ่านไปป์ไลน์แบบอะซิงโครนัสเดียวกับงาน API โดยตรง คุณสามารถดูสถานะเปลี่ยนจาก PENDING ไปเป็น SUCCEEDED จากนั้นตรวจสอบการตอบกลับแบบเต็มและโมเดลที่ได้

Playground ขณะรันคำขอรูปภาพเป็น 3D พร้อมตัวอย่างโมเดลแบบสดควบคู่กับแท็บ Preview, Request และ Response

ขณะที่งานกำลังรัน แท็บ Preview จะสตรีมอัปเดตสถานะแบบสดตลอดเวลา คุณจึงไม่จำเป็นต้องทำการ poll

บันทึกในแท็บ Preview ของ Playground ที่สตรีมอัปเดตสถานะแบบสดขณะที่งานกำลังดำเนินการ

แท็บ Request แสดงโค้ดตัวอย่างที่พร้อมใช้งานในรูปแบบ cURL, Python หรือ JavaScript และแท็บ Response แสดง JSON แบบเต็ม ซึ่งแตกต่างจากพื้นที่ทำงานในเว็บแอป Playground จะมอบคำขอทุกรายการที่คุณสร้างในรูปแบบโค้ดที่คุณสามารถคัดลอกไปใช้ในแอปของคุณเองได้

แท็บ Request และ Response

งานเดียวกัน มองได้สองมุม: คำขอ cURL ที่เทียบเท่ากัน และการตอบกลับ JSON แบบดิบ

แท็บ Request ของ Playground แสดงคำสั่ง cURL ที่เทียบเท่ากับคำขอปัจจุบัน — Request

แท็บ Response ของ Playground แสดงการตอบกลับ JSON แบบดิบ — Response

แดชบอร์ดการใช้งาน

แดชบอร์ดการใช้งานแสดงกราฟกิจกรรม API ทั้งหมดของบัญชีคุณ ทั้งจากการเรียก API โดยตรงและจาก Playground แสดงอัตราความสำเร็จของการสร้าง จำนวนคำขอทั้งหมด เวลาประมวลผลเฉลี่ย และเครดิตที่ใช้ไป นอกจากนี้ยังแสดงปริมาณคำขอตามช่วงเวลา และอัตราความสำเร็จกับเวลาแฝง (latency) แยกตามเอนด์พอยต์

แดชบอร์ดการใช้งาน แสดงอัตราความสำเร็จของการสร้าง ปริมาณคำขอตามช่วงเวลา และอัตราความสำเร็จกับเวลาแฝงแยกตามเอนด์พอยต์

บันทึกคำขอ

Request Logs แสดงรายการงาน API ทั้งหมดในบัญชีของคุณ ทั้งจากการเรียก API โดยตรงและจาก Playground แต่ละรายการแสดงสถานะ ระยะเวลา และ API คีย์ที่ใช้ส่งคำขอนั้น

เลือกงานเพื่อดูอินพุตและเอาต์พุตแบบเต็ม ตัวคำขอ (request body) และเครดิตที่ใช้ไป สิ่งนี้ช่วยให้คุณแก้ไขจุดบกพร่องของการเรียกใช้โดยไม่ต้องสอบถาม API อีกครั้ง หากต้องการเปิดงานนั้นใน Playground ให้คลิก Open in Playground หากต้องการดาวน์โหลดรายการทั้งหมดสำหรับรายงานหรือการกระทบยอด ให้คลิก Export CSV

Request Logs พร้อมสถานะของงานที่เลือก ตัวอย่างอินพุตและเอาต์พุต และตัวคำขอในแผงรายละเอียด ปุ่ม Export CSV และ Open in Playground ถูกไฮไลต์ไว้

การจัดการ API

API Keys: สร้าง ตั้งชื่อ และเพิกถอนคีย์ กำหนดวงเงินเครดิตรายเดือนให้แต่ละคีย์ จำกัดแต่ละคีย์ให้ใช้ได้เฉพาะ IP allowlist และดูการใช้งานของแต่ละคีย์
Webhooks: รับการอัปเดตแบบเรียลไทม์เมื่องาน API ของคุณเปลี่ยนสถานะ แทนที่จะต้อง poll สำหรับขั้นตอนการตั้งค่า ข้อกำหนดในการส่งข้อมูล และตัวอย่าง payload ดูที่ Webhooks

ข้อเสนอแนะ

ทุกหน้าใน Developer Platform มีปุ่ม Feedback ใช้ปุ่มนี้เพื่อรายงานข้อบกพร่อง ขอฟีเจอร์ใหม่ หรือบอกเราว่าส่วนไหนที่ทำให้สับสน ทีมงาน Meshy อ่านทุกข้อความที่ส่งเข้ามา

การยืนยันตัวตนและเครดิต

คำขอใน Playground จะส่ง API คีย์ในส่วนหัว Authorization: Bearer เช่นเดียวกับการเรียก API โดยตรง Playground ทำงานบนบัญชีของคุณเอง ดังนั้นทุกคำขอ จะใช้เครดิตตามแผนของคุณและนับรวมในขีดจำกัดอัตราการเรียกใช้ (rate limit) เช่นเดียวกับการเรียก API อื่น ๆ สำหรับข้อมูลเพิ่มเติมเกี่ยวกับ API คีย์และความปลอดภัย ดูที่ Authentication