Neidio i'r cynnwys

Pixal3d

Integreiddio

ID y model pixal3d
# 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/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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Y cais hwn: $0.30 300 o gredydau API Ei redeg ar y dudalen hon

Cael allwedd API
Open model Delwedd i 3D #stylized#transform

Yn trosi un ddelwedd yn fodel 3D GLB gweadog gyda rheolaeth fanwl dros bob cam cynhyrchu

Open model · 3D

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 image_url
Gollyngwch ffeil, neu

URL sy'n pwyntio at y ddelwedd ffynhonnell ar gyfer trosi 3D.

resolution rhagosodedig 1024

Cydraniad yr allbwn; mae ei gynyddu'n ychwanegu manylion ond yn cymryd mwy o amser.

Uwch 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 rhagosodedig 2048

Cydraniad gwead y rhwyll ar gyfer pobi. Mae manylion wyneb mwy manwl yn cynhyrchu ffeiliau mwy pan gynyddir y cydraniad hwn.

rhagosodedig 7.5

Rheolaeth ffyddlondeb strwythur 3D cychwynnol: mae ei chynyddu'n ffafrio cyfatebiaeth agosach â'r ddelwedd fewnbwn ar draul sŵn ychwanegol posibl.

rhagosodedig 0.7

Rheolaeth arteffactau arweiniad cam 1, gan gyfnewid effeithiau arweiniad cryfach mewn gosodiadau is am allbwn mwy sefydlog mewn gosodiadau uchel.

rhagosodedig 12

Nifer camau tynnu sŵn y strwythur cychwynnol: daw enillion ansawdd posibl o gamau ychwanegol gyda phrosesu arafach.

rhagosodedig 5

Gosodwch eglurder y trawsnewidiad drwy amserlen sŵn cynhyrchu'r strwythur: mae cynyddu'r gwerth hwn yn gwneud trawsnewidiadau'n fwy eglur.

rhagosodedig 7.5

Rheolaeth ffyddlondeb geometreg fanwl: mae cynyddu'r ymlyniad wrth y ddelwedd fewnbwn yn ychwanegu manylion, gyda risg o sŵn ychwanegol.

rhagosodedig 0.5

Cynyddwch y gosodiad hwn pan fo'r geometreg yn edrych yn swnllyd: mae'n lleihau arteffactau a achosir gan arweiniad cryf yn ystod y cam siâp.

rhagosodedig 12

Nifer camau tynnu sŵn mireinio'r siâp: gall geometreg esmwythach gostio cyflymder pan ddefnyddir camau ychwanegol.

rhagosodedig 3

Gosodwch eglurder manylion geometrig drwy amserlen sŵn mireinio'r siâp; mae cynyddu'r gwerth hwn yn cynhyrchu manylion mwy eglur.

rhagosodedig 1

Rheolaeth ffyddlondeb lliw gwead: mae ymlyniad agosach at liwiau'r ddelwedd fewnbwn mewn gosodiadau uwch yn cynyddu bywiogrwydd ond gall achosi gor-dirlawnder.

rhagosodedig 0

Cynyddwch y gosodiad hwn i fynd i'r afael â gweadau swnllyd neu fandio lliw: mae'n lleihau arteffactau a achosir gan arweiniad cryf yn ystod y cam gwead.

rhagosodedig 12

Nifer y camau tynnu sŵn a ddefnyddir i gynhyrchu gweadau. Mae cynyddu nifer y camau'n cymryd mwy o amser ond gall gynhyrchu gweadau glanach.

rhagosodedig 3

Gosodwch eglurder manylion gwead drwy amserlen sŵn cynhyrchu'r gwead; mae cynyddu'r gwerth hwn yn cynhyrchu manylion mwy eglur.

rhagosodedig 1

Graddiwch y rhwyll a gasglwyd i ddylanwadu ar amcangyfrif pellter y camera a ddefnyddir gan y model.

rhagosodedig 49152

Terfyn uchaf tocynnau HR ar gyfer y samplwr siâp rhaeadrol, gan gydbwyso geometreg fanylach mewn gosodiadau uwch yn erbyn arbedion cof ac amser prosesu mewn gosodiadau is.

rhagosodedig 200000

Targed cymhlethdod rhwyll, wedi'i fynegi fel nifer fertigau ar gyfer y canlyniad terfynol. Mae lleihau maint y ffeil drwy ostwng y targed hwn hefyd yn aberthu manylion.

Hedyn a ddefnyddir ar gyfer cynhyrchu ar hap atgynhyrchadwy.

POST /run/pixal3d?wait=20 dyfynbris → $0.30
# 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/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.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 â Pixal3d

Yn cymryd un ddelwedd ac yn dychwelyd model GLB ynghyd â'r had a ddefnyddiwyd. Mae gan gamau strwythur, siâp a gwead eu gosodiadau arweiniad, ailraddio, cyfrif camau a threfn sŵn eu hunain. Mae `resolution` yn 1024 neu 1536, mae `texture_size` yn 1024, 2048 neu 4096, ac mae `decimation_target` yn gosod cyfrif fertigau o 5000 hyd at 1586021. Mae `remesh` yn ailadeiladu'r topoleg.

Paramedrau

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

