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

Tripo H3.1 Image to 3D

Интеграция

ID модели tripo3d/h3.1/image-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/image-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# 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,30 $ 300 API-кредитов · ≈ 32,27 ₽ ваши файлы измеряются перед запуском Запустить на этой странице

Получить API-ключ
Tripo Изображение в 3D #3d#image-to-3d#3d-generation#tripo

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

Tripo · 3D

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

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

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

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

•обязательно image_url
Перетащите файл или

URL входного изображения для создания 3D-модели.

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

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

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

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

Расширенные texture_alignment · orientation · face_limit · model_seed · texture_seed · auto_size · enable_safety_checker
texture_alignment по умолчанию original_image

Ориентир для выравнивания текстур: используйте 'geometry' для сгенерированной геометрии или 'original_image' для входного изображения.

orientation по умолчанию default

Ориентация модели; 'align_image' автоматически поворачивает её в соответствии с входным изображением.

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

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

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

POST /run/tripo3d/h3.1/image-to-3d?wait=20 стоимость → 0,30 $
# 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/image-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# 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 Image to 3D

Создаёт 3D-модель из одного изображения по адресу `image_url`. Доступны `face_limit` (от 1,000 до 2,000,000), `texture`, `pbr`, стандартное или детальное качество `texture_quality` и `geometry_quality`, топология `quad`, `auto_size` и `orientation`. Результат включает превью-рендер и ID задачи для последующего риггинга.

Параметры

Передавайте либо каноническое имя, либо исходное имя, но не оба. Канонические имена

ИмяТип По умолчаниюДопустимые значения Описание
image_urlобязательно image
Типurl · image
URL входного изображения для создания 3D-модели.
face_limitнеобязательно
Типinteger | null
1 000 – 2 000 000
Явно заданное целевое количество граней для генерации сетки, заменяющее адаптивный выбор количества моделью.
textureнеобязательно
Типboolean
По умолчаниюtrue
Определяет, получает ли модель сгенерированные текстуры.
pbrнеобязательно
Типboolean
По умолчаниюtrue
Включает материалы PBR (Physically Based Rendering), что также включает генерацию текстур при значении true.
model_seedнеобязательно
Типinteger | null
Сид, используемый для воспроизводимости генерации геометрии.
texture_seedнеобязательно
Типinteger | null
Сид, используемый для воспроизводимости генерации текстур.
texture_qualityнеобязательно
Типenum
По умолчаниюstandard
standarddetailed
Настройка качества текстур; выбор 'detailed' повышает разрешение текстур.
geometry_qualityнеобязательно
Типenum
По умолчаниюstandard
standarddetailed
Настройка качества геометрии.
texture_alignmentнеобязательно
Типenum
По умолчаниюoriginal_image
original_imagegeometry
Ориентир для выравнивания текстур: используйте 'geometry' для сгенерированной геометрии или 'original_image' для входного изображения.
auto_sizeнеобязательно
Типboolean
По умолчаниюfalse
Автоматическое масштабирование для задания реальных размеров модели в метрах.
orientationнеобязательно
Типenum
По умолчаниюdefault
defaultalign_image
Ориентация модели; 'align_image' автоматически поворачивает её в соответствии с входным изображением.
quadнеобязательно
Типboolean
По умолчаниюfalse
Выбор между треугольными гранями и четырёхугольниками с помощью топологии quad. Для результатов с quad возвращается файл FBX, если Tripo предоставляет данные в виде байтов FBX.
enable_safety_checkerнеобязательно
Типboolean
По умолчаниюtrue
Проверку можно ослабить, установив false, если вызывающая сторона авторизована.
обязательно Каноническое имя, также принимается

Параметры файлов принимают общедоступный https:// URL, data: URI размером до 10 MB или file_url загруженного файла. Файлы

Результат

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "tripo3d/h3.1/image-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": 300,
    "usd": "0.30",
    "charged": 300,
    "refunded": 0
  },
  "input": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "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/developers/models/tripo3d/h3.1/image-to-3d.md. Все модели и руководства: https://doitong.com/developers/llms.txt