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

Hi3D Image to 3D · v3.0

Интеграция

ID модели hitem3d/hi3d/v3.0/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/v3.0/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"

Файлы, как в примере: 2,10 $ 2 100 API-кредитов · ≈ 225,92 ₽ ваши файлы измеряются перед запуском Запустить на этой странице

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

Hi3D v3.0 преобразует одно изображение в 3D с качеством 2048 или разрешением master и управлением удалением затенения

Hitem3D · 3D

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

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

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

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

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

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

resolution по умолчанию 2048quality

Выбор разрешения генерации с компромиссом между качеством и скоростью: 2048master обеспечивает максимальное качество, а значение по умолчанию 2048quality — более быструю генерацию.

Расширенные export_format · model · face_count · shading · enable_safety_checker
export_format по умолчанию glb

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

по умолчанию hi3dv3.0

Версия модели Hi3D v3.0 для этого эндпоинта.

Желаемое количество граней; рекомендации провайдера — 2,000,000 для 2048quality и 5,000,000 для 2048master.

по умолчанию 0.5

Интенсивность удаления затенения.

POST /run/hitem3d/hi3d/v3.0/image-to-3d?wait=20 стоимость → 2,10 $
# 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/v3.0/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 · v3.0

Создаёт 3D-модель из одного изображения размером до 20MB. `resolution` — 2048quality или 2048master, причём последний вариант обеспечивает максимальное качество. `face_count` может достигать 5,000,000, а `shading` (от 0 до 1) задаёт интенсивность удаления затенения. Доступны переключатели текстур и PBR, экспорт — в glb, obj, stl, fbx или usdz.

Параметры

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

ИмяТип По умолчаниюДопустимые значения Описание
modelнеобязательно
Типstring
По умолчаниюhi3dv3.0
Версия модели Hi3D v3.0 для этого эндпоинта.
resolutionнеобязательно
Типenum
По умолчанию2048quality
2048quality2048master
Выбор разрешения генерации с компромиссом между качеством и скоростью: 2048master обеспечивает максимальное качество, а значение по умолчанию 2048quality — более быструю генерацию.
enable_textureнеобязательно
Типboolean
По умолчаниюtrue
Определяет, генерируются ли текстуры вместе с геометрией.
enable_pbrнеобязательно
Типboolean
По умолчаниюtrue
Определяет, создаются ли карты материалов PBR вместе с текстурой.
face_countнеобязательно
Типinteger | null
100 000 – 5 000 000
Желаемое количество граней; рекомендации провайдера — 2,000,000 для 2048quality и 5,000,000 для 2048master.
export_formatнеобязательно
Типenum
По умолчаниюglb
glbobjstlfbxusdz
Формат сохранения сгенерированной модели.
enable_safety_checkerнеобязательно
Типboolean
По умолчаниюtrue
Переключатель проверки безопасности входных изображений: true требует проверки до начала обработки изображения.
image_urlобязательно image
Типurl · image
Укажите входное изображение по URL как файл PNG, JPEG или WebP размером не более 20 MB.
shadingнеобязательно
Типnumber
По умолчанию0.5
0 – 1
Интенсивность удаления затенения.
обязательно Каноническое имя, также принимается

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

Результат

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "hitem3d/hi3d/v3.0/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": 2100,
    "usd": "2.10",
    "charged": 2100,
    "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/developers/models/hitem3d/hi3d/v3.0/image-to-3d.md. Все модели и руководства: https://doitong.com/developers/llms.txt