
Microsoft TRELLIS.2: ساخت مدل سهبعدی با بافت (GLB) از یک تصویر.
اعتبار اجرای ناموفق خودکار برمیگردد.
همان مدل، همان موجودی. با REST API فراخوانیاش کنید یا بگذارید ایجنتتان از طریق MCP از آن استفاده کند.
microsoft/trellis-2curl https://api.fcaai.ai/v1/generations \
-H "Authorization: Bearer $FCAAI_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "microsoft/trellis-2",
"input": {
"image": "https://example.com/your-image.png",
"detail": "fast",
"surface": "textured"
}
}'جزئیات
TRELLIS.2 از یک تصویر، یک مدل سهبعدی بافتدار در قالب فایل GLB میسازد. در Studio، تصویری واضح از یک شیء روی پسزمینهای ساده وارد کنید.
نسخهای سهبعدی و بافتدار از محصول، بر اساس تصویری واضح از آن بسازید.
یک شیء عکاسیشده را به یک المان سهبعدی برای صحنهی بازی تبدیل کنید.
یک مدل سهبعدی از یک پیکرهٔ منفرد بسازید که در برابر پسزمینهای ساده نمایش داده شده است.
TRELLIS.2 ورودیهای شما را میگیرد، با تنظیماتی که انتخاب کردهاید اجرا میشود و نتیجه را در کتابخانه شما میگذارد. اعتبار اجرای ناموفق خودکار برمیگردد.
چه چیزی با TRELLIS.2 بهتر جواب میدهد.
بهازای هر اجرا. قیمت Studio به اعتبار است (1 اعتبار = $0.01)؛ ستون API نرخ توسعهدهندگان به دلار آمریکاست که از همان موجودی کم میشود. اجرای ناموفق هزینهای ندارد.
| تنظیمات | Studio (اعتبار) | API (دلار) |
|---|---|---|
| هر مدلپیشفرض | 3 cr | $0.026 |
برآورد بر اساس قیمت پایه؛ قیمت دقیق پیش از اجرا روی دکمه «تولید» است.
هر تنظیم در Studio، Canvas، موبایل و API یکسان کار میکند؛ گزینهها از یک منبع میآیند.
seed یکسان با تنظیمات یکسان نتیجهای تقریباً مشابه میدهد. برای تصادفی بودن، خالی بگذارید.
آنچه TRELLIS.2 میپذیرد و محدودیتهایش. همه این اطلاعات از مشخصات مدل در فهرست آمده است.
همان مدل؛ هزینه API توسعهدهندگان به دلار آمریکا حساب میشود. با شناسه مدل زیر به POST /v1/generations درخواست بفرستید و سپس GET /v1/generations/{id}?wait=60 را بررسی کنید یا از وبهوک استفاده کنید. GET /v1/models/{id} قیمت تنظیمات شما را بدون اجرای چیزی برمیگرداند. خروجی 3D یک فایل GLB است و چند دقیقه طول میکشد؛ پس از وبهوک یا long-poll استفاده کنید.
curl https://api.fcaai.ai/v1/generations \
-H "Authorization: Bearer $FCAAI_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "microsoft/trellis-2",
"input": {
"image": "https://example.com/your-image.png",
"detail": "fast",
"surface": "textured"
}
}'| فیلد | نوع | مقادیر |
|---|---|---|
| imagesالزامی | array | 1–1 |
| detail | string | fast · detailed |
نوبت شماست
قیمت پیش از زدن دکمه روی آن نوشته شده است؛ اعتبار اجرای ناموفق برمیگردد.
یک شیء را که میخواهید به مدل سهبعدی تبدیل کنید، انتخاب کنید.
از یک تصویر واضح استفاده کنید که شیء در برابر پسزمینهای ساده قرار گرفته باشد.
تصویر منبع را برای TRELLIS.2 انتخاب کنید.
مدل را اجرا کنید و مدل سهبعدی بافتدارِ حاصل را بررسی کنید. در صورت نیاز، تصویر واضح دیگری از شیء با پسزمینهای ساده را امتحان کنید.
| ورودی | الزامی | محدودیت | کاربرد |
|---|---|---|---|
| تصویر منبع | بله | 1 | تصویری که روی آن کار میشود. تصویر واضح و پرنور بهترین نتیجه را میدهد. |
| surface |
| string |
| textured · geometry |
| seed | integer | — |
یک تصویر از یک شیء روی پسزمینهای ساده.
یک مدل سهبعدی با بافت.
خروجی یک فایل GLB است.
قیمت به تنظیماتی که انتخاب میکنید بستگی دارد و پیش از اجرا روی دکمه «تولید» نمایش داده میشود. جدول قیمت زیر، قیمتهای معمول مدل را برای Studio به اعتبار (1 اعتبار = $0.01) و برای API به دلار آمریکا نشان میدهد.
هزینهای از شما کم نمیشود. مبلغ رزروشده خودکار به موجودیتان برمیگردد.
بله. شناسه مدل را که در بخش API آمده با POST /v1/generations به کار ببرید. برای گرفتن برآورد قیمت بدون اجرا، "dry_run": true را اضافه کنید.
بله، در همه طرحهای پولی. طرح رایگان برای استفاده شخصی است.
بله. TRELLIS.2 بهصورت نود در Canvas و در هر قالبی که از آن استفاده میکند در دسترس است.