
Microsoft TRELLIS.2: текстурована 3D-модель (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 створює текстуровану 3D-модель у форматі GLB з одного зображення. У Studio завантажте чітке зображення об’єкта на однотонному тлі.
Створіть текстуровану 3D-версію продукту за чітким зображенням продукту.
Перетворіть сфотографований об’єкт на 3D-реквізит для ігрової сцени.
Створіть 3D-модель однієї фігури на однотонному тлі.
TRELLIS.2 бере твої вхідні дані, працює з обраними налаштуваннями й кладе результат у твою Бібліотеку. Невдалі запуски повертаються автоматично.
Що найкраще працює з TRELLIS.2.
За запуск. У Studio ціни в кредитах (1 кредит = $0.01); стовпець API — тариф для розробників у доларах США, списується з того самого балансу. Невдалі запуски нічого не коштують.
| Налаштування | Studio (кредити) | API (USD) |
|---|---|---|
| За модельтипово | 3 cr | $0.026 |
Орієнтовні ціни за прайсом; точна ціна — на кнопці «Створити» до запуску.
Кожне налаштування працює однаково в Studio, Canvas, мобільному застосунку та API; варіанти беруться з одного джерела.
Той самий seed із тими самими налаштуваннями дає майже однаковий результат. Лиши порожнім для випадкового.
Що приймає TRELLIS.2 і які обмеження діють. Усе тут узято з каталожного запису моделі.
Та сама модель; API для розробників оплачується в доларах США. Надішли POST /v1/generations з id моделі, вказаним нижче, а тоді опитуй GET /v1/generations/{id}?wait=60 або скористайся вебхуком. GET /v1/models/{id} повертає ціну для твоїх налаштувань, нічого не запускаючи. 3D повертає GLB і триває кілька хвилин, тож використовуй вебхук або тривале опитування.
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 |
Твоя черга
Ціна видна на кнопці ще до натискання; невдалі запуски повертаються.
Виберіть один об’єкт, який хочете перетворити на 3D-модель.
Використовуйте одне чітке зображення об’єкта на однотонному тлі.
Виберіть вихідне зображення для TRELLIS.2.
Запустіть модель і перегляньте створену текстуровану 3D-модель. За потреби спробуйте використати інше чітке зображення об’єкта на однотонному тлі.
| Вхід | Обов’язково | Обмеження | Для чого |
|---|---|---|---|
| Вихідне зображення | Так | 1 | Зображення, з яким працювати. Чітка, добре освітлена картинка дає найкращий результат. |
| surface |
| string |
| textured · geometry |
| seed | integer | — |
Одне зображення об’єкта на однотонному тлі.
Текстурована 3D-модель.
Результат — файл GLB.
Ціна залежить від обраних налаштувань, її видно на кнопці «Створити» до запуску. У таблиці цін нижче наведено типові ціни (за модель) для Studio в кредитах (1 кредит = $0.01) і для API в доларах США.
Кошти не списуються. Зарезервована сума автоматично повертається на баланс.
Так. Використай id моделі з розділу API у запиті POST /v1/generations. Додай "dry_run": true, щоб отримати ціну без запуску.
Так, на будь-якому платному плані. Безкоштовний план — для особистого використання.
Так. TRELLIS.2 доступна як вузол у Canvas і в кожному шаблоні, що її використовує.