Мультивид в 3D-модель

POST /v3/generation/multiview-to-model

Создайте 3D-модель из многовидовых изображений.

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

Заголовки запросов

Параметр	Тип	Требуется	По умолчанию	Описание
Content-Type	строка	Да	-	`application/json`
Authorization	строка	Да	-	`Bearer {api_key}`

Тело запроса

Параметр	Тип	Требуется	По умолчанию	Описание
inputs	объект[] \	строка[4]	Да	-
model	строка	Нет	`tripo-v3.1`	Версия модели AI. Поддерживаемые значения: `tripo-p1`, `tripo-turbo`, `tripo-v3.1`, `tripo-v3.0`, `tripo-v2.5`, `tripo-v2.0`.
face_limit	целое число	Нет	Адаптивный	Максимальный полисчет для вывода
texture	логическое значение	Нет	`true`	Включить текстурные карты
pbr	логическое значение	Нет	`true`	Включите материалы PBR. При включении `texture` принудительно переключается на `true`.
texture_seed	целое число	Нет	Случайный	Случайное начальное значение для генерации текстур
texture_quality	строка	Нет	`standard`	Качество текстур. Поддерживаемые значения: `standard`, `detailed`, `extreme`.
geometry_quality	строка	Нет	`standard`	Качество геометрии. `standard` (сбалансированный), `detailed` (ультрарежим)
auto_size	логическое значение	Нет	`false`	Автоматически масштабировать модель до реальных размеров в метрах.
quad	логическое значение	Нет	`false`	Выведите четырехугольную сетку. Если этот параметр включен, формат вывода принудительно устанавливается на FBX.
smart_low_poly	логическое значение	Нет	`false`	Создайте низкополигональную модель с созданным вручную стилем топологии.
generate_parts	логическое значение	Нет	`false`	Создавайте редактируемые сегментированные части. Взаимоисключающе с `texture=true`, `pbr=true` и `quad=true`.
compress	строка	Нет	-	Тип сжатия. `geometry` (сжатие сети)

Следующие параметры действительны только при model >= tripo-v3.0: texture_quality, geometry_quality, auto_size, quad, smart_low_poly, generate_parts, compress.

входные форматы

клавиша просмотра (рекомендуется)

Каждый элемент массива представляет собой объект с ровно одним ключом из числа front, left, back или right. Порядок не имеет значения; сервер канонизируется до [front, left, back, right]. front является обязательным; как минимум два представления должны быть непустыми.

С URL:

JSON

{
  "inputs": [
    {"front": "https://example.com/front.png"},
    {"back": "https://example.com/back.png"},
    {"right": "https://example.com/right.png"}
  ],
  "model": "tripo-v3.1",
  "texture": false,
  "geometry_quality": "detailed"}

С file_tokens (полученным через файл загрузки API):

JSON

{
  "inputs": [
    {"front": "3154b4b0-4647-4032-aa82-827441ae92ef"},
    {"back": "58ea3eab-6a08-4deb-98f9-e60f1802954d"},
    {"right": "584b0e07-8576-4eb4-bf49-2e149e0252f6"}
  ],
  "model": "tripo-v3.1",
  "texture": false,
  "geometry_quality": "detailed"}

наследие позиционного

Ровно четыре строки в порядке [front, left, back, right]. Используйте пустую строку "", чтобы пропустить просмотр.

JSON

{
  "inputs": [
    "file_front_token",
    "",
    "https://example.com/back.png",
    "https://example.com/right.png"]
}

task_id (повторное использование задачи с несколькими представлениями)

Передайте ID предыдущей задачи generate_multiview_image или edit_multiview_image, чтобы повторно использовать ее выходные данные с 4 представлениями для создания 3D-изображений. inputs должен быть одноэлементным массивом с одним объектом task_id — не смешивайте его с ключом просмотра или позиционными слотами. Исходная задача должна находиться в состоянии success.

JSON

{
  "inputs": [
    {"task_id": "550e8400-e29b-41d4-a716-446655440000"}
  ],
  "model": "v3.1-20260211",
  "texture": true,
  "pbr": true
}

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

-cmd">curl -X POST https://openapi.tripo3d.ai/v3/generation/multiview class="hl-flag">-to-model \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {api_key}" \
  -d '{
    "inputs": [
      "https://example.com/front.png",
      "https://example.com/back.png",
      "https://example.com/left.png",
      "https://example.com/right.png"],
    "model": "tripo-v3.1",
    "texture": true,
    "pbr": true,
    "texture_quality": "detailed"}'

import requests

url = "https://openapi.tripo3d.ai/v3/generation/multiview-to-model"
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer {api_key}"
}
payload = {
    "inputs": [
        "https://example.com/front.png",
        "https://example.com/back.png",
        "https://example.com/left.png",
        "https://example.com/right.png"
    ],
    "model": "tripo-v3.1",
    "texture": True,
    "pbr": True,
    "texture_quality": "detailed"
}

response = requests.post(url, headers=headers, json=payload)
print(response.json())

const url = "https://openapi.tripo3d.ai/v3/generation/multiview-to-model";

const response = await fetch(url, {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer {api_key}"
  },
  body: JSON.stringify({
    inputs: [
      "https://example.com/front.png",
      "https://example.com/back.png",
      "https://example.com/left.png",
      "https://example.com/right.png"
    ],
    model: "tripo-v3.1",
    texture: true,
    pbr: true,
    texture_quality: "detailed"
  })
});

const data = await response.json();
console.log(data);

Ответ

Успешный ответ

JSON

{
  "code": 0,
  "data": {
    "task_id": "task_abc123"}
}

Поля ответа

Параметр	Тип	Описание
code	целое число	Код состояния. `0` указывает на успех.
data.task_id	строка	Уникальный идентификатор задачи, используемый для запроса хода создания и результатов.

Коды ошибок

HTTP Код состояния	Код ошибки	Описание	Рекомендация
429	2000	Превышен лимит генерации	Уменьшите частоту запросов и повторите попытку позже.
400	2002	Неподдерживаемый параметр запроса	Проверьте имена параметров тела запроса и диапазоны значений.
400	2003	Входной файл пуст	Убедитесь, что загруженный файл не пуст или что URL доступен.
400	2004	Неподдерживаемый тип файла	Используйте поддерживаемый формат изображения (PNG, JPEG, WebP)
400	2008	Ввод нарушает политику в отношении контента	Замените входное изображение и удалите контент, нарушающий правила.
403	2010	Недостаточно кредитов	Добавьте кредиты и повторите попытку.
400	2015	Версия модели устарела	Обновите `model` до поддерживаемой на данный момент версии.
400	2018	Модель слишком сложна для повторного создания сетки.	Уменьшите `face_limit` или упростите ввод