API สำหรับ AI และนักพัฒนา
ให้ AI และโปรแกรมของคุณค้นดัชนีโมเดล 3D ฟรีของ AssetHub ได้โดยตรง ข้อมูลเป็น JSON อ่านอย่างเดียว ทุกรายการมีลิงก์ไปหน้าดาวน์โหลดของเจ้าของผลงานและบอกสัญญาอนุญาตครบ
เชื่อมต่อได้ 4 ทาง
| MCP server | สำหรับ Claude, ChatGPT, Cursor และโปรแกรมที่รองรับ Model Context Protocol ต่อแล้ว AI เรียกค้นได้เอง |
| REST JSON | เรียกด้วย HTTP GET จากโค้ดหรือเครื่องมือใดก็ได้ |
| OpenAPI 3.1 | นำสเปกเข้า ChatGPT Actions หรือเครื่องมือที่อ่าน OpenAPI ได้ |
| llms.txt | สรุปเว็บและวิธีใช้ API ให้ AI ที่เข้ามาอ่านเว็บ |
MCP server
ที่อยู่ของ MCP server เป็นแบบ Streamable HTTP ไม่ต้องยืนยันตัวตน มีเครื่องมือ 3 ตัว คือ search_assets ค้นรายการ get_asset ดูรายละเอียดพร้อมสัญญาและวิธีนำเข้า Unreal Engine และ list_filters ดูค่าตัวกรองกับจำนวนรายการ
https://asset.softpalworld.com/api/mcp
ใน Claude ให้ไปที่ Settings แล้วเลือก Connectors กด Add custom connector แล้ววางที่อยู่ด้านบน ส่วน Claude Code ใช้คำสั่งนี้
claude mcp add --transport http assethub https://asset.softpalworld.com/api/mcp
โปรแกรมอื่นที่รองรับ MCP ผ่าน HTTP ให้ใส่ที่อยู่เดียวกันในหน้าตั้งค่า MCP server ของโปรแกรมนั้น
REST API
ค้นหารายการ
curl "https://asset.softpalworld.com/api/public/search?q=samurai&format=fbx&license=commercial&per=5"
ดูรายละเอียดของรายการเดียว ใช้ id จากผลค้น ได้สัญญาแบบเต็ม ข้อความเครดิต วิธีนำเข้า Unreal Engine และรายการใกล้เคียง
curl "https://asset.softpalworld.com/api/public/asset/{id}"ดูค่าตัวกรองที่ใช้ได้ คำอธิบายสัญญา และจำนวนรายการในดัชนี
curl "https://asset.softpalworld.com/api/public/meta"
สเปก OpenAPI 3.1 สำหรับนำเข้าเครื่องมืออื่น
https://asset.softpalworld.com/api/public/openapi.json
พารามิเตอร์ของการค้นหา
| ชื่อ | ค่าที่ใช้ได้ | ความหมาย |
|---|---|---|
| q | ข้อความ | คำค้น ไทยหรืออังกฤษ เช่น samurai, female knight, ตัวละครเอเชีย |
| format | uasset, metahuman, fbx, obj, gltf, glb, blend, usd, unitypackage | นามสกุลไฟล์ |
| category | character, creature, animation, weapon, environment, nature, prop, vehicle, other | หมวด |
| source | fab, sketchfab, polyhaven, quaternius | แหล่งต้นทาง |
| license | any, commercial, cc0 | commercial คือเฉพาะสัญญาที่ใช้เชิงพาณิชย์ได้ cc0 คือสาธารณสมบัติ |
| rigged, animated, asian | 1 | เฉพาะที่มีโครงกระดูก มีแอนิเมชัน หรือสไตล์เอเชีย |
| sort | relevance, popular, new | การเรียงลำดับ |
| page, per | ตัวเลข | หน้าที่ และจำนวนต่อหน้า สูงสุด 50 ค่าตั้งต้น 20 |
คำในช่อง q อย่าง fbx, uasset, rigged หรือ เอเชีย จะถูกตีความเป็นตัวกรองให้อัตโนมัติ ถ้าใส่ค่าตัวกรองผิด API ตอบสถานะ 400 พร้อมบอกค่าที่ใช้ได้
ข้อมูลที่ได้กลับ
{
"ok": true,
"total": 42, "page": 1, "pages": 9, "per_page": 5,
"results": [
{
"id": "...",
"title": "...",
"category": "character",
"source": "sketchfab",
"author": "...",
"page_url": "https://asset.softpalworld.com/asset/...",
"download_page_url": "https://sketchfab.com/3d-models/...",
"formats": ["fbx", "gltf", "glb"],
"license": { "code": "cc-by", "commercial_use": true, "attribution_required": true },
"rigged": true, "animated": false, "polygon_count": 12000
}
]
}| id | รหัสรายการ ใช้เรียกดูรายละเอียด |
| page_url | หน้าของรายการบน AssetHub |
| download_page_url | หน้าดาวน์โหลดของเจ้าของผลงานบนแพลตฟอร์มต้นทาง |
| download_access | ต้องมีบัญชีของต้นทางหรือไม่ |
| formats | นามสกุลไฟล์ที่มี |
| license | สัญญาอนุญาต พร้อมธง commercial_use, attribution_required, modifications_allowed, redistribution_allowed และคำอธิบายไทยกับอังกฤษ |
| credit_text | ข้อความเครดิตสำเร็จรูป มีเฉพาะในรายละเอียดของรายการที่สัญญาบังคับให้เครดิต |
| rigged, animated, asian_style, polygon_count | คุณสมบัติของโมเดล |
ข้อตกลงการใช้งาน
AssetHub ไม่ได้เก็บไฟล์โมเดล เมื่อแนะนำรายการให้ผู้ใช้ โปรดส่งผู้ใช้ไปที่ download_page_url ของต้นทางหรือ page_url ของเรา และบอกสัญญาอนุญาตของรายการนั้นทุกครั้ง
ข้อมูลสัญญาเก็บจากต้นทางโดยอัตโนมัติ เจ้าของผลงานอาจเปลี่ยนเงื่อนไขภายหลัง ควรแนะนำให้ผู้ใช้ตรวจหน้าต้นทางอีกครั้งก่อนนำไปใช้ในงานเชิงพาณิชย์ อ่านความหมายของแต่ละสัญญาได้ที่ หน้าสัญญาอนุญาต
จำกัดการเรียก 60 ครั้งต่อนาทีต่อ IP เมื่อเกินจะได้สถานะ 429 พร้อมเวลาที่ต้องรอ ผลลัพธ์เก็บแคชได้ 5 นาที หากต้องการใช้ปริมาณมากกว่านี้ ติดต่อ support@softpalworld.com