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

PATINA · Material

Интеграция

ID модели patina/material
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/patina/material?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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

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

Получить API-ключ
Open model Текст в изображение #material#pbr#displacement#metalness

Генератор текстур из текста, выдающий бесшовные изображения и карты PBR с необязательными img2img и инпейтингом

Open model · Изображение

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

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

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

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

•обязательно

Текстовое описание создаваемого материала или текстуры.

image_size по умолчанию square_hd

Размеры результирующей текстуры в пикселях.

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

Коэффициент бесшовного увеличения SeedVR, влияющий на предсказанные карты PBR, но сохраняющий исходное разрешение базовой текстуры. Выберите 2 для двойного разрешения, 4 для четырёхкратного или 0 для отключения увеличения.

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

Количество создаваемых изображений текстуры.

Расширенные image · mask · tiling_mode · output_format · num_inference_steps · tile_size · tile_stride · strength · seed · enable_prompt_expansion · enable_safety_checker · maps
image_url
Перетащите файл или

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

mask_url
Перетащите файл или

URL маски дорисовки, передаваемый вместе с обязательным image_url. Маска оставляет чёрные области без изменений и регенерирует белые области.

tiling_mode по умолчанию both

Направление замощения: 'both' для всенаправленного замощения, 'horizontal' или 'vertical'.

output_format по умолчанию png

Формат файла изображения для выходных текстур и карт PBR.

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

Количество шагов удаления шума для создания текстур.

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

Размер тайла в латентном пространстве: 64 соответствует 512px, а 128 — 1024px. Для каждой оси с тайлами размер сгенерированного изображения задаёт автоматический верхний предел.

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

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

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

Сила преобразования, применяемая только к изображению, переданному через image_url; в остальных случаях не используется.

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

по умолчанию ["basecolor","normal"...

Карты PBR, выбранные для предсказания; по умолчанию выбраны все пять. Если ничего не выбрать, оценка PBR полностью пропускается.

POST /run/patina/material?wait=20 стоимость → 0,08 $
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/patina/material?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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

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

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

О PATINA · Material

Создаёт бесшовные текстуры по промпту и предсказывает карты PBR: basecolor, normal, roughness, metalness и height. `tiling_mode` задаёт горизонтальное, вертикальное или двунаправленное повторение, а `upscale_factor` 0, 2 или 4 увеличивает карты. Передача `image_url` включает преобразование изображения в изображение, а добавление `mask_url` — инпейтинг. До 4 изображений за запрос.

Параметры

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

ИмяТип По умолчаниюДопустимые значения Описание
promptобязательно
Типstring
Текстовое описание создаваемого материала или текстуры.
image_sizeнеобязательно
Типobject
По умолчаниюsquare_hd
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Размеры результирующей текстуры в пикселях.
num_inference_stepsнеобязательно
Типinteger
По умолчанию8
1 – 8
Количество шагов удаления шума для создания текстур.
seedнеобязательно
Типinteger | null
Случайный seed, обеспечивающий воспроизводимость генерации.
num_imagesнеобязательно num_outputs
Типinteger
По умолчанию1
1 – 4
Количество создаваемых изображений текстуры.
enable_prompt_expansionнеобязательно
Типboolean
По умолчаниюtrue
Включает расширение промпта на основе LLM для добавления деталей.
enable_safety_checkerнеобязательно
Типboolean
По умолчаниюtrue
Включает проверку безопасности сгенерированных изображений.
tiling_modeнеобязательно
Типenum
По умолчаниюboth
bothhorizontalvertical
Направление замощения: 'both' для всенаправленного замощения, 'horizontal' или 'vertical'.
tile_sizeнеобязательно
Типinteger
По умолчанию128
32 – 256
Размер тайла в латентном пространстве: 64 соответствует 512px, а 128 — 1024px. Для каждой оси с тайлами размер сгенерированного изображения задаёт автоматический верхний предел.
tile_strideнеобязательно
Типinteger
По умолчанию64
16 – 128
Задаёт шаг между тайлами в латентном пространстве; автоматическое ограничение не позволяет ему превышать половину эффективного размера тайла.
image_urlнеобязательно image
Типurl · image
URL исходного изображения, используемый для дорисовки, если вместе с ним указан mask_url, и для обработки изображения по изображению в остальных случаях.
mask_urlнеобязательно mask
Типurl · image
URL маски дорисовки, передаваемый вместе с обязательным image_url. Маска оставляет чёрные области без изменений и регенерирует белые области.
strengthнеобязательно
Типnumber
По умолчанию0.6
≤ 1> 0
Сила преобразования, применяемая только к изображению, переданному через image_url; в остальных случаях не используется.
mapsнеобязательно
Типenum[]
По умолчанию["basecolor","normal","roughness","metalness","height"]
Карты PBR, выбранные для предсказания; по умолчанию выбраны все пять. Если ничего не выбрать, оценка PBR полностью пропускается.
upscale_factorнеобязательно
Типenum
По умолчанию0
024
Коэффициент бесшовного увеличения SeedVR, влияющий на предсказанные карты PBR, но сохраняющий исходное разрешение базовой текстуры. Выберите 2 для двойного разрешения, 4 для четырёхкратного или 0 для отключения увеличения.
output_formatнеобязательно
Типenum
По умолчаниюpng
jpegpngwebp
Формат файла изображения для выходных текстур и карт PBR.
обязательно Каноническое имя, также принимается

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

Результат

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "patina/material",
  "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": 80,
    "usd": "0.08",
    "charged": 80,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  },
  "output": {
    "images": [
      {
        "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,
        "width": 1024,
        "height": 768
      }
    ],
    "seed": 42,
    "prompt": "string",
    "timings": {}
  },
  "outputs": [
    {
      "type": "image",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "width": 1024,
      "height": 768,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Ваши файлы — ваш выборКаждый URL из outputs[].url — это копия в нашем хранилище: она хранится навсегда (оплата за ГБ в месяц) или 7 дней бесплатно — в зависимости от настройки вашего аккаунта или параметра ?storage=.
Одинаковая структура у каждой моделиtype, url, content_type, width, height и duration — одинаково для изображений, видео и аудио. output — собственный объект результата модели.
Поля результата
images
array of anyВыходные изображения включают карты материала PBR, предсказанные PATINA, и тайлинговые текстуры, созданные z-image.
seed
integerСид, применяемый при создании текстур.
prompt
stringПромпт генерации текстуры, включая применённое расширение.
timings
objectРазбивка времени всего процесса в секундах.

Другие модели: Текст в изображение

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