# Модели и версии
## 3D-модели генерации
Параметр `model`, используемый конечными точками создания 3D-изображений, такими как `POST /v3/generation/text-to-model` и `POST /v3/generation/image-to-model`.
| Модель ID | Описание | Рекомендуемый вариант использования |
| :-: | :-: | :-: |
| `tripo-p1` | Лучшая низкополигональная производительность | Игровые конвейеры / Генеративный игровой процесс UGC / Мобильные 3D-ресурсы |
| `tripo-v3.1` | Последняя высокоточная модель (по умолчанию) | AAA Производственные конвейеры / 3D-печать и гибкое производство |
| `tripo-v3.0` | Стабильная версия предыдущего поколения | Обратная совместимость |
| `tripo-v2.5` | Устаревшая версия | Совместимость исторических проектов |
## Модели генерации изображений
Параметр `model`, используемый конечными точками `POST /v3/generation/text-to-image` и `POST /v3/generation/image-to-image`.
| Модель ID | Поставщик | Характеристики |
| :-: | :-: | :-: |
| `seedream_v4` | БайтДанс | Модель по умолчанию со сбалансированными результатами |
| `seedream_v5` | БайтДанс | Последняя версия с улучшенным качеством |
| `gemini-2.5-flash` | Гугл | Быстрое поколение |
| `gemini-3-pro` | Гугл | Качественная генерация |
| `gemini-3.1-flash` | Гугл | Последняя быстрая версия |
| `chat_image_1` | ОткрытьAI | GPT создание изображения |
| `chat_image_1.5` | ОткрытьAI | GPT более высокое качество |
| `chat_image_2` | ОткрытьAI | GPT последний |
## Рекомендации по выбору версии
- **Новые проекты**: используйте версии по умолчанию: `tripo-v3.1` для 3D и `seedream_v4` для изображений, чтобы обеспечить наилучший баланс качества и стабильности.
- **Производственные среды**: закрепите конкретную версию модели, чтобы избежать несоответствий результатов, вызванных обновлениями модели.
- **Высочайшее качество**: используйте `tripo-p1` для 3D и выберите `gemini-3-pro` или `seedream_v5` для изображений в зависимости от сценария.
- **Низкополигональные/игровые ресурсы**: используйте `tripo-p1` для 3D — более чистая топология и более точный контроль количества лиц.
## Примеры запросов
```bash
# Use the default model
curl -X POST https://openapi.tripo3d.com/v3/generation/text-to-model \
-H "Content-Type: application/json" \
-H "Authorization: Bearer {api_key}" \
-d '{"prompt": "a robot"}'
# Specify the flagship model
curl -X POST https://openapi.tripo3d.com/v3/generation/text-to-model \
-H "Content-Type: application/json" \
-H "Authorization: Bearer {api_key}" \
-d '{"prompt": "a robot", "model": "tripo-p1"}'
# Use an image generation model
curl -X POST https://openapi.tripo3d.com/v3/generation/text-to-image \
-H "Content-Type: application/json" \
-H "Authorization: Bearer {api_key}" \
-d '{"prompt": "a futuristic city", "model": "seedream-v5"}'
```
Модели и версии
3D-модели генерации
Параметр model, используемый конечными точками создания 3D-изображений, такими как POST /v3/generation/text-to-model и POST /v3/generation/image-to-model.
Модель ID
Описание
Рекомендуемый вариант использования
tripo-p1
Лучшая низкополигональная производительность
Игровые конвейеры / Генеративный игровой процесс UGC / Мобильные 3D-ресурсы
tripo-v3.1
Последняя высокоточная модель (по умолчанию)
AAA Производственные конвейеры / 3D-печать и гибкое производство
tripo-v3.0
Стабильная версия предыдущего поколения
Обратная совместимость
tripo-v2.5
Устаревшая версия
Совместимость исторических проектов
Модели генерации изображений
Параметр model, используемый конечными точками POST /v3/generation/text-to-image и POST /v3/generation/image-to-image.
Модель ID
Поставщик
Характеристики
seedream_v4
БайтДанс
Модель по умолчанию со сбалансированными результатами
seedream_v5
БайтДанс
Последняя версия с улучшенным качеством
gemini-2.5-flash
Гугл
Быстрое поколение
gemini-3-pro
Гугл
Качественная генерация
gemini-3.1-flash
Гугл
Последняя быстрая версия
chat_image_1
ОткрытьAI
GPT создание изображения
chat_image_1.5
ОткрытьAI
GPT более высокое качество
chat_image_2
ОткрытьAI
GPT последний
Рекомендации по выбору версии
Новые проекты: используйте версии по умолчанию: tripo-v3.1 для 3D и seedream_v4 для изображений, чтобы обеспечить наилучший баланс качества и стабильности.
Производственные среды: закрепите конкретную версию модели, чтобы избежать несоответствий результатов, вызванных обновлениями модели.
Высочайшее качество: используйте tripo-p1 для 3D и выберите gemini-3-pro или seedream_v5 для изображений в зависимости от сценария.
Низкополигональные/игровые ресурсы: используйте tripo-p1 для 3D — более чистая топология и более точный контроль количества лиц.
Примеры запросов
Bash
# Use the default model
curl -X POST https://openapi.tripo3d.com/v3/generation/text-to-model \
-H "Content-Type: application/json" \
-H "Authorization: Bearer {api_key}" \
-d '{"prompt": "a robot"}'
# Specify the flagship model
curl -X POST https://openapi.tripo3d.com/v3/generation/text-to-model \
-H "Content-Type: application/json" \
-H "Authorization: Bearer {api_key}" \
-d '{"prompt": "a robot", "model": "tripo-p1"}'
# Use an image generation model
curl -X POST https://openapi.tripo3d.com/v3/generation/text-to-image \
-H "Content-Type: application/json" \
-H "Authorization: Bearer {api_key}" \
-d '{"prompt": "a futuristic city", "model": "seedream-v5"}'
