Мазмұнға өту

PATINA · Material

Интеграциялау

Модель идентификаторы 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 кредиті файлдарыңыз іске қосу алдында өлшенеді Осы бетте іске қосу

API кілтін алу
Open model Мәтіннен кескінге #material#pbr#displacement#metalness

PBR карталарымен бірге тақталанатын кескіндер шығаратын мәтіннен текстураға генератор, img2img және инпейтинг қолдауымен

Open model · Кескін

Алғашқы нәтижеңіз осында пайда болады

Төменде сұрау құрып, оны API кілтіңізбен іске қосыңыз. Шығыстар сақтау орнымызға көшіріліп, мәңгі немесе 7 күн тегін сақталады.

Сұрау жасау

Басқару элементтері модель схемасынан жасалады. Оларды өзгерткен сайын код пен баға жаңартылады.

•міндетті

Жасалатын материалдың немесе текстураның мәтіндік сипаттамасы.

image_size әдепкі square_hd

Нәтижелік текстураның пиксель өлшемдері.

upscale_factor әдепкі 0

Болжанған PBR карталарына әсер ететін, бірақ негізгі текстураны бастапқы ажыратымдылығында қалдыратын SeedVR үздіксіз үлкейту коэффициенті. Екі есе ажыратымдылық үшін 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 бірге берілсе, inpainting үшін, әйтпесе кескіннен кескін өңдеуі үшін қолданылады.

mask_url
Файлды тастаңыз немесе

Қажетті image_url бірге берілетін inpainting маскасының 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-ге жіберіледі және Remember параметрін белгілеcеңіз ғана localStorage ішінде сақталады. API кілтін алу

PATINA · Material туралы

Нұсқаудан тақталанатын текстуралар жасап, PBR карталарын болжайды: basecolor, normal, roughness, metalness және height. Екі бағытта, көлденең немесе тік тақталау үшін `tiling_mode`, ал карталарды үлкейту үшін 0, 2 немесе 4 мәнді `upscale_factor` қолданыңыз. `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 бірге берілсе, inpainting үшін, әйтпесе кескіннен кескін өңдеуі үшін қолданылады.
mask_urlміндетті емес mask
Түріurl · image
Қажетті image_url бірге берілетін inpainting маскасының URL мекенжайы. Маска қара аймақтарды өзгеріссіз қалдырып, ақ аймақтарды қайта генерациялайды.
strengthміндетті емес
Түріnumber
Әдепкі0.6
≤ 1> 0
Тек image_url арқылы берілген кескінге қолданылатын түрлендіру күші; басқа жағдайда қолданылмайды.
mapsміндетті емес
Түріenum[]
Әдепкі["basecolor","normal","roughness","metalness","height"]
Болжау үшін таңдалған PBR карталары; әдепкі бойынша бесеуі де таңдалады. Ешқайсысын таңдау PBR бағалауын толығымен өткізіп жібереді.
upscale_factorміндетті емес
Түріenum
Әдепкі0
024
Болжанған PBR карталарына әсер ететін, бірақ негізгі текстураны бастапқы ажыратымдылығында қалдыратын SeedVR үздіксіз үлкейту коэффициенті. Екі есе ажыратымдылық үшін 2, төрт есе үшін 4, үлкейтуді өшіру үшін 0 таңдаңыз.
output_formatміндетті емес
Түріenum
Әдепкіpng
jpegpngwebp
Шығыс текстуралары мен PBR карталарының кескін файл пішімі.
міндетті Канондық атау, бұл да қабылданады

Файл параметрлері жалпыға қолжетімді https:// URL мекенжайын, 10 MB-қа дейінгі data: URI мекенжайын немесе жүктеп салынған файлдың 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"
  }
}
Файлдарыңыз — таңдауыңызӘр outputs[].url — сақтау орнымыздағы көшірме: мәңгі (әр GB-ай үшін ақылы) немесе аккаунт параметрі не ?storage= арқылы 7 күн тегін сақталады.
Әр модельдегі пішім бірдейtype, url, content_type, width, height және duration — кескіндерге, бейнеге және аудиоға ортақ. output — модельдің өз нәтижелер нысаны.
Шығыс өрістері
images
array of anyШығыс кескіндерінде z-image жасаған тақталанатын текстуралармен қатар PATINA болжаған PBR материал карталары болады.
seed
integerТекстураларды генерациялау кезінде қолданылатын seed.
prompt
stringҚолданылған кез келген кеңейтуді қамтитын текстура генерациялау нұсқауы.
timings
objectТолық процестің секундпен берілген уақыт бөлінісі.

Қосымша модельдер: Мәтіннен кескінге

AI агенттеріне: бұл беттің Markdown нұсқасы мына жерде: https://doitong.com/kk/developers/models/patina/material.md. Барлық модельдер мен нұсқаулықтар: https://doitong.com/developers/llms.txt