Thrixel API

تولید سه‌بعدی برای برنامه‌ها و خط لوله‌ها

تولید مدل از متن یا تصویر، بهبود بخش‌های جداگانه و خروجی گرفتن از دارایی‌ها از طریق Thrixel API.

ساخت مدل
THRIXEL_API_KEY='sk-thrixel-...'

curl --fail-with-body \
  https://api.thrixel.com/api/v1/architect/submit \
  -H "Authorization: Bearer $THRIXEL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"task":"یک برج دیده‌بانی چوبی با نردبان"}'
POST /api/v1/architect/submit

قابلیت‌های API

تولید

Architect مدل‌های ساختاریافته با اجزای قابل ویرایش می‌سازد. Sculptor شکل‌های ارگانیک مانند شخصیت‌ها و موجودات را تولید می‌کند.

بهبود

ویرایش با متن، افزودن هندسه و بافت، کاهش تعداد مثلث‌ها یا ریگ‌بندی شخصیت.

خروجی

دریافت GLB، FBX، OBJ، STL یا USDZ برای موتورهای بازی، تجربه‌های وب و گردش‌کارهای سه‌بعدی.

نحوه کار

  1. احراز هویت

    در فضای کاری Thrixel از بخش Profile > API Keys یک کلید API بسازید. آن را به‌صورت توکن Bearer از سرور یا اسکریپت ارسال کنید.

  2. پیگیری کار

    هر درخواست یک شناسه برمی‌گرداند. تا پایان، وضعیت را دوره‌ای بررسی کنید یا پیشرفت را به‌صورت جریانی دریافت کنید؛ پیش از دانلود، کارهای ناموفق را مدیریت کنید.

  3. دریافت نتیجه

    با شناسه درخواست تکمیل‌شده، مدل را دریافت کنید یا مرحله بهبود دیگری را آغاز کنید.

GET /api/v1/{submission_id}/info
GET /api/v1/{submission_id}/download?format=glb

مصرف و دسترسی

عملیات از Thrixel Cubes مصرف می‌کنند. اطلاعات مصرف حساب، موجودی و سقف کارهای هم‌زمان را نشان می‌دهد؛ قیمت فعلی عملیات و محدودیت طرح‌ها در مستندات آمده است.

مستندات API →

Thrixel برای عامل‌های برنامه‌نویسی

سرور MCP عامل‌ها را به این قابلیت‌ها متصل می‌کند و پیشرفت کار و دانلودهای محلی را مدیریت می‌کند.

آشنایی با سرور MCP →