Neidio i'r cynnwys

PATINA · Material

Integreiddio

ID y model 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"

Ffeiliau fel yr enghraifft: $0.08 80 o gredydau API caiff eich ffeiliau eu mesur cyn y rhediad Ei redeg ar y dudalen hon

Cael allwedd API
Open model Testun i Ddelwedd #material#pbr#displacement#metalness

Cynhyrchydd testun-i-wead sy’n allbynnu delweddau teilsadwy ynghyd â mapiau PBR, gyda img2img a phaentio mewnol opsiynol

Open model · Delwedd

Mae eich canlyniad cyntaf yn mynd yma

Adeiladwch gais isod a'i redeg gyda'ch allwedd API. Mae allbynnau'n cael eu copïo i'n storio, wedi'u cadw am byth neu am 7 diwrnod am ddim.

Adeiladu cais

Cynhyrchir rheolyddion o sgema'r model. Mae'r cod a'r pris yn diweddaru wrth i chi eu newid.

•gofynnol

Disgrifiad testun o'r deunydd neu'r gwead i'w greu.

image_size rhagosodedig square_hd

Dimensiynau picsel y gwead canlyniadol.

upscale_factor rhagosodedig 0

Ffactor uwchraddio di-dor SeedVR sy'n effeithio ar fapiau PBR a ragfynegir ond yn gadael y gwead sylfaenol ar ei gydraniad gwreiddiol. Dewiswch 2 ar gyfer cydraniad dwbl, 4 ar gyfer cydraniad pedwarplyg, neu 0 i analluogi uwchraddio.

num_images rhagosodedig 1

Nifer y delweddau gwead i'w creu.

Uwch image · mask · tiling_mode · output_format · num_inference_steps · tile_size · tile_stride · strength · seed · enable_prompt_expansion · enable_safety_checker · maps
image_url
Gollyngwch ffeil, neu

URL y ddelwedd ffynhonnell, a ddefnyddir ar gyfer mewn-baentio os yw mask_url yn cyd-fynd â hi, ac ar gyfer prosesu delwedd-i-ddelwedd fel arall.

mask_url
Gollyngwch ffeil, neu

URL mwgwd mewn-baentio a ddarperir ochr yn ochr â'r image_url gofynnol. Mae'r mwgwd yn cadw'r ardaloedd du yn ddigyfnewid ac yn ailgynhyrchu'r ardaloedd gwyn.

tiling_mode rhagosodedig both

Cyfeiriad teilio: 'both' ar gyfer teilio amlgyfeiriadol, 'horizontal', neu 'vertical'.

output_format rhagosodedig png

Fformat ffeil delwedd ar gyfer gweadau allbwn a mapiau PBR.

rhagosodedig 8

Nifer y camau tynnu sŵn a ddefnyddir i gynhyrchu gweadau.

rhagosodedig 128

Maint teils yn y gofod cudd, lle mae 64 yn cynrychioli 512px a 128 yn cynrychioli 1024px. Ar bob echel deils, mae dimensiwn y ddelwedd a gynhyrchir yn gosod terfyn uchaf awtomatig.

rhagosodedig 64

Gosodwch y cam rhwng teils y gofod cudd; mae cap awtomatig yn ei atal rhag bod yn fwy na hanner maint effeithiol y deilsen.

rhagosodedig 0.6

Cryfder trawsnewid a gymhwysir yn unig i ddelwedd a ddarperir drwy image_url; ni chaiff ei ddefnyddio fel arall.

Hadau ar hap sy'n gwneud cynhyrchu'n atgynhyrchadwy.

