# Создать 3D-модель

> Требуемое право: three_d.

`POST https://api.kvantora.ai/v1/3d/generations`

Требуемое право: three_d. Описание или исходное изображение передаются через prompt/input или file_id/file_ids. Результат — файл 3D-модели (например, GLB). Асинхронный JSON-контракт Kvantora; не полная совместимость с OpenAI media API. Результаты возвращаются в файлах. Единица и quantity берутся из опубликованного тарифа каталога: request, image, character, page, file, document, second или minute. Оценка /v1/quotes относится ко всему заданию. Неизвестная стоимость блокирует запуск до резерва. Входные файлы принадлежат владельцу ключа и проходят проверку; параметры должны поддерживаться моделью.

## Параметры

- `Idempotency-Key` (header, обязательный): Один стабильный ключ на логический запрос. Повторяйте с тем же телом и тем же credential/endpoint. Новый ключ создаёт новый запрос.

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

```bash
curl --request POST \
  --url "https://api.kvantora.ai/v1/3d/generations" \
  --header "Authorization: Bearer $KVANTORA_API_KEY" \
  --header "Idempotency-Key: $REQUEST_ID" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "<public_api_id>",
  "prompt": "Деревянный стул в скандинавском стиле"
}'
```

## Ответы

- 200: Повтор уже завершённого задания
- 202: Задание принято
- default: Ошибка проверки, прав, лимита или доступности. Код error.code; результат запроса при неизвестном исходе не следует считать отменённым.