EnwMath RhagosodedigCaniateir Disgrifiad
image_urlgofynnol image
Mathurl · image
URL sy'n pwyntio at y ddelwedd ffynhonnell ar gyfer trosi 3D.
seeddewisol
Mathinteger | null
Hedyn a ddefnyddir ar gyfer cynhyrchu ar hap atgynhyrchadwy.
resolutiondewisol
Mathenum
Rhagosodedig1024
10241536
Cydraniad yr allbwn; mae ei gynyddu'n ychwanegu manylion ond yn cymryd mwy o amser.
ss_guidance_strengthdewisol
Mathnumber
Rhagosodedig7.5
0 – 10
Rheolaeth ffyddlondeb strwythur 3D cychwynnol: mae ei chynyddu'n ffafrio cyfatebiaeth agosach â'r ddelwedd fewnbwn ar draul sŵn ychwanegol posibl.
ss_guidance_rescaledewisol
Mathnumber
Rhagosodedig0.7
0 – 1
Rheolaeth arteffactau arweiniad cam 1, gan gyfnewid effeithiau arweiniad cryfach mewn gosodiadau is am allbwn mwy sefydlog mewn gosodiadau uchel.
ss_sampling_stepsdewisol
Mathinteger
Rhagosodedig12
1 – 50
Nifer camau tynnu sŵn y strwythur cychwynnol: daw enillion ansawdd posibl o gamau ychwanegol gyda phrosesu arafach.
ss_rescale_tdewisol
Mathnumber
Rhagosodedig5
1 – 6
Gosodwch eglurder y trawsnewidiad drwy amserlen sŵn cynhyrchu'r strwythur: mae cynyddu'r gwerth hwn yn gwneud trawsnewidiadau'n fwy eglur.
shape_slat_guidance_strengthdewisol
Mathnumber
Rhagosodedig7.5
0 – 10
Rheolaeth ffyddlondeb geometreg fanwl: mae cynyddu'r ymlyniad wrth y ddelwedd fewnbwn yn ychwanegu manylion, gyda risg o sŵn ychwanegol.
shape_slat_guidance_rescaledewisol
Mathnumber
Rhagosodedig0.5
0 – 1
Cynyddwch y gosodiad hwn pan fo'r geometreg yn edrych yn swnllyd: mae'n lleihau arteffactau a achosir gan arweiniad cryf yn ystod y cam siâp.
shape_slat_sampling_stepsdewisol
Mathinteger
Rhagosodedig12
1 – 50
Nifer camau tynnu sŵn mireinio'r siâp: gall geometreg esmwythach gostio cyflymder pan ddefnyddir camau ychwanegol.
shape_slat_rescale_tdewisol
Mathnumber
Rhagosodedig3
1 – 6
Gosodwch eglurder manylion geometrig drwy amserlen sŵn mireinio'r siâp; mae cynyddu'r gwerth hwn yn cynhyrchu manylion mwy eglur.
tex_slat_guidance_strengthdewisol
Mathnumber
Rhagosodedig1
0 – 10
Rheolaeth ffyddlondeb lliw gwead: mae ymlyniad agosach at liwiau'r ddelwedd fewnbwn mewn gosodiadau uwch yn cynyddu bywiogrwydd ond gall achosi gor-dirlawnder.
tex_slat_guidance_rescaledewisol
Mathnumber
Rhagosodedig0
0 – 1
Cynyddwch y gosodiad hwn i fynd i'r afael â gweadau swnllyd neu fandio lliw: mae'n lleihau arteffactau a achosir gan arweiniad cryf yn ystod y cam gwead.
tex_slat_sampling_stepsdewisol
Mathinteger
Rhagosodedig12
1 – 50
Nifer y camau tynnu sŵn a ddefnyddir i gynhyrchu gweadau. Mae cynyddu nifer y camau'n cymryd mwy o amser ond gall gynhyrchu gweadau glanach.
tex_slat_rescale_tdewisol
Mathnumber
Rhagosodedig3
1 – 6
Gosodwch eglurder manylion gwead drwy amserlen sŵn cynhyrchu'r gwead; mae cynyddu'r gwerth hwn yn cynhyrchu manylion mwy eglur.
mesh_scaledewisol
Mathnumber
Rhagosodedig1
0.1 – 4
Graddiwch y rhwyll a gasglwyd i ddylanwadu ar amcangyfrif pellter y camera a ddefnyddir gan y model.
max_num_tokensdewisol
Mathinteger
Rhagosodedig49152
4,096 – 131,072
Terfyn uchaf tocynnau HR ar gyfer y samplwr siâp rhaeadrol, gan gydbwyso geometreg fanylach mewn gosodiadau uwch yn erbyn arbedion cof ac amser prosesu mewn gosodiadau is.
decimation_targetdewisol
Mathinteger
Rhagosodedig200000
5,000 – 1,586,021
Targed cymhlethdod rhwyll, wedi'i fynegi fel nifer fertigau ar gyfer y canlyniad terfynol. Mae lleihau maint y ffeil drwy ostwng y targed hwn hefyd yn aberthu manylion.
texture_sizedewisol
Mathenum
Rhagosodedig2048
102420484096
Cydraniad gwead y rhwyll ar gyfer pobi. Mae manylion wyneb mwy manwl yn cynhyrchu ffeiliau mwy pan gynyddir y cydraniad hwn.
remeshdewisol
Mathboolean
Rhagosodedigtrue
Ailadeiladu topoleg y rhwyll, sydd yn gyffredinol o fudd i ddefnydd dilynol drwy greu trionglau glanach, ar draul prosesu hirach.
enable_safety_checkerdewisol
Mathboolean
Rhagosodedigtrue
Gellir llacio'r sgrinio drwy osod false, ar yr amod bod y galwr wedi'i awdurdodi.
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": "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.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
model_glb
object {url, content_type, file_name, file_size}Model 3D a gynhyrchir ar ffurf GLB.
seed
integerGwerth yr hedyn a ddefnyddiwyd mewn gwirionedd.

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