Текст в 3D-модель — серия P

POST /v3/generation/text-to-model

Создайте 3D-модель из текстовой подсказки, используя модели серии P. Серия P оптимизирована для лучшей в своем классе генерации низкополигональных изображений с чистой и усовершенствованной топологией — идеально подходит для игровых ресурсов, стилизованного контента и облегченных рабочих процессов в 3D.

Ключевые отличия от стандартного

Оптимизирован для low-poly вывода (P1-20260311: 50–20 000 граней; P2-20260801: до 50 000)
Генерация сетки ~2 с со структурированной топологией
quad поддерживается только моделью P2-20260801; smart_low_poly, generate_parts и geometry_quality не поддерживаются.

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

Параметр	Тип	Требуется	По умолчанию	Описание
prompt	строка	Требуется	-	Текстовое приглашение, до 1024 символов.
negative_prompt	строка	Необязательно	-	Отрицательная подсказка, до 255 символов.
image_seed	целое число	Необязательно	случайный	Случайное начальное значение для этапа преобразования текста в изображение
model	строка	Требуется	-	Версия модели серии P. Значения: `P1-20260311` (оптимизирована для low-poly), `P2-20260801` (новое поколение, поддерживает вывод quad; Preview)
model_seed	целое число	Необязательно	случайный	Случайное начальное значение для генерации геометрии
face_limit	целое число	Необязательно	адаптивный	Максимальное количество полигонов. `P1-20260311`: 50–20 000; `P2-20260801` треугольники: 48–50 000, при `quad=true`: 48–25 000
texture	логическое значение	Необязательно	правда	Включить текстурные карты
pbr	логическое значение	Необязательно	правда	Включите карты материалов PBR. Форсирует текстуру = true
texture_seed	целое число	Необязательно	случайный	Случайное начальное значение для генерации текстур
texture_quality	строка	Необязательно	стандартный	`standard`, `detailed` или `extreme`
auto_size	логическое значение	Необязательно	ложный	Масштабировать до реальных размеров (метры)
export_uv	логическое значение	Необязательно	правда	UV разворачивание. false = быстрее, файл меньшего размера
export_orientation	строка	Необязательно	`+x`	Экспортная ориентация. Доступные значения: `-x`, `-y`, `+y`.
quad	логическое значение	Необязательно	false	Только `P2-20260801`. Выводит quad-меш вместо треугольников. Формат вывода принудительно `FBX`; без `face_limit` по умолчанию 10 000 граней.

Примечания к export_orientation:

Применяется только к этой генерации. Если модель будет использоваться в задачах постобработки (текстура, риг, ретаргет, конвертация и т. д.), рекомендуется не задавать этот параметр.
Если параметр задан, постобработка может повлиять на конечный результат из-за неправильной ориентации модели, при этом задача по-прежнему сообщает status: success — ошибка не возникает. Используйте с осторожностью.
Если вы планируете постобработку модели, оставьте этот параметр незаданным и преобразуйте ориентацию на последнем шаге через /v3/models/convert.

Пример

JSON

{
  "prompt": "a low poly medieval sword",
  "model": "P1-20260311",
  "face_limit": 3000,
  "texture": true,
  "texture_quality": "detailed"
}

P2-20260801 с выводом quad:

JSON

{
  "prompt": "a low poly medieval sword",
  "model": "P2-20260801",
  "quad": true,
  "face_limit": 8000,
  "texture": true
}

Ответ

JSON

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