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

Hi3D Image to 3D

Интеграция

ID модели hitem3d/hi3d/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/hitem3d/hi3d/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,50 $ 500 API-кредитов · ≈ 53,79 ₽ Запустить на этой странице

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

Построение 3D-сетки по одному изображению с выбором версий Hitem3D, портретными вариантами и множеством форматов экспорта

Hitem3D · 3D

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

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

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

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

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

Укажите входное изображение по URL как файл PNG, JPEG или WebP размером не более 20 MB.

resolution

Разрешение генерации, по умолчанию рекомендуемое моделью: 1024 для v1.5/v2.0 и fast-уровня в остальных случаях. Доступны 512, 1024, 1536 и 1536pro для v1.5/v2.0; 1536fast и 1536pro для v2.1; 1536 для scene-portraitv1.5; 1536pro для scene-portraitv2.0; 1536profast и 1536pro для scene-portraitv2.1.

Расширенные model · export_format · face_count · enable_texture · enable_pbr · enable_safety_checker
model по умолчанию hitem3dv2.1

Выбор модели генерации: семейство 'scene-portrait*', настроенное на портреты и персонажей, или универсальное семейство 'hitem3d*'.

export_format по умолчанию glb

Формат сохранения сгенерированной модели.

Желаемое количество граней сгенерированной модели, переопределяющее рекомендацию партнёра на основе разрешения. Если не указано, партнёр выбирает значение сам, например 500k при 512, 1M при 1024 или 2M при 1536.

POST /run/hitem3d/hi3d/image-to-3d?wait=20 стоимость → 0,50 $
# 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/hitem3d/hi3d/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-ключ

О Hi3D Image to 3D

Создаёт 3D-модель по одному изображению (PNG, JPEG или WebP, до 20MB). Параметр `model` включает обычные и оптимизированные для портретов версии, а допустимые значения `resolution` зависят от выбранной версии. Текстурные и PBR-карты можно включать и выключать, `face_count` принимает значения от 100,000 до 2,000,000, а экспорт поддерживает glb, obj, stl, fbx или usdz.

Параметры

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

ИмяТип По умолчаниюДопустимые значения Описание
modelнеобязательно
Типenum
По умолчаниюhitem3dv2.1
hitem3dv1.5hitem3dv2.0hitem3dv2.1scene-portraitv1.5scene-portraitv2.0scene-portraitv2.1
Выбор модели генерации: семейство 'scene-portrait*', настроенное на портреты и персонажей, или универсальное семейство 'hitem3d*'.
resolutionнеобязательно
Типenum
512102415361536pro1536fast1536profast
Разрешение генерации, по умолчанию рекомендуемое моделью: 1024 для v1.5/v2.0 и fast-уровня в остальных случаях. Доступны 512, 1024, 1536 и 1536pro для v1.5/v2.0; 1536fast и 1536pro для v2.1; 1536 для scene-portraitv1.5; 1536pro для scene-portraitv2.0; 1536profast и 1536pro для scene-portraitv2.1.
enable_textureнеобязательно
Типboolean
По умолчаниюtrue
Определяет, генерируются ли текстуры вместе с геометрией.
enable_pbrнеобязательно
Типboolean
По умолчаниюtrue
Определяет, создаются ли карты материалов PBR вместе с текстурой.
face_countнеобязательно
Типinteger | null
100 000 – 2 000 000
Желаемое количество граней сгенерированной модели, переопределяющее рекомендацию партнёра на основе разрешения. Если не указано, партнёр выбирает значение сам, например 500k при 512, 1M при 1024 или 2M при 1536.
export_formatнеобязательно
Типenum
По умолчаниюglb
glbobjstlfbxusdz
Формат сохранения сгенерированной модели.
enable_safety_checkerнеобязательно
Типboolean
По умолчаниюtrue
Переключатель проверки безопасности входных изображений: true требует проверки до начала обработки изображения.
image_urlобязательно image
Типurl · image
Укажите входное изображение по URL как файл PNG, JPEG или WebP размером не более 20 MB.
обязательно Каноническое имя, также принимается

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

Результат

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "hitem3d/hi3d/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": 500,
    "usd": "0.50",
    "charged": 500,
    "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
    },
    "thumbnail": {
      "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
    }
  },
  "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}Файл сгенерированной 3D-модели.
thumbnail
object {url, content_type, file_name, file_size} | nullИзображение предварительного просмотра модели, если доступно.

Другие модели: Изображение в 3D

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