Перейти к содержимому

Tripo H3.1 Text to 3D

Интеграция

ID модели tripo3d/h3.1/text-to-3d
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/tripo3d/h3.1/text-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Файлы, как в примере: 0,20 $ 200 API-кредитов · ≈ 21,31 ₽ ваши файлы измеряются перед запуском Запустить на этой странице

Получить API-ключ
Tripo Текст в 3D #3d#text-to-3d#3d-generation#tripo

Генератор 3D-сеток из текста с негативным промптом, отдельными уровнями качества геометрии и текстуры и очень высоким лимитом граней

Tripo · 3D

Здесь появится ваш первый результат

Составьте запрос ниже и выполните его с помощью API-ключа. Результаты копируются в наше хранилище и хранятся навсегда или 7 дней бесплатно.

Сформировать запрос

Элементы управления сгенерированы из схемы модели. Код и цена обновляются при изменении параметров.

•обязательно 88 / 1024

Текстовое описание нужного 3D-объекта длиной не более 1024 символов.

texture_quality по умолчанию standard

Настройка качества текстур; выбор 'detailed' повышает разрешение текстур.

geometry_quality по умолчанию standard

Настройка качества геометрии.

Расширенные negative_prompt · face_limit · model_seed · image_seed · texture_seed · auto_size · enable_safety_checker
0 / 1024

Описание признаков, которые нужно исключить из сгенерированной модели.

Явно заданное целевое количество граней для генерации сетки, заменяющее адаптивный выбор количества моделью.

Сид, используемый для воспроизводимости генерации геометрии.

Сид, используемый на этапе преобразования текста в изображение.

Сид, используемый для воспроизводимости генерации текстур.

POST /run/tripo3d/h3.1/text-to-3d?wait=20 стоимость → 0,20 $
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/tripo3d/h3.1/text-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Запустить этот запрос

Ваш ключ хранится в этом браузере: он отправляется только в Doitong API и сохраняется в localStorage только при включении параметра «Запомнить». Получить API-ключ

О Tripo H3.1 Text to 3D

Создаёт 3D-модель из текстового описания длиной до 1024 символов с необязательным `negative_prompt` для исключения нежелательных признаков. `face_limit` принимает от 1,000 до 2,000,000 граней. `geometry_quality` и `texture_quality` могут быть standard или detailed. Доступны материалы PBR, квадротопология, автоматическое масштабирование до реального размера и отдельные сиды для геометрии, шага преобразования текста в изображение и текстуры.

Параметры

ИмяТип По умолчаниюДопустимые значения Описание
promptобязательно
Типstring
≤ 1 024 символа
Текстовое описание нужного 3D-объекта длиной не более 1024 символов.
negative_promptнеобязательно
Типstring | null
≤ 1 024 символа
Описание признаков, которые нужно исключить из сгенерированной модели.
face_limitнеобязательно
Типinteger | null
1 000 – 2 000 000
Явно заданное целевое количество граней для генерации сетки, заменяющее адаптивный выбор количества моделью.
textureнеобязательно
Типboolean
По умолчаниюtrue
Определяет, получает ли модель сгенерированные текстуры.
pbrнеобязательно
Типboolean
По умолчаниюtrue
Включает материалы PBR (Physically Based Rendering), что также включает генерацию текстур при значении true.
model_seedнеобязательно
Типinteger | null
Сид, используемый для воспроизводимости генерации геометрии.
image_seedнеобязательно
Типinteger | null
Сид, используемый на этапе преобразования текста в изображение.
texture_seedнеобязательно
Типinteger | null
Сид, используемый для воспроизводимости генерации текстур.
texture_qualityнеобязательно
Типenum
По умолчаниюstandard
standarddetailed
Настройка качества текстур; выбор 'detailed' повышает разрешение текстур.
geometry_qualityнеобязательно
Типenum
По умолчаниюstandard
standarddetailed
Настройка качества геометрии.
auto_sizeнеобязательно
Типboolean
По умолчаниюfalse
Автоматическое масштабирование для задания реальных размеров модели в метрах.
quadнеобязательно
Типboolean
По умолчаниюfalse
Выбор между треугольными гранями и четырёхугольниками с помощью топологии quad. Для результатов с quad возвращается файл FBX, если Tripo предоставляет данные в виде байтов FBX.
enable_safety_checkerнеобязательно
Типboolean
По умолчаниюtrue
Проверку можно ослабить, установив false, если вызывающая сторона авторизована.
обязательно

Результат

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "tripo3d/h3.1/text-to-3d",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 200,
    "usd": "0.20",
    "charged": 200,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  },
  "output": {
    "model_mesh": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_name": "0-output.jpeg",
      "file_size": 1843200
    },
    "model_urls": {
      "glb": {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200
      },
      "fbx": {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200
      },
      "base_model": {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200
      },
      "pbr_model": {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200
      }
    },
    "rendered_image": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_name": "0-output.jpeg",
      "file_size": 1843200
    },
    "task_id": "string"
  },
  "outputs": [
    {
      "type": "file",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Ваши файлы — ваш выборКаждый URL из outputs[].url — это копия в нашем хранилище: она хранится навсегда (оплата за ГБ в месяц) или 7 дней бесплатно — в зависимости от настройки вашего аккаунта или параметра ?storage=.
Одинаковая структура у каждой моделиtype, url, content_type, width, height и duration — одинаково для изображений, видео и аудио. output — собственный объект результата модели.
Поля результата
model_mesh
object {url, content_type, file_name, file_size}Файл GLB или FBX, содержащий сгенерированную 3D-модель; формат определяется результатом Tripo.
model_urls
object {glb, fbx, base_model, pbr_model}URL-адреса альтернативных версий 3D-модели.
rendered_image
object {url, content_type, file_name, file_size} | nullОтрендеренный предварительный просмотр сгенерированной 3D-модели.
task_id
string | nullМногоразовый идентификатор задачи Tripo, указывающий на сгенерированную модель для rig или rig-check и позволяющий выполнять эти операции без повторной загрузки модели.

Другие модели: Текст в 3D

Для AI-агентов: эта страница в формате Markdown доступна по адресу https://doitong.com/ru/developers/models/tripo3d/h3.1/text-to-3d.md. Все модели и руководства: https://doitong.com/developers/llms.txt