Tripo 3D v3.1

tripo-v3-1-0

Tripo 3D v3.1 — генерация 3d-объектов от tripo, доступная через единый Ranvik API. Поддерживаемые возможности: async, text_to_3d.

от 84 ₽ / запрос

Карточка модели

Технические характеристики

МодальностьГенерация 3D-объектов

Провайдерtripo

СтатусАктивна

ID для запросовtripo-v3-1-0

Возможности

Async
Text-to-3D

Цены

Единица	Цена
за запрос · Text-to-3D	84 ₽
за запрос · Image-to-3D	112 ₽

Цены указаны в рублях. Списываются с баланса проекта при каждом успешном запросе.

Поддерживаемые параметры

Параметры передаются вендору как есть (pure proxy) — мы не валидируем их у себя на стороне. Если вендор не примет — вернётся его ошибка.

Параметр	Тип	Диапазон / values	Default	Описание
`positivePrompt`	string	max: 1024	—	Текстовый промпт описывающий желаемый 3D-объект. Несовместим с inputs.images (выбери text-to-3D или image-to-3D). примеры значений Примеры Игрушка-робот с большими глазами и антенной, мультяшный стиль.
`negativePrompt`	string	max: 255	—	Что НЕ должно быть в результате.
`seed`	integer	min: 0 · max: 20240919	—	Seed для воспроизводимой генерации. Если не задан — выбирается случайно.
`inputs.images`	array of strings	min: 1 · max: 4	—	Изображения для image-to-3D или multiview-to-3D (UUID / URL / Data URI / Base64). 1..4 шт. Несовместимо с positivePrompt. примеры значений Примеры [ "https://example.com/front.png", "https://example.com/side.png" ]
`settings.autoSize`	boolean	—	false	Масштабирование модели в real-world размеры (метры).
`settings.compress`	enum	geometry, meshopt	meshopt	Алгоритм сжатия: geometry или meshopt (оптимальный).
`settings.exportUv`	boolean	—	true	Включить UV unwrapping для текстурирования.
`settings.faceLimit`	integer	min: 500 · max: 20000	—	Максимум полигонов (500..20000). По умолчанию adaptive.
`settings.generateParts`	boolean	—	false	Генерировать сегментированную модель с независимо редактируемыми частями.
`settings.geometryQuality`	enum	standard, detailed	standard	Качество геометрии: standard или detailed.
`settings.imageAutoFix`	boolean	—	false	Оптимизация входного изображения для лучших результатов. ТРЕБУЕТ inputs.images.
`settings.orientation`	enum	default, align_image	default	Ориентация модели. align_image — выровнять под input image (ТРЕБУЕТ inputs.images).
`settings.pbr`	boolean	—	true	Включить PBR materials (physically-based rendering). ТРЕБУЕТ settings.texture=true.
`settings.quad`	boolean	—	false	Quad mesh output (вместо triangle) для DCC-пайплайнов.
`settings.smartLowPoly`	boolean	—	false	Генерировать low-poly меш с сохранением деталей.
`settings.texture`	boolean	—	true	Включить генерацию текстур. Требуется для pbr.
`settings.textureAlignment`	enum	original_image, geometry	—	Стратегия alignment текстуры: original_image (под исходник) или geometry (под форму).
`settings.textureQuality`	enum	standard, detailed	standard	Качество текстур: standard или detailed.
`settings.textureSeed`	integer	min: 0 · max: 20240919	—	Отдельный seed для текстурной генерации (опционально).
`numberResults`	integer	min: 1 · max: 4	1	Сколько вариаций сгенерировать.
`outputType`	enum	URL	URL	Формат доставки.
`outputFormat`	enum	GLB	GLB	Формат 3D-файла. Только GLB (Binary glTF).
`webhookURL`	string	—	—	URL для POST-уведомления при готовности. примеры значений Примеры https://yourapp.com/webhooks/runware
`uploadEndpoint`	string	—	—	Presigned URL для автозагрузки готового .glb. примеры значений Примеры https://bucket.s3.amazonaws.com/result.glb?X-Amz-Signature=...

Параметры ответа

Что возвращает API. У медиа-моделей формат зависит от режима: sync — сразу результат, async — task_id для опроса через GET /v1/tasks/{id}. Эта модель работает только в async-режиме.

Async (HTTP 202)

HTTP 202. 3D-генерация всегда async (несколько минут).

Поле	Тип	Значения
`id`	string	—
`object`	string	object3d.task
`status`	enum	queued, processing, completed, failed
`model`	string	—
`created`	integer	—

Опрос статуса (GET /v1/tasks/{id})

GET /v1/tasks/{id}.

Поле	Тип	Значения	Описание
`id`	string	—
`status`	enum	queued, processing, completed, failed, canceled
`modality`	string	object3d
`model`	string	—
`data`	array	—	Каждый элемент: `url`— string · CDN URL .glb (binary glTF — geometry + textures + PBR materials).
`error`	string	—

Пример запроса

import requests, json

r = requests.post(
    "https://api.ranvik.ru/v1/object3d/generations",
    headers={"Authorization": "Bearer rk_live_...", "Content-Type": "application/json"},
    json={
    "model": "tripo-v3-1-0",
    "positivePrompt": "Пример промпта",
    "negativePrompt": "Пример промпта",
    "seed": 10120460,
    "inputs.images": [],
    "settings.autoSize": False,
    "settings.compress": "meshopt",
    "settings.exportUv": True,
    "settings.faceLimit": 10250,
    "settings.generateParts": False,
    "settings.geometryQuality": "standard",
    "settings.imageAutoFix": False,
    "settings.orientation": "default",
    "settings.pbr": True,
    "settings.quad": False,
    "settings.smartLowPoly": False,
    "settings.texture": True,
    "settings.textureAlignment": "original_image",
    "settings.textureQuality": "standard",
    "settings.textureSeed": 10120460,
    "numberResults": 1,
    "outputType": "URL",
    "outputFormat": "GLB",
    "webhookURL": "https://example.com/...",
    "uploadEndpoint": "value"
},
)
print(r.json())

Замените rk_live_... на ваш ключ из кабинета.