Tripo 2.5 API

3D-модели Tripo 2.5 по описанию, по одному фото или по нескольким ракурсам объекта. Прежняя стабильная версия, часть настроек у неё недоступна.

Ключ модели в API: tripo3d

Для нейросети:Скачать .md Вся документация .md Открыть как текст

Подключение в три шага

Получите ключКлюч создаётся в кабинете после подтверждения почты. Один ключ открывает все модели.
Узнайте ценуPOST /v1/price считает стоимость запуска заранее, деньги при этом не списываются.
Запустите задачу и заберите результатPOST /v1/tasks ставит задачу, GET /v1/tasks/{id} показывает её статус и файлы.

Готовый код

Замените YOUR_API_KEY своим ключом. Код ставит задачу и ждёт результата. В cURL второй запрос повторяйте, подставив вместо TASK_ID поле id из ответа первого, пока status не станет succeeded.

cURLPythonNode.js

cURL

curl -X POST "https://api.cyhub.ai/v1/tasks" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "tripo3d",
  "settings": {
    "task_type": "text_to_model",
    "prompt": "Деревянный сундук с железными уголками",
    "texture_quality": "standard",
    "model_version": "v2.5-20250123"
  }
}'

curl "https://api.cyhub.ai/v1/tasks/TASK_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"

Python

import time

import requests

API = "https://api.cyhub.ai/v1"
HEADERS = {"Authorization": "Bearer YOUR_API_KEY"}

body = {
    "model": "tripo3d",
    "settings": {
        "task_type": "text_to_model",
        "prompt": "Деревянный сундук с железными уголками",
        "texture_quality": "standard",
        "model_version": "v2.5-20250123",
    },
}

response = requests.post(f"{API}/tasks", json=body, headers=HEADERS, timeout=60)
response.raise_for_status()
task = response.json()
while task["status"] in ("queued", "running"):
    time.sleep(5)
    task = requests.get(f"{API}/tasks/{task['id']}", headers=HEADERS, timeout=30).json()
print(task["status"], task["result"])

Node.js

const API = "https://api.cyhub.ai/v1";
const HEADERS = { Authorization: "Bearer YOUR_API_KEY", "Content-Type": "application/json" };

const body = {
  "model": "tripo3d",
  "settings": {
    "task_type": "text_to_model",
    "prompt": "Деревянный сундук с железными уголками",
    "texture_quality": "standard",
    "model_version": "v2.5-20250123"
  }
};

async function main() {
  let response = await fetch(`${API}/tasks`, { method: "POST", headers: HEADERS, body: JSON.stringify(body) });
  if (!response.ok) throw new Error(await response.text());
  let task = await response.json();
  while (task.status === "queued" || task.status === "running") {
    await new Promise((resolve) => setTimeout(resolve, 5000));
    response = await fetch(`${API}/tasks/${task.id}`, { headers: HEADERS });
    task = await response.json();
  }
  console.log(task.status, task.result);
}

main();

Получить ключ

Цена до запуска

Цены на 15.10.2026: от 15 ₽. Точную цену своих настроек покажет POST /v1/price.

Режим	Цена
По описанию	от 15 ₽
По фото	от 29 ₽
По ракурсам	от 29 ₽

Отправьте те же настройки в POST /v1/price: ответ покажет цену запуска, деньги при этом не списываются.

cURL

curl -X POST "https://api.cyhub.ai/v1/price" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "tripo3d",
  "settings": {
    "task_type": "text_to_model",
    "prompt": "Деревянный сундук с железными уголками",
    "texture_quality": "standard",
    "model_version": "v2.5-20250123"
  }
}'

amount_minor: цена запуска в копейках (для рублей)
currency: валюта кошелька
available_minor: сколько сейчас доступно на балансе для новых задач

Режимы

У каждого режима свои параметры и примеры. Режим выбирает поле task_type.

По описанию task_type = text_to_model
По фото task_type = image_to_model
По ракурсам task_type = multiview_to_model

По описанию

Модель по текстовому описанию, без картинок.

Значение поля task_type: text_to_model

На этой странице версия Tripo 2.5: передайте model_version = v2.5-20250123. Без поля model_version запустится v3.1-20260211.

Цена в этом режиме от 15 ₽.

