# Tripo 3.0 API
> 3D-модели Tripo 3.0 по описанию, по одному фото или по нескольким ракурсам объекта. Максимальная детализация и все настройки модели.
Ключ модели в API: `tripo3d`
## Подключение в три шага
1. [Получите ключ](https://api.cyhub.ai/docs/connection.md?lang=ru): Ключ создаётся в кабинете после подтверждения почты. Один ключ открывает все модели.
2. [Узнайте цену](https://api.cyhub.ai/docs/generations.md?lang=ru): POST /v1/price считает стоимость запуска заранее, деньги при этом не списываются.
3. [Запустите задачу и заберите результат](https://api.cyhub.ai/docs/tasks.md?lang=ru): POST /v1/tasks ставит задачу, GET /v1/tasks/{id} показывает её статус и файлы.
## Готовый код
Замените YOUR_API_KEY своим ключом. Код ставит задачу и ждёт результата. В cURL второй запрос повторяйте, подставив вместо TASK_ID поле id из ответа первого, пока status не станет succeeded.
```bash
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": "v3.0-20250812"
}
}'
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": "v3.0-20250812",
},
}
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"])
```
```javascript
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": "v3.0-20250812"
}
};
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();
```
[Получить ключ](https://cyhub.ai/cabinet/keys)
## Цена до запуска
Цены на 15.10.2026: от 15 ₽. Точную цену своих настроек покажет POST /v1/price.
Отправьте те же настройки в POST /v1/price: ответ покажет цену запуска, деньги при этом не списываются.
```bash
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": "v3.0-20250812"
}
}'
```
- amount_minor: цена запуска в копейках (для рублей)
- currency: валюта кошелька
- available_minor: сколько сейчас доступно на балансе для новых задач
## По описанию
> Модель по текстовому описанию, без картинок.
Значение поля task_type: `text_to_model`
На этой странице версия Tripo 3.0: передайте model_version = v3.0-20250812. Без поля model_version запустится v3.1-20260211.
Цена в этом режиме от 15 ₽.
### Параметры
Параметры модели передаются внутри settings. Пропущенные необязательные поля берут значение по умолчанию.
#### `model_version` (Необязательно)
Версия модели. v3.1 и v3.0 самые детальные и со всеми настройками. У v2.5 и P1 часть настроек недоступна, P1 для низкополигональных моделей.
- Тип: Строка
- Допустимые значения: `v3.0-20250812` (v3.0)
- По умолчанию: `"v3.1-20260211"`
#### `texture` (Необязательно)
Модель с текстурой. Без неё только форма.
- Тип: Да/нет
- По умолчанию: `true`
#### `pbr` (Необязательно)
Реалистичные материалы с отражениями и бликами. Включает и текстуру.
- Тип: Да/нет
- По умолчанию: `true`
#### `texture_quality` (Необязательно)
Качество текстуры. HD детальнее, цена выше. HD есть только у версий v3.1, v3.0 и P1.
- Тип: Строка
- Допустимые значения: `standard` (Стандартное), `detailed` (HD (детализированное))
- По умолчанию: `"standard"`
#### `geometry_quality` (Необязательно)
Качество формы. Ultra детальнее, дольше и дороже, только у v3.1 и v3.0.
- Тип: Строка
- Допустимые значения: `standard` (Стандартное), `detailed` (Ultra (максимальная детализация))
- По умолчанию: `"standard"`
#### `face_limit` (Необязательно)
Сколько полигонов в модели. Не задано: подбирается само. Допустимый предел зависит от версии и настроек: у P1 от 50 до 20 000, у smart low-poly от 500 до 20 000.
- Тип: Целое число
- Минимум: 48
- Максимум: 2000000
#### `auto_size` (Необязательно)
Привести модель к реальным размерам в метрах. Есть только у версий v3.1, v3.0 и P1.
- Тип: Да/нет
- По умолчанию: `false`
#### `orientation` (Необязательно)
Поворот готовой модели: обычный или как на исходном фото. Действует только у модели по фото или по ракурсам и только с текстурой.
- Тип: Строка
- Допустимые значения: `default` (По умолчанию), `align_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": "v3.0-20250812"
}
}
```
Цена считается при приёме задачи, валюта `RUB`.
[Полный пример запуска](https://api.cyhub.ai/docs/generations.md?lang=ru)
### Результат
- Файл 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"
}
]
}
}
```
[Как читать результат и скачивать файлы](https://api.cyhub.ai/docs/tasks.md?lang=ru#result)
## По фото
> Модель по одному фото объекта. Лучше всего фото с чистым фоном, объект целиком.
Значение поля task_type: `image_to_model`
На этой странице версия Tripo 3.0: передайте model_version = v3.0-20250812. Без поля model_version запустится v3.1-20260211.
Цена в этом режиме от 29 ₽.
### Параметры
Параметры модели передаются внутри settings. Пропущенные необязательные поля берут значение по умолчанию.
#### `model_version` (Необязательно)
Версия модели. v3.1 и v3.0 самые детальные и со всеми настройками. У v2.5 и P1 часть настроек недоступна, P1 для низкополигональных моделей.
- Тип: Строка
- Допустимые значения: `v3.0-20250812` (v3.0)
- По умолчанию: `"v3.1-20260211"`
#### `texture` (Необязательно)
Модель с текстурой. Без неё только форма.
- Тип: Да/нет
- По умолчанию: `true`
#### `pbr` (Необязательно)
Реалистичные материалы с отражениями и бликами. Включает и текстуру.
- Тип: Да/нет
- По умолчанию: `true`
#### `texture_quality` (Необязательно)
Качество текстуры. HD детальнее, цена выше. HD есть только у версий v3.1, v3.0 и P1.
- Тип: Строка
- Допустимые значения: `standard` (Стандартное), `detailed` (HD (детализированное))
- По умолчанию: `"standard"`
#### `geometry_quality` (Необязательно)
Качество формы. Ultra детальнее, дольше и дороже, только у v3.1 и v3.0.
- Тип: Строка
- Допустимые значения: `standard` (Стандартное), `detailed` (Ultra (максимальная детализация))
- По умолчанию: `"standard"`
#### `face_limit` (Необязательно)
Сколько полигонов в модели. Не задано: подбирается само. Допустимый предел зависит от версии и настроек: у P1 от 50 до 20 000, у smart low-poly от 500 до 20 000.
- Тип: Целое число
- Минимум: 48
- Максимум: 2000000
#### `auto_size` (Необязательно)
Привести модель к реальным размерам в метрах. Есть только у версий v3.1, v3.0 и P1.
- Тип: Да/нет
- По умолчанию: `false`
#### `orientation` (Необязательно)
Поворот готовой модели: обычный или как на исходном фото. Действует только у модели по фото или по ракурсам и только с текстурой.
- Тип: Строка
- Допустимые значения: `default` (По умолчанию), `align_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_image` (По изображению), `geometry` (По геометрии)
- По умолчанию: `"original_image"`
#### `enable_image_autofix` (Необязательно)
Сначала подправить фото для лучшего результата.
- Тип: Да/нет
- По умолчанию: `false`
Параметры, которых нет в списке, не принимаются: ответ 422 unknown_setting.
### Входные данные
- Фото передаются ссылками на JPEG или PNG до 20 МБ.
| Поле | Что принимает | Форматы | Файлов | Размер файла до |
|---|---|---|---|---|
| `image_url` | Картинки | jpeg, jpg, png | 1 | 20 МБ |
[Как передать файлы](https://api.cyhub.ai/docs/files.md?lang=ru)
### Пример запроса
Отправьте этот 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": "v3.0-20250812"
}
}
```
Цена считается при приёме задачи, валюта `RUB`.
[Полный пример запуска](https://api.cyhub.ai/docs/generations.md?lang=ru)
### Результат
- Файл 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"
}
]
}
}
```
[Как читать результат и скачивать файлы](https://api.cyhub.ai/docs/tasks.md?lang=ru#result)
## По ракурсам
> Модель по нескольким фото одного объекта с разных сторон: самая точная форма. Нужно фото спереди и хотя бы ещё одно, каждое в поле своей стороны. Бока считаются от самого объекта: в left_url фото, где он смотрит влево. Если перепутать бока, у модели может получиться второй перед вместо спины.
Значение поля task_type: `multiview_to_model`
На этой странице версия Tripo 3.0: передайте model_version = v3.0-20250812. Без поля model_version запустится v3.1-20260211.
Цена в этом режиме от 29 ₽.
### Параметры
Параметры модели передаются внутри settings. Пропущенные необязательные поля берут значение по умолчанию.
#### `model_version` (Необязательно)
Версия модели. v3.1 и v3.0 самые детальные и со всеми настройками. У v2.5 и P1 часть настроек недоступна, P1 для низкополигональных моделей.
- Тип: Строка
- Допустимые значения: `v3.0-20250812` (v3.0)
- По умолчанию: `"v3.1-20260211"`
#### `texture` (Необязательно)
Модель с текстурой. Без неё только форма.
- Тип: Да/нет
- По умолчанию: `true`
#### `pbr` (Необязательно)
Реалистичные материалы с отражениями и бликами. Включает и текстуру.
- Тип: Да/нет
- По умолчанию: `true`
#### `texture_quality` (Необязательно)
Качество текстуры. HD детальнее, цена выше. HD есть только у версий v3.1, v3.0 и P1.
- Тип: Строка
- Допустимые значения: `standard` (Стандартное), `detailed` (HD (детализированное))
- По умолчанию: `"standard"`
#### `geometry_quality` (Необязательно)
Качество формы. Ultra детальнее, дольше и дороже, только у v3.1 и v3.0.
- Тип: Строка
- Допустимые значения: `standard` (Стандартное), `detailed` (Ultra (максимальная детализация))
- По умолчанию: `"standard"`
#### `face_limit` (Необязательно)
Сколько полигонов в модели. Не задано: подбирается само. Допустимый предел зависит от версии и настроек: у P1 от 50 до 20 000, у smart low-poly от 500 до 20 000.
- Тип: Целое число
- Минимум: 48
- Максимум: 2000000
#### `auto_size` (Необязательно)
Привести модель к реальным размерам в метрах. Есть только у версий v3.1, v3.0 и P1.
- Тип: Да/нет
- По умолчанию: `false`
#### `orientation` (Необязательно)
Поворот готовой модели: обычный или как на исходном фото. Действует только у модели по фото или по ракурсам и только с текстурой.
- Тип: Строка
- Допустимые значения: `default` (По умолчанию), `align_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_image` (По изображению), `geometry` (По геометрии)
- По умолчанию: `"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 МБ |
[Как передать файлы](https://api.cyhub.ai/docs/files.md?lang=ru)
### Пример запроса
Отправьте этот 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": "v3.0-20250812"
}
}
```
Цена считается при приёме задачи, валюта `RUB`.
[Полный пример запуска](https://api.cyhub.ai/docs/generations.md?lang=ru)
### Результат
- Файл 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"
}
]
}
}
```
[Как читать результат и скачивать файлы](https://api.cyhub.ai/docs/tasks.md?lang=ru#result)
## Смотрите также
- [Нейросеть Tripo 3.0: возможности и цены](https://api.cyhub.ai/models/tripo-3-0)
- Другие версии: [Tripo 3D API](https://api.cyhub.ai/models/tripo-3d/api.md), [Tripo 2.5 API](https://api.cyhub.ai/models/tripo-2-5/api.md)
- [Документация API](https://api.cyhub.ai/docs.md?lang=ru)
- [Ошибки API и что с ними делать](https://api.cyhub.ai/docs/errors.md?lang=ru)