output_formatstringОбязательноОбязательно. glb для браузеров и веб-игр, fbx для программ анимации и движков, stl для 3D-печати (только геометрия). На цену не влияет.
- По умолчанию
- Не задано
- Допустимые значения
"glb""fbx""stl"
tripo/tools/convertTripo Convert сохраняет 3D-модель в GLB, FBX или STL и может уменьшить число граней, перейти на четырёхугольники, изменить размер текстур или точку опоры, сохраняя скелет и анимацию.
Примеры используют публичные параметры выбранного эндпоинта. Замените API-ключ и примеры медиафайлов, затем отправьте запрос со своего сервера.
SDK и интеграцииhttps://api.spicyapi.ai/api/v1/jobs/createTaskХраните API-ключ в серверной переменной окружения SPICY_API_KEY. Используйте Bearer-аутентификацию и Content-Type: application/json для JSON-запросов.
Authorization: Bearer $SPICY_API_KEY# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "tripo/tools/convert",
"input": {
"fbx_preset": "blender",
"flatten_bottom": false,
"forward_axis": "+x",
"mesh_url": "https://example.com/reference.png",
"output_format": "glb",
"pivot_to_bottom": false,
"quad_mesh": false
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"Пример построен по входной схеме этой модели — той же, по которой API проверяет каждый запрос.
Поместите эти поля в объект input тела запроса. Имена и типы соответствуют API. Не предполагайте значение по умолчанию, если оно не задано.
output_formatstringОбязательноОбязательно. glb для браузеров и веб-игр, fbx для программ анимации и движков, stl для 3D-печати (только геометрия). На цену не влияет.
"glb""fbx""stl"mesh_urlstringОбязательноМодель для конвертации: GLB, бинарный FBX, OBJ или STL до 90 МБ. Подходят и файлы со скелетом и анимацией.
in_placebooleanНеобязательноПо умолчанию выключено. Убирает перемещение вперёд из клипов анимации при экспорте. На цену не влияет.
keep_animationbooleanНеобязательноПо умолчанию включено: скелет и клипы анимации записываются в новый файл. Выключите для статичной сетки. На цену не влияет.
bake_texturesbooleanНеобязательноПо умолчанию включено: сложные материалы запекаются в базовые текстуры. На цену не влияет.
fbx_presetstringНеобязательноПресет совместимости при экспорте FBX: blender (по умолчанию), 3dsmax, mixamo или bake_scale. На цену не влияет.
"blender""3dsmax""mixamo""bake_scale"forward_axisstringНеобязательноНаправление модели в экспортируемом файле: +x (по умолчанию), -x, +y или -y. На цену не влияет.
"+x""-x""+y""-y"flatten_bottombooleanНеобязательноВлияет на ценуПо умолчанию выключено. Делает нижнюю поверхность плоской, что полезно перед 3D-печатью. Повышает тариф.
scale_factornumberНеобязательноВлияет на ценуЕдиный коэффициент масштаба при экспорте, по умолчанию 1. Любое другое значение повышает тариф.
pivot_to_bottombooleanНеобязательноВлияет на ценуПо умолчанию выключено. Переносит точку опоры в центр основания, чтобы при размещении модель стояла на земле. Повышает тариф.
texture_formatstringНеобязательноВлияет на ценуjpeg (по умолчанию), png или webp для экспортируемых текстур. Выбор png или webp повышает тариф.
"jpeg""png""webp"texture_sizeintegerНеобязательноВлияет на ценуРазмер диффузной текстуры в пикселях: от 128 до 8192, по умолчанию 4096. Любое другое значение повышает тариф.
face_limitintegerНеобязательноВлияет на ценуНеобязательное максимальное число граней: от 48 до 2 000 000. Оставьте пустым для сохранения исходного количества. Заданное значение повышает тариф.
quad_meshbooleanНеобязательноВлияет на ценуПо умолчанию выключено. Перестраивает сетку в четырёхугольники: около 10 000 граней, если не задан face_limit; требует output_format fbx. Повышает тариф.
{
"additionalProperties": false,
"properties": {
"bake_textures": {
"default": true,
"description": "Bake advanced materials into the base textures. Does not change the price.",
"type": "boolean",
"x-ui": {
"advanced": true,
"affects_price": false,
"order": 35,
"widget": "switch"
}
},
"face_limit": {
"description": "Maximum number of faces, 48 to 2,000,000. Leave empty to keep the original count. Setting it uses the higher rate.",
"maximum": 2000000,
"minimum": 48,
"type": "integer",
"x-ui": {
"affects_price": true,
"order": 75,
"widget": "number"
}
},
"fbx_preset": {
"default": "blender",
"description": "Compatibility preset for FBX exports. Does not change the price.",
"enum": [
"blender",
"3dsmax",
"mixamo",
"bake_scale"
],
"type": "string",
"x-ui": {
"advanced": true,
"affects_price": false,
"enum_labels": {
"3dsmax": "3ds Max",
"bake_scale": "Bake scale",
"blender": "Blender",
"mixamo": "Mixamo"
},
"order": 40,
"widget": "radio"
}
},
"flatten_bottom": {
"default": false,
"description": "Flatten the underside of the model, useful for 3D printing. Uses the higher rate.",
"type": "boolean",
"x-ui": {
"advanced": true,
"affects_price": true,
"order": 50,
"widget": "switch"
}
},
"forward_axis": {
"default": "+x",
"description": "Axis the model faces in the exported file. Does not change the price.",
"enum": [
"+x",
"-x",
"+y",
"-y"
],
"type": "string",
"x-ui": {
"advanced": true,
"affects_price": false,
"enum_labels": {
"+x": "+X",
"+y": "+Y",
"-x": "-X",
"-y": "-Y"
},
"order": 45,
"widget": "radio"
}
},
"in_place": {
"default": false,
"description": "Remove forward movement from animation clips during export. Does not change the price.",
"type": "boolean",
"x-ui": {
"advanced": true,
"affects_price": false,
"order": 25,
"widget": "switch"
}
},
"keep_animation": {
"default": true,
"description": "Keep skeleton and animation data. Turn off for a static mesh. Does not change the price.",
"type": "boolean",
"x-ui": {
"advanced": true,
"affects_price": false,
"order": 30,
"widget": "switch"
}
},
"mesh_url": {
"contentMediaType": [
"model/gltf-binary",
"model/x-fbx",
"model/obj",
"model/stl"
],
"description": "The 3D model to convert: a GLB, binary FBX, OBJ or STL file up to 90 MB. Skeleton and animation are carried over by default.",
"minLength": 1,
"type": "string",
"x-ui": {
"accept": [
"model/gltf-binary",
"model/x-fbx",
"model/obj",
"model/stl"
],
"max_size_mb": 90,
"order": 100,
"primary": true,
"widget": "upload"
}
},
"output_format": {
"description": "Target format: glb for browsers and web games, fbx for animation software and engines, stl for 3D printing (geometry only). Does not change the price.",
"enum": [
"glb",
"fbx",
"stl"
],
"type": "string",
"x-ui": {
"affects_price": false,
"enum_labels": {
"fbx": "FBX",
"glb": "GLB",
"stl": "STL"
},
"order": 95,
"widget": "radio"
}
},
"pivot_to_bottom": {
"default": false,
"description": "Move the pivot to the centre of the model's base. Uses the higher rate.",
"type": "boolean",
"x-ui": {
"advanced": true,
"affects_price": true,
"order": 60,
"widget": "switch"
}
},
"quad_mesh": {
"default": false,
"description": "Remesh to four-sided polygons (about 10,000 faces unless face_limit is set). Requires output_format fbx. Uses the higher rate.",
"type": "boolean",
"x-ui": {
"affects_price": true,
"order": 80,
"widget": "switch"
}
},
"scale_factor": {
"default": 1,
"description": "Uniform scale for the exported model. Any value other than 1 uses the higher rate.",
"maximum": 1000,
"minimum": 0.001,
"type": "number",
"x-ui": {
"advanced": true,
"affects_price": true,
"order": 55,
"widget": "number"
}
},
"texture_format": {
"default": "jpeg",
"description": "Image format of the exported textures. png or webp uses the higher rate.",
"enum": [
"jpeg",
"png",
"webp"
],
"type": "string",
"x-ui": {
"advanced": true,
"affects_price": true,
"enum_labels": {
"jpeg": "JPEG",
"png": "PNG",
"webp": "WebP"
},
"order": 65,
"widget": "radio"
}
},
"texture_size": {
"default": 4096,
"description": "Diffuse texture size in pixels, 128 to 8192. Any value other than 4096 uses the higher rate.",
"maximum": 8192,
"minimum": 128,
"type": "integer",
"x-ui": {
"advanced": true,
"affects_price": true,
"order": 70,
"step": 128,
"widget": "slider"
}
}
},
"required": [
"mesh_url",
"output_format"
],
"type": "object",
"x-pricing": {
"billingMode": "formula",
"variantFields": []
}
}HTTP 202 означает принятие задачи, а не завершение генерации. Сохраните полученный taskId и проверяйте эту задачу. Не создавайте новую, пока ждёте результат.
HTTP/1.1 202 Accepted
Location: /api/v1/jobs/recordInfo?taskId=job_01k3m8x9q2z4v7n5p6r8s0t1w3
{
"code": 200,
"msg": "success",
"request_id": "req_example_create",
"data": {
"taskId": "job_01k3m8x9q2z4v7n5p6r8s0t1w3",
"state": "queued",
"estimatedCost": "0.750000"
}
}В ответе о приёме есть оценка стоимости — приложение сможет показать ту же сумму в истории задач и в расчётах.
curl --get "https://api.spicyapi.ai/api/v1/jobs/recordInfo" \
--data-urlencode "taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"Начните с интервала около 2 секунд и постепенно увеличивайте его. Прекратите опрос при конечном состоянии. После сбоя соединения используйте исходный taskId. Повторно создавать задачу можно только с исходным ключом идемпотентности и исходным телом запроса.
import { verifyWebhook } from "@spicyapi/sdk";
// express.raw keeps the bytes we signed; express.json never matches.
app.post("/hooks/spicy", express.raw({ type: "application/json" }), (req, res) => {
const { payload } = verifyWebhook({
rawBody: req.body,
timestamp: req.header("X-Webhook-Timestamp"),
signature: req.header("X-Webhook-Signature"),
payloadVersion: Number(req.header("X-Webhook-Payload-Version")),
secret: process.env.SPICY_WEBHOOK_SECRET,
});
res.status(200).end();
void handleFinishedTask(payload);
});Передайте callBackUrl при создании задачи — готовая запись придёт к вам POST-запросом, и никакого опроса не понадобится. В каждой доставке есть X-Webhook-Timestamp, X-Webhook-Signature и X-Webhook-Payload-Version. Подпись — это HMAC-SHA256 в base64 от taskId.timestamp.sha256(body), поэтому проверять её нужно по исходным байтам: если разобрать JSON и сериализовать заново, байты изменятся и проверка не пройдёт. Неудачные доставки повторяются, так что один и тот же taskId может прийти дважды — сделайте обработчик идемпотентным. Сначала ответьте 2xx, работу выполняйте после: медленный обработчик считается неудачной доставкой.
Обрабатывайте output только при state, равном succeeded. При ошибке проверьте errorCode, errorMessage и request_id. Стоимость и состояния в примерах не являются фактическим счётом.
{
"code": 200,
"msg": "success",
"request_id": "req_example_record",
"data": {
"taskId": "job_01k3m8x9q2z4v7n5p6r8s0t1w3",
"model": "tripo/tools/convert",
"state": "succeeded",
"output": {
"assets": [
{
"key": "tasks/2026/08/28/job_01k3m8x9q2z4v7n5p6r8s0t1w3/3f7a1c9e5b2d48f0a6c1e3d5b7f9a1c3.png",
"mime": "image/png",
"url": "https://example.r2.cloudflarestorage.com/results/job_01k3m8x9q2z4v7n5p6r8s0t1w3/result.png?X-Amz-Signature=SIGNATURE_FROM_RESPONSE",
"expiresAt": "2026-08-28T12:20:08.000Z"
}
]
},
"cost": "0.750000",
"settled": true,
"createdAt": "2026-08-28T12:00:00Z",
"completedAt": "2026-08-28T12:00:30Z"
}
}Доступные файлы можно открыть или скачать по assets[].url без заголовка API Authorization. Подписанная ссылка действует до expiresAt. Чтобы обновить её, повторно запросите задачу в течение срока хранения файла. У ожидающих или недоступных файлов URL отсутствует. Не передавайте подписанные ссылки посторонним.
Используйте SpicyAPI в приложении, терминале, ИИ-ассистенте или визуальном процессе. Выберите руководство по настройке.
Писать код выше вовсе не обязательно. Подключите сервер MCP один раз — и любой агент, который говорит на MCP (Claude Code, Codex, Cursor, Windsurf, VS Code, Gemini CLI, Cline, LibreChat), вызовет эту модель по имени. Либо запустите её из терминала одной командой.
Возьми tripo/tools/convert и сгенерируй портрет танцовщицы в неоновом свете, сохрани в ./out/.
Агент найдёт модель в каталоге, сам загрузит локальный файл, покажет точную смету и предельную сумму списания — и дождётся вашего согласия. До этого ничего не списывается.
claude mcp add spicyapi -e SPICY_API_KEY=$SPICY_API_KEY \
-- npx --yes --package=@spicyapi/mcp spicyapi-mcp
npx skills add spicyapi-ai/spicy-skillПервая строка даёт агенту инструменты, вторая — Skill, то есть правила обращения с ними: сначала смета, потом списание; локальные файлы загружать, а не вставлять байтами; URL готового результата читать, а не угадывать. Остальные клиенты подключают тот же сервер через собственный файл настроек — см. раздел для разработчиков.
npx @spicyapi/cli tasks create --model tripo/tools/convert \
--input-json '{"fbx_preset":"blender","flatten_bottom":false,"forward_axis":"+x","mesh_url":"https://example.com/reference.png","output_format":"glb","pivot_to_bottom":false,"quad_mesh":false}' \
--waitВходные данные взяты из схемы этого эндпоинта — той же, что и в примерах выше. --wait дождётся завершения задачи и выведет её, а --yes пропустит подтверждение в CI. Сначала задайте SPICY_API_KEY: один ключ работает и для API, и для CLI, и для сервера MCP.
npx @spicyapi/cli files upload ./poster.png
# -> spicy://uploads/01k3m8x9q2z4v7n5p6r8s0t1w3
npx @spicyapi/cli tasks create --model tripo/tools/convert \
--input-json '{"mesh_url":"spicy://uploads/01k3m8x9q2z4v7n5p6r8s0t1w3"}' \
--waitВ запрос попадают URL, а не байты. Сначала загрузите файл и подставьте выданный spicy:// URI — имя поля выше взято из схемы этого эндпоинта. Агент через MCP делает это сам, потому фраза выше и может прямо назвать ./poster.png. Медиа, уже доступное по публичному HTTPS, загружать не нужно.
npx @spicyapi/cli tasks create --model tripo/tools/convert \
--input-json '{…}' --retention 1h --wait
npx @spicyapi/cli tasks get $TASK_ID # read back the retention that appliedКлюч --retention только сокращает срок — 30m, 1h, 7d или 0, чтобы удалить сразу после перехода задачи в конечное состояние. Реально действует наименьшее из трёх: ваш запрос, настройки аккаунта и предел платформы, — поэтому считайте его из записи задачи, а не исходите из того, что запрошенное число применилось. Запросить срок больше разрешённого аккаунтом нельзя: это ничего не изменит.
Установите узлы SpicyAPI через ComfyUI Manager или командой ниже и найдите на холсте Tripo 3D Tools · Convert. У узла те же параметры, что и на этой странице, а цена показывается до запуска.
cd ComfyUI/custom_nodes
git clone https://github.com/spicyapi-ai/comfyui-spicyapiВстроенная панель читает ту же схему, что и эта страница, поэтому не может разойтись с API. Если содержимое должно индексироваться поиском по документации, возьмите JSON из /api/embed/models/ и отрисуйте его самостоятельно.
<iframe src="https://spicyapi.ai/embed/ru/models/tripo-tools/api?model=tripo%2Ftools%2Fconvert" width="100%" height="560" loading="lazy" title="Пример запроса" style="border:1px solid rgba(0,0,0,.12)"></iframe>