Параметры

Параметры модели передаются внутри settings. Пропущенные необязательные поля берут значение по умолчанию.

model_versionНеобязательно: Версия модели. v3.1 и v3.0 самые детальные и со всеми настройками. У v2.5 и P1 часть настроек недоступна, P1 для низкополигональных моделей.
Тип: СтрокаДопустимые значения: v2.5-20250123По умолчанию: "v3.1-20260211"
textureНеобязательно: Модель с текстурой. Без неё только форма.
Тип: Да/нетПо умолчанию: true
pbrНеобязательно: Реалистичные материалы с отражениями и бликами. Включает и текстуру.
Тип: Да/нетПо умолчанию: true
texture_qualityНеобязательно: Качество текстуры. HD детальнее, цена выше. HD есть только у версий v3.1, v3.0 и P1.
Тип: СтрокаДопустимые значения: standarddetailedПо умолчанию: "standard"
geometry_qualityНеобязательно: Качество формы. Ultra детальнее, дольше и дороже, только у v3.1 и v3.0.
Тип: СтрокаДопустимые значения: standarddetailedПо умолчанию: "standard"
face_limitНеобязательно: Сколько полигонов в модели. Не задано: подбирается само. Допустимый предел зависит от версии и настроек: у P1 от 50 до 20 000, у smart low-poly от 500 до 20 000.
Тип: Целое числоМинимум: 48Максимум: 2000000
auto_sizeНеобязательно: Привести модель к реальным размерам в метрах. Есть только у версий v3.1, v3.0 и P1.
Тип: Да/нетПо умолчанию: false
orientationНеобязательно: Поворот готовой модели: обычный или как на исходном фото. Действует только у модели по фото или по ракурсам и только с текстурой.
Тип: СтрокаДопустимые значения: defaultalign_imageПо умолчанию: "default"
quadНеобязательно: Модель из четырёхугольников, удобнее для правки и анимации. Файл будет в FBX. Есть только у версий v3.1 и v3.0.
Тип: Да/нетПо умолчанию: false
smart_low_polyНеобязательно: Низкополигональная модель с аккуратной сеткой. Лучше для простых объектов. Есть только у версий v3.1 и v3.0.
Тип: Да/нетПо умолчанию: false
generate_partsНеобязательно: Модель из отдельных частей. Не сочетается с текстурой, PBR, четырёхугольниками и smart low-poly. Есть только у версий v3.1 и v3.0.
Тип: Да/нетПо умолчанию: false
promptОбязательно: Какой объект нужен. Можно на любом языке.
Тип: СтрокаМинимум символов: 1Максимум символов: 1024
negative_promptНеобязательно: Чего в модели быть не должно.
Тип: СтрокаМаксимум символов: 255

Параметры, которых нет в списке, не принимаются: ответ 422 unknown_setting.

Входные данные

Фото передаются ссылками на JPEG или PNG до 20 МБ.

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

Отправьте этот JSON в POST /v1/tasks с ключом API. Чтобы узнать цену заранее, тот же JSON можно отправить в POST /v1/price.

Модель по описанию

JSON

{
  "model": "tripo3d",
  "settings": {
    "task_type": "text_to_model",
    "prompt": "Деревянный сундук с железными уголками",
    "texture_quality": "standard",
    "model_version": "v2.5-20250123"
  }
}

Цена считается при приёме задачи, валюта RUB.

Полный пример запуска

Результат

Файл 3D-модели GLB (с четырёхугольниками FBX) и картинка-превью.
Генерация занимает несколько минут.

Вид (kind)	Форматы	Сколько	Пояснение
`image`	png, jpg, webp	0 или 1	Картинка-превью модели, если Tripo её прислал.
`document`	glb, fbx	1	Файл 3D-модели: FBX при quad = true, иначе GLB.

Так выглядит готовая задача в ответе GET /v1/tasks/{id} (часть полей опущена). Подпись caption бывает у задачи или у отдельного файла и может быть пустой, имя файла задаёт модель.

JSON