rhagosodedig ["basecolor","normal"...

Mapiau PBR a ddewiswyd ar gyfer rhagfynegi, gyda phob un o'r pump wedi'u dewis yn rhagosodedig. Mae peidio â dewis unrhyw un yn hepgor amcangyfrif PBR yn llwyr.

POST /run/patina/material?wait=20 dyfynbris → $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"

Rhedeg y cais hwn

Mae'ch allwedd yn aros yn y porwr hwn: caiff ei hanfon at Doitong API yn unig a'i chadw (localStorage) dim ond os ticiwch Cofio. Cael allwedd API

Ynglŷn â PATINA · Material

Yn creu gweadau teilsadwy o anogwr ac yn rhagweld mapiau PBR: basecolor, normal, roughness, metalness a height. Defnyddiwch `tiling_mode` ar gyfer teilio dwyffordd, llorweddol neu fertigol, ac `upscale_factor` o 0, 2 neu 4 i ehangu’r mapiau. Mae pasio `image_url` yn galluogi delwedd-i-ddelwedd, ac mae ychwanegu `mask_url` yn galluogi paentio mewnol. Hyd at 4 delwedd fesul cais.

Paramedrau

Anfonwch naill ai'r enw canonaidd neu'r enw brodorol, nid y ddau. Enwau canonaidd

EnwMath RhagosodedigCaniateir Disgrifiad
promptgofynnol
Mathstring
Disgrifiad testun o'r deunydd neu'r gwead i'w greu.
image_sizedewisol
Mathobject
Rhagosodedigsquare_hd
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Dimensiynau picsel y gwead canlyniadol.
num_inference_stepsdewisol
Mathinteger
Rhagosodedig8
1 – 8
Nifer y camau tynnu sŵn a ddefnyddir i gynhyrchu gweadau.
seeddewisol
Mathinteger | null
Hadau ar hap sy'n gwneud cynhyrchu'n atgynhyrchadwy.
num_imagesdewisol num_outputs
Mathinteger
Rhagosodedig1
1 – 4
Nifer y delweddau gwead i'w creu.
enable_prompt_expansiondewisol
Mathboolean
Rhagosodedigtrue
Yn galluogi ehangu anogiadau ar sail LLM i ychwanegu manylion.
enable_safety_checkerdewisol
Mathboolean
Rhagosodedigtrue
Yn galluogi gwirio diogelwch delweddau a gynhyrchir.
tiling_modedewisol
Mathenum
Rhagosodedigboth
bothhorizontalvertical
Cyfeiriad teilio: 'both' ar gyfer teilio amlgyfeiriadol, 'horizontal', neu 'vertical'.
tile_sizedewisol
Mathinteger
Rhagosodedig128
32 – 256
Maint teils yn y gofod cudd, lle mae 64 yn cynrychioli 512px a 128 yn cynrychioli 1024px. Ar bob echel deils, mae dimensiwn y ddelwedd a gynhyrchir yn gosod terfyn uchaf awtomatig.
tile_stridedewisol
Mathinteger
Rhagosodedig64
16 – 128
Gosodwch y cam rhwng teils y gofod cudd; mae cap awtomatig yn ei atal rhag bod yn fwy na hanner maint effeithiol y deilsen.
image_urldewisol image
Mathurl · image
URL y ddelwedd ffynhonnell, a ddefnyddir ar gyfer mewn-baentio os yw mask_url yn cyd-fynd â hi, ac ar gyfer prosesu delwedd-i-ddelwedd fel arall.
mask_urldewisol mask
Mathurl · image
URL mwgwd mewn-baentio a ddarperir ochr yn ochr â'r image_url gofynnol. Mae'r mwgwd yn cadw'r ardaloedd du yn ddigyfnewid ac yn ailgynhyrchu'r ardaloedd gwyn.
strengthdewisol
Mathnumber
Rhagosodedig0.6
≤ 1> 0
Cryfder trawsnewid a gymhwysir yn unig i ddelwedd a ddarperir drwy image_url; ni chaiff ei ddefnyddio fel arall.
mapsdewisol
Mathenum[]
Rhagosodedig["basecolor","normal","roughness","metalness","height"]
Mapiau PBR a ddewiswyd ar gyfer rhagfynegi, gyda phob un o'r pump wedi'u dewis yn rhagosodedig. Mae peidio â dewis unrhyw un yn hepgor amcangyfrif PBR yn llwyr.
upscale_factordewisol
Mathenum
Rhagosodedig0
024
Ffactor uwchraddio di-dor SeedVR sy'n effeithio ar fapiau PBR a ragfynegir ond yn gadael y gwead sylfaenol ar ei gydraniad gwreiddiol. Dewiswch 2 ar gyfer cydraniad dwbl, 4 ar gyfer cydraniad pedwarplyg, neu 0 i analluogi uwchraddio.
output_formatdewisol
Mathenum
Rhagosodedigpng
jpegpngwebp
Fformat ffeil delwedd ar gyfer gweadau allbwn a mapiau PBR.
gofynnol Enw canonaidd, derbyniol hefyd

Mae paramedrau ffeil yn derbyn URL cyhoeddus https://, URI data: hyd at 10 MB, neu file_url uwchlwythiad. Ffeiliau

Allbwn

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"
  }
}
Eich ffeiliau, eich dewisMae pob outputs[].url yn gopi ar ein storio: wedi'i gadw am byth (telir fesul GB-mis) neu am 7 diwrnod am ddim, yn ôl gosodiad eich cyfrif neu ?storage=.
Yr un siâp ar bob modeltype, url, content_type, width, height a duration, ar gyfer delweddau, fideo a sain fel ei gilydd. Gwrthrych canlyniad y model ei hun yw output.
Meysydd yr allbwn
images
array of anyMae delweddau allbwn yn cynnwys mapiau deunydd PBR a ragfynegir gan PATINA ochr yn ochr â gweadau teiliadwy a gynhyrchir gan z-image.
seed
integerHedyn a ddefnyddir wrth gynhyrchu gweadau.
prompt
stringAnogiad cynhyrchu gwead, gan gynnwys unrhyw ehangiad a gymhwyswyd.
timings
objectDadansoddiad amseru sy'n cwmpasu'r broses gyfan, mewn eiliadau.

Mwy o fodelau: Testun i Ddelwedd

Ar gyfer asiantau AI: mae'r dudalen hon fel Markdown ar gael yn https://doitong.com/cy/developers/models/patina/material.md. Pob model a chanllaw: https://doitong.com/developers/llms.txt