Tripo 3D v3.1

ПровайдерTripo

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

asynctext_to_3d

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

Tripo 3D v3.1 Открыть в Playground

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

Async
Text-to-3D

Стоимость

за запрос

Text-to-3D

84 ₽

Image-to-3D

112 ₽

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

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

Vendor

tripo

Modality

object3d

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

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

ПараметрТипДиапазон / значенияПо умолчаниюОписание

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,
    "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())

Полная документация модели