{
  "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "status": "succeeded",
  "finished_at": "2026-10-01T12:03:41+00:00",
  "result": {
    "caption": "Подпись к результату: модель и настройки",
    "texts": [],
    "files_expire_at": "2026-10-08T12:03:41+00:00",
    "files_expired": false,
    "artifacts": [
      {
        "index": 0,
        "kind": "image",
        "filename": "image.png",
        "size": 1843200,
        "caption": "",
        "download_path": "/v1/tasks/7c9e6679-7425-40de-944b-e07fc1f90ae7/artifacts/0"
      },
      {
        "index": 1,
        "kind": "document",
        "filename": "result.glb",
        "size": 2097152,
        "caption": "",
        "download_path": "/v1/tasks/7c9e6679-7425-40de-944b-e07fc1f90ae7/artifacts/1"
      }
    ]
  }
}

Как читать результат и скачивать файлы

По фото

Модель по одному фото объекта. Лучше всего фото с чистым фоном, объект целиком.

Значение поля task_type: image_to_model

На этой странице версия Tripo 2.5: передайте model_version = v2.5-20250123. Без поля model_version запустится v3.1-20260211.

Цена в этом режиме от 29 ₽.

Параметры

Параметры модели передаются внутри settings. Пропущенные необязательные поля берут значение по умолчанию.

model_versionНеобязательно: Версия модели. v3.1 и v3.0 самые детальные и со всеми настройками. У v2.5 и P1 часть настроек недоступна, P1 для низкополигональных моделей.
Тип: СтрокаДопустимые значения: v2.5-20250123По умолчанию: "v3.1-20260211"
textureНеобязательно: Модель с текстурой. Без неё только форма.
Тип: Да/нетПо умолчанию: true
pbrНеобязательно: Реалистичные материалы с отражениями и бликами. Включает и текстуру.
Тип: Да/нетПо умолчанию: true
texture_qualityНеобязательно: Качество текстуры. HD детальнее, цена выше. HD есть только у версий v3.1, v3.0 и P1.
Тип: СтрокаДопустимые значения: standarddetailedПо умолчанию: "standard"
geometry_qualityНеобязательно: Качество формы. Ultra детальнее, дольше и дороже, только у v3.1 и v3.0.
Тип: СтрокаДопустимые значения: standarddetailedПо умолчанию: "standard"
face_limitНеобязательно: Сколько полигонов в модели. Не задано: подбирается само. Допустимый предел зависит от версии и настроек: у P1 от 50 до 20 000, у smart low-poly от 500 до 20 000.
Тип: Целое числоМинимум: 48Максимум: 2000000
auto_sizeНеобязательно: Привести модель к реальным размерам в метрах. Есть только у версий v3.1, v3.0 и P1.
Тип: Да/нетПо умолчанию: false
orientationНеобязательно: Поворот готовой модели: обычный или как на исходном фото. Действует только у модели по фото или по ракурсам и только с текстурой.
Тип: СтрокаДопустимые значения: defaultalign_imageПо умолчанию: "default"
quadНеобязательно: Модель из четырёхугольников, удобнее для правки и анимации. Файл будет в FBX. Есть только у версий v3.1 и v3.0.
Тип: Да/нетПо умолчанию: false
smart_low_polyНеобязательно: Низкополигональная модель с аккуратной сеткой. Лучше для простых объектов. Есть только у версий v3.1 и v3.0.
Тип: Да/нетПо умолчанию: false
generate_partsНеобязательно: Модель из отдельных частей. Не сочетается с текстурой, PBR, четырёхугольниками и smart low-poly. Есть только у версий v3.1 и v3.0.
Тип: Да/нетПо умолчанию: false
image_urlОбязательно: Одна ссылка на фото объекта.
Тип: Список (Строка, uri)Максимум элементов: 1
texture_alignmentНеобязательно: Как накладывать текстуру: точнее по фото или точнее по форме модели.
Тип: СтрокаДопустимые значения: original_imagegeometryПо умолчанию: "original_image"
enable_image_autofixНеобязательно: Сначала подправить фото для лучшего результата.
Тип: Да/нетПо умолчанию: false

Параметры, которых нет в списке, не принимаются: ответ 422 unknown_setting.

Входные данные

Фото передаются ссылками на JPEG или PNG до 20 МБ.

Поле	Что принимает	Форматы	Файлов	Размер файла до
`image_url`	Картинки	jpeg, jpg, png	1	20 МБ

Как передать файлы

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

