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

Pixal3d

Интеграция

ID модели pixal3d
# 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/pixal3d?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-кредитов · ≈ 31,97 ₽ Запустить на этой странице

Получить API-ключ
Open model Изображение в 3D #stylized#transform

Преобразует одно изображение в текстурированную 3D-модель GLB с детальным управлением каждым этапом генерации

Open model · 3D

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

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

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

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

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

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

resolution по умолчанию 1024

Разрешение выходных данных; его увеличение добавляет детали, но занимает больше времени.

Расширенные texture_size · ss_guidance_strength · ss_guidance_rescale · ss_sampling_steps · ss_rescale_t · shape_slat_guidance_strength · shape_slat_guidance_rescale · shape_slat_sampling_steps · shape_slat_rescale_t · tex_slat_guidance_strength · tex_slat_guidance_rescale · tex_slat_sampling_steps · tex_slat_rescale_t · mesh_scale · max_num_tokens · decimation_target · seed · remesh · enable_safety_checker
texture_size по умолчанию 2048

Разрешение текстуры сетки для запекания. При увеличении разрешения повышается детализация поверхности, но увеличивается размер файлов.

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

Управление точностью исходной 3D-структуры: увеличение повышает соответствие входному изображению, но может добавить шум.

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

Управление артефактами на этапе 1: низкие значения усиливают эффекты управления, а высокие обеспечивают более стабильные выходные данные.

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

Количество шагов удаления шума исходной структуры: дополнительные шаги могут повысить качество, но замедляют обработку.

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

Задаёт резкость переходов через расписание шума генерации структуры: увеличение значения делает переходы резче.

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

Управление точностью детальной геометрии: большее соответствие входному изображению добавляет детали, но может привести к дополнительному шуму.

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

Увеличьте это значение, если геометрия выглядит зашумлённой: оно уменьшает артефакты, вызванные сильным управлением на этапе формы.

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

Количество шагов удаления шума для уточнения формы: дополнительные шаги могут сделать геометрию более гладкой, но снижают скорость.

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

Задаёт резкость геометрических деталей через расписание шума уточнения формы; увеличение значения делает детали резче.

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

Управление точностью цвета текстуры: большее соответствие цветам входного изображения при высоких значениях повышает насыщенность, но может вызвать перенасыщение.

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

Увеличьте это значение для устранения зашумлённых текстур или цветовых полос: оно уменьшает артефакты, вызванные сильным управлением на этапе текстуры.

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

Количество шагов удаления шума для создания текстур. Увеличение количества шагов занимает больше времени, но может дать более чистые текстуры.

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

Задаёт резкость деталей текстуры через расписание шума генерации текстуры; увеличение значения делает детали резче.

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

Масштабирует выведенную сетку, влияя на оценку расстояния до камеры, используемую моделью.

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

Ограничение токенов HR для каскадного семплера формы: высокие значения обеспечивают более тонкую геометрию, а низкие экономят память и время обработки.

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

Целевая сложность сетки, заданная количеством вершин в итоговом результате. Уменьшение размера файла за счёт снижения этой цели также уменьшает детализацию.

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

POST /run/pixal3d?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/pixal3d?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-ключ

О Pixal3d

Принимает одно изображение и возвращает модель GLB вместе с использованным сидом. Для этапов структуры, формы и текстуры предусмотрены отдельные параметры guidance, рескейлинга, количества шагов и расписания шума. Выходное `resolution` — 1024 или 1536, `texture_size` — 1024, 2048 или 4096, а `decimation_target` задаёт количество вершин от 5000 до 1586021. `remesh` перестраивает топологию.

Параметры

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

