ГлавнаяМоделиГенерация 3D-объектовTripo 3D v3.1

Tripo 3D v3.1 API

ПровайдерTripo

tripo-v3-1-0 — генерация 3d-объектов-модель от Tripo.

asynctext_to_3d

Попробуйте прямо здесь

Tripo 3D v3.1 Открыть в песочнице

Что умеет Tripo 3D v3.1

  • Async
  • Text-to-3D

Стоимость

за запрос
Text-to-3D
39.62 ₽
Image-to-3D
52.82 ₽

Цены указаны в рублях и списываются с баланса проекта за успешные запросы. Надбавки (+) суммируются с базовой ставкой.

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

Vendor
tripo
Modality
object3d

Tripo 3D v3.1 API для высокоточной генерации 3D-моделей

Tripo 3D v3.1 — флагманская модель провайдера Tripo из Китая, представленная 11 марта 2026 года. Она создает детализированные 3D-модели по тексту, одному изображению или набору ракурсов. Модель поддерживает сетки до 2 миллионов полигонов, PBR-материалы и текстуры, поэтому подходит для 3D-печати, визуализации и сложных производственных задач.

Параметры запроса

Параметры, которые принимает модель. Передаются в теле запроса.

ПараметрТипДиапазон / значенияПо умолчаниюОписание
positivePrompt
string
max: 1024
—
Текстовый промпт описывающий желаемый 3D-объект. Несовместим с inputs.images (выбери text-to-3D или image-to-3D).
1 пример
Примеры
Игрушка-робот с большими глазами и антенной, мультяшный стиль.
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.
1 пример
Примеры
[
  "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-уведомления при готовности.
1 пример
Примеры
https://yourapp.com/webhooks/runware
uploadEndpoint
string
—
—
Presigned URL для автозагрузки готового .glb.
1 пример
Примеры
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
—

Пример кода

tripo-v3-1-0_example.py
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,
    "numberResults": 1,
    "outputType": "URL",
    "outputFormat": "GLB",
    "webhookURL": "https://example.com/...",
    "uploadEndpoint": "value",
    "inputs": {
        "images": []
    },
    "settings": {
        "autoSize": False,
        "compress": "meshopt",
        "exportUv": True,
        "faceLimit": 10250,
        "generateParts": False,
        "geometryQuality": "standard",
        "imageAutoFix": False,
        "orientation": "default",
        "pbr": True,
        "quad": False,
        "smartLowPoly": False,
        "texture": True,
        "textureAlignment": "original_image",
        "textureQuality": "standard",
        "textureSeed": 10120460
    }
},
)
print(r.json())
Полная документация модели

Частые вопросы о Tripo 3D v3.1

Tripo 3D v3.1 — модель генерации 3D-объектов по тексту, изображению или нескольким ракурсам. Она создает mesh с текстурами и PBR-материалами.
Модель помогает быстро получать детализированные 3D-активы для визуализации, 3D-печати и производства, сокращая время на создание исходной геометрии.
Подключить API Tripo 3D v3.1 можно через Ranvik API. Сервис дает удобный доступ к модели для интеграции генерации 3D в приложения и продукты.
Используйте Ranvik API: сервис позволяет работать с API Tripo 3D v3.1 в России без VPN. Получите ключ, отправьте запрос с текстом или изображением и дождитесь результата.
Да, через Ranvik API доступна оплата в российских рублях. Это упрощает подключение Tripo 3D v3.1 для команд, студий и разработчиков из России.
Tripo 3D v3.1 принимает текстовые описания, одиночные изображения и multiview-входы. Это позволяет выбрать удобный сценарий генерации под конкретную задачу.