Отправьте этот JSON в POST /v1/tasks с ключом API. Чтобы узнать цену заранее, тот же JSON можно отправить в POST /v1/price.

Модель по фото

JSON

{
  "model": "tripo3d",
  "settings": {
    "task_type": "image_to_model",
    "image_url": [
      "https://example.com/chair.png"
    ],
    "model_version": "v2.5-20250123"
  }
}

Цена считается при приёме задачи, валюта RUB.

Полный пример запуска

Результат

Файл 3D-модели GLB (с четырёхугольниками FBX) и картинка-превью.
Генерация занимает несколько минут.

Вид (kind)	Форматы	Сколько	Пояснение
`image`	png, jpg, webp	0 или 1	Картинка-превью модели, если Tripo её прислал.
`document`	glb, fbx	1	Файл 3D-модели: FBX при quad = true, иначе GLB.

JSON

{
  "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "status": "succeeded",
  "finished_at": "2026-10-01T12:03:41+00:00",
  "result": {
    "caption": "Подпись к результату: модель и настройки",
    "texts": [],
    "files_expire_at": "2026-10-08T12:03:41+00:00",
    "files_expired": false,
    "artifacts": [
      {
        "index": 0,
        "kind": "image",
        "filename": "image.png",
        "size": 1843200,
        "caption": "",
        "download_path": "/v1/tasks/7c9e6679-7425-40de-944b-e07fc1f90ae7/artifacts/0"
      },
      {
        "index": 1,
        "kind": "document",
        "filename": "result.glb",
        "size": 2097152,
        "caption": "",
        "download_path": "/v1/tasks/7c9e6679-7425-40de-944b-e07fc1f90ae7/artifacts/1"
      }
    ]
  }
}

Как читать результат и скачивать файлы

По ракурсам

Модель по нескольким фото одного объекта с разных сторон: самая точная форма. Нужно фото спереди и хотя бы ещё одно, каждое в поле своей стороны. Бока считаются от самого объекта: в left_url фото, где он смотрит влево. Если перепутать бока, у модели может получиться второй перед вместо спины.

Значение поля task_type: multiview_to_model

На этой странице версия Tripo 2.5: передайте model_version = v2.5-20250123. Без поля model_version запустится v3.1-20260211.

Цена в этом режиме от 29 ₽.

Параметры

Параметры модели передаются внутри settings. Пропущенные необязательные поля берут значение по умолчанию.

model_versionНеобязательно: Версия модели. v3.1 и v3.0 самые детальные и со всеми настройками. У v2.5 и P1 часть настроек недоступна, P1 для низкополигональных моделей.
Тип: СтрокаДопустимые значения: v2.5-20250123По умолчанию: "v3.1-20260211"
textureНеобязательно: Модель с текстурой. Без неё только форма.
Тип: Да/нетПо умолчанию: true
pbrНеобязательно: Реалистичные материалы с отражениями и бликами. Включает и текстуру.
Тип: Да/нетПо умолчанию: true
texture_qualityНеобязательно: Качество текстуры. HD детальнее, цена выше. HD есть только у версий v3.1, v3.0 и P1.
Тип: СтрокаДопустимые значения: standarddetailedПо умолчанию: "standard"
geometry_qualityНеобязательно: Качество формы. Ultra детальнее, дольше и дороже, только у v3.1 и v3.0.
Тип: СтрокаДопустимые значения: standarddetailedПо умолчанию: "standard"
face_limitНеобязательно: Сколько полигонов в модели. Не задано: подбирается само. Допустимый предел зависит от версии и настроек: у P1 от 50 до 20 000, у smart low-poly от 500 до 20 000.
Тип: Целое числоМинимум: 48Максимум: 2000000
auto_sizeНеобязательно: Привести модель к реальным размерам в метрах. Есть только у версий v3.1, v3.0 и P1.
Тип: Да/нетПо умолчанию: false
orientationНеобязательно: Поворот готовой модели: обычный или как на исходном фото. Действует только у модели по фото или по ракурсам и только с текстурой.
Тип: СтрокаДопустимые значения: defaultalign_imageПо умолчанию: "default"
quadНеобязательно: Модель из четырёхугольников, удобнее для правки и анимации. Файл будет в FBX. Есть только у версий v3.1 и v3.0.
Тип: Да/нетПо умолчанию: false
smart_low_polyНеобязательно: Низкополигональная модель с аккуратной сеткой. Лучше для простых объектов. Есть только у версий v3.1 и v3.0.
Тип: Да/нетПо умолчанию: false
generate_partsНеобязательно: Модель из отдельных частей. Не сочетается с текстурой, PBR, четырёхугольниками и smart low-poly. Есть только у версий v3.1 и v3.0.
Тип: Да/нетПо умолчанию: false
front_urlОбязательно: Фото объекта спереди. Обязательно.
Тип: Список (Строка, uri)Максимум элементов: 1
left_urlНеобязательно: Фото левого бока объекта: на фото объект смотрит влево, у персонажа к камере его левая рука.
Тип: Список (Строка, uri)Максимум элементов: 1
back_urlНеобязательно: Фото объекта сзади.
Тип: Список (Строка, uri)Максимум элементов: 1
right_urlНеобязательно: Фото правого бока объекта: на фото объект смотрит вправо, у персонажа к камере его правая рука.
Тип: Список (Строка, uri)Максимум элементов: 1
texture_alignmentНеобязательно: Как накладывать текстуру: точнее по фото или точнее по форме модели.
Тип: СтрокаДопустимые значения: original_imagegeometryПо умолчанию: "original_image"
enable_image_autofixНеобязательно: Сначала подправить фото для лучшего результата.
Тип: Да/нетПо умолчанию: false

Параметры, которых нет в списке, не принимаются: ответ 422 unknown_setting.

Входные данные

Фото передаются ссылками на JPEG или PNG до 20 МБ.

Поле	Что принимает	Форматы	Файлов	Размер файла до
`front_url`	Картинки	jpeg, jpg, png	1	20 МБ
`left_url`	Картинки	jpeg, jpg, png	1	20 МБ
`back_url`	Картинки	jpeg, jpg, png	1	20 МБ
`right_url`	Картинки	jpeg, jpg, png	1	20 МБ

Как передать файлы

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

Отправьте этот JSON в POST /v1/tasks с ключом API. Чтобы узнать цену заранее, тот же JSON можно отправить в POST /v1/price.

Модель по фото спереди и сзади

JSON

{
  "model": "tripo3d",
  "settings": {
    "task_type": "multiview_to_model",
    "front_url": [
      "https://example.com/front.png"
    ],
    "back_url": [
      "https://example.com/back.png"
    ],
    "model_version": "v2.5-20250123"
  }
}

Цена считается при приёме задачи, валюта RUB.

Полный пример запуска

Результат

Файл 3D-модели GLB (с четырёхугольниками FBX) и картинка-превью.
Генерация занимает несколько минут.

Вид (kind)	Форматы	Сколько	Пояснение
`image`	png, jpg, webp	0 или 1	Картинка-превью модели, если Tripo её прислал.
`document`	glb, fbx	1	Файл 3D-модели: FBX при quad = true, иначе GLB.

JSON

{
  "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "status": "succeeded",
  "finished_at": "2026-10-01T12:03:41+00:00",
  "result": {
    "caption": "Подпись к результату: модель и настройки",
    "texts": [],
    "files_expire_at": "2026-10-08T12:03:41+00:00",
    "files_expired": false,
    "artifacts": [
      {
        "index": 0,
        "kind": "image",
        "filename": "image.png",
        "size": 1843200,
        "caption": "",
        "download_path": "/v1/tasks/7c9e6679-7425-40de-944b-e07fc1f90ae7/artifacts/0"
      },
      {
        "index": 1,
        "kind": "document",
        "filename": "result.glb",
        "size": 2097152,
        "caption": "",
        "download_path": "/v1/tasks/7c9e6679-7425-40de-944b-e07fc1f90ae7/artifacts/1"
      }
    ]
  }
}

Как читать результат и скачивать файлы

Смотрите также

Нейросеть Tripo 2.5: возможности и цены
Другие версии: Tripo 3D API, Tripo 3.0 API
Документация API
Ошибки API и что с ними делать

Попробуйте Tripo 2.5 через API

Один ключ открывает все модели CyHUB. Оплата в рублях, цену видно до запуска.

Получить ключ API