ИмяТип По умолчаниюДопустимые значения Описание
image_urlобязательно image
Типurl · image
URL исходного изображения для преобразования в 3D.
seedнеобязательно
Типinteger | null
Сид для воспроизводимой случайной генерации.
resolutionнеобязательно
Типenum
По умолчанию1024
10241536
Разрешение выходных данных; его увеличение добавляет детали, но занимает больше времени.
ss_guidance_strengthнеобязательно
Типnumber
По умолчанию7.5
0 – 10
Управление точностью исходной 3D-структуры: увеличение повышает соответствие входному изображению, но может добавить шум.
ss_guidance_rescaleнеобязательно
Типnumber
По умолчанию0.7
0 – 1
Управление артефактами на этапе 1: низкие значения усиливают эффекты управления, а высокие обеспечивают более стабильные выходные данные.
ss_sampling_stepsнеобязательно
Типinteger
По умолчанию12
1 – 50
Количество шагов удаления шума исходной структуры: дополнительные шаги могут повысить качество, но замедляют обработку.
ss_rescale_tнеобязательно
Типnumber
По умолчанию5
1 – 6
Задаёт резкость переходов через расписание шума генерации структуры: увеличение значения делает переходы резче.
shape_slat_guidance_strengthнеобязательно
Типnumber
По умолчанию7.5
0 – 10
Управление точностью детальной геометрии: большее соответствие входному изображению добавляет детали, но может привести к дополнительному шуму.
shape_slat_guidance_rescaleнеобязательно
Типnumber
По умолчанию0.5
0 – 1
Увеличьте это значение, если геометрия выглядит зашумлённой: оно уменьшает артефакты, вызванные сильным управлением на этапе формы.
shape_slat_sampling_stepsнеобязательно
Типinteger
По умолчанию12
1 – 50
Количество шагов удаления шума для уточнения формы: дополнительные шаги могут сделать геометрию более гладкой, но снижают скорость.
shape_slat_rescale_tнеобязательно
Типnumber
По умолчанию3
1 – 6
Задаёт резкость геометрических деталей через расписание шума уточнения формы; увеличение значения делает детали резче.
tex_slat_guidance_strengthнеобязательно
Типnumber
По умолчанию1
0 – 10
Управление точностью цвета текстуры: большее соответствие цветам входного изображения при высоких значениях повышает насыщенность, но может вызвать перенасыщение.
tex_slat_guidance_rescaleнеобязательно
Типnumber
По умолчанию0
0 – 1
Увеличьте это значение для устранения зашумлённых текстур или цветовых полос: оно уменьшает артефакты, вызванные сильным управлением на этапе текстуры.
tex_slat_sampling_stepsнеобязательно
Типinteger
По умолчанию12
1 – 50
Количество шагов удаления шума для создания текстур. Увеличение количества шагов занимает больше времени, но может дать более чистые текстуры.
tex_slat_rescale_tнеобязательно
Типnumber
По умолчанию3
1 – 6
Задаёт резкость деталей текстуры через расписание шума генерации текстуры; увеличение значения делает детали резче.
mesh_scaleнеобязательно
Типnumber
По умолчанию1
0,1 – 4
Масштабирует выведенную сетку, влияя на оценку расстояния до камеры, используемую моделью.
max_num_tokensнеобязательно
Типinteger
По умолчанию49152
4 096 – 131 072
Ограничение токенов HR для каскадного семплера формы: высокие значения обеспечивают более тонкую геометрию, а низкие экономят память и время обработки.
decimation_targetнеобязательно
Типinteger
По умолчанию200000
5 000 – 1 586 021
Целевая сложность сетки, заданная количеством вершин в итоговом результате. Уменьшение размера файла за счёт снижения этой цели также уменьшает детализацию.
texture_sizeнеобязательно
Типenum
По умолчанию2048
102420484096
Разрешение текстуры сетки для запекания. При увеличении разрешения повышается детализация поверхности, но увеличивается размер файлов.
remeshнеобязательно
Типboolean
По умолчаниюtrue
Перестроение топологии сетки, обычно полезное для последующего использования благодаря созданию более чистых треугольников, но увеличивающее время обработки.
enable_safety_checkerнеобязательно
Типboolean
По умолчаниюtrue
Проверку можно ослабить, установив false, если вызывающая сторона авторизована.
обязательно Каноническое имя, также принимается

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

Результат

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "pixal3d",
  "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_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
    },
    "seed": 42
  },
  "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_glb
object {url, content_type, file_name, file_size}3D-модель, сгенерированная в формате GLB.
seed
integerФактически использованное значение сида.

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