Tripo P2 (text-to-3D)

tripo-p2-text

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

от 160 ₽ / запрос

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

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

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

Провайдерtripo

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

ID для запросовtripo-p2-text

Возможности

Async
Text-to-3D

Цены

Единица	Цена
за запрос · No textures	160 ₽
за запрос · fast	176 ₽
за запрос · standard	176 ₽
за запрос · detailed	192 ₽
за запрос · Maximum safe reserve	207 ₽
за запрос · extreme	207 ₽

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

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

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

Параметр	Тип	Диапазон / values	Default	Описание
`prompt`required	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	—

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

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

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