# Модели и версии

## 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"}'
```