Tripo P2 (text-to-3D) API

ПровайдерTripo

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

asynctext_to_3d

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

Tripo P2 (text-to-3D) Открыть в песочнице

Что умеет Tripo P2 (text-to-3D)

Async
Text-to-3D

Стоимость

за запрос

No textures

160 ₽

fast

176 ₽

standard

176 ₽

detailed

192 ₽

Maximum safe reserve

207 ₽

extreme

207 ₽

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

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

Vendor

tripo

Modality

object3d

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

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

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

promptreq

string

min: 1 · max: 1024

—

Описание одного 3D-объекта.

negative_prompt

string

max: 255

—

Что исключить из результата.

texture

boolean

—

true

Создать текстуры. Для модели без текстур также отключите pbr.

pbr

boolean

—

true

Создать PBR-материалы; включает стоимость текстур.

texture_quality

enum

fast, standard, detailed, extreme

standard

Качество текстур. Для fast укажите texture_version=v3.5-20260815.

texture_version

enum

v3.5-20260815, v3.0-20250812, v2.5-20250123

—

Версия генератора текстур; v3.5-20260815 обязательна для fast.

face_limit

integer

min: 48 · max: 50000

—

Лимит граней; при quad=true максимум 25000.

quad

boolean

—

false

Сетка из квадов.

delight

boolean

—

true

Удалить запеченный свет; применяется с texture_version=v3.5-20260815.

auto_size

boolean

—

false

Автоматический реальный масштаб.

export_uv

boolean

—

true

Добавить UV-координаты.

model_seed

integer

—

—

Seed геометрии.

texture_seed

integer

—

—

Seed текстуры.

image_seed

integer

—

—

Seed промежуточного изображения в текстовом режиме.

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

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

Async (HTTP 202)

HTTP 202: сохраните id задачи для опроса.

ПолеТипЗначенияОписание

id

string

—

status

string

—

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

GET /v1/tasks/{id}: статус и URL результата.

ПолеТипЗначенияОписание

status

string

—

data

array

—

Каждый элемент:

url— string

error

string

—

Пример кода

tripo-p2-text_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-p2-text",
    "prompt": "Пример промпта",
    "negative_prompt": "Пример промпта",
    "texture": True,
    "pbr": True,
    "texture_quality": "standard",
    "texture_version": "v3.5-20260815",
    "face_limit": 25024,
    "quad": False,
    "delight": True,
    "auto_size": False,
    "export_uv": True,
    "model_seed": 1,
    "texture_seed": 1,
    "image_seed": 1
},
)
print(r.json())

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