Léim chuig an ábhar

Pixal3d

Comhtháthú

Aitheantas na samhla 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"

An t-iarratas seo: $0.30 300 gcreidmheas API · ≈ ₽31.64 Rith ar an leathanach seo

Faigh eochair API
Open model Íomhá go 3D #stylized#transform

Tiontaíonn sé íomhá aonair ina samhail 3D GLB uigeach le rialú mionsonraithe ar gach céim giniúna

Open model · 3D

Beidh do chéad toradh anseo

Tóg iarratas thíos agus rith é le d’eochair API. Cóipeáiltear na haschuir chuig ár stóráil, coinnithe go deo nó ar feadh 7 lá saor in aisce.

Tóg iarratas

Gintear na rialtáin ó scéim na samhla. Nuashonraítear an cód agus an praghas de réir mar a athraíonn tú iad.

•riachtanach image_url
Scaoil comhad, nó

URL a dhíríonn ar an íomhá foinse le haghaidh tiontú 3D.

resolution réamhshocrú 1024

Taifeach an aschuir; cuireann méadú air sonraí leis ach tógann sé níos faide.

Ardleibhéal 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 réamhshocrú 2048

Taifeach uigeachta na mogalra le haghaidh bácála. Cruthaíonn mionsonraí dromchla níos míne comhaid níos mó nuair a mhéadaítear an taifeach seo.

réamhshocrú 7.5

Rialú ar dhílseacht na struchtúir 3D tosaigh: cuireann méadú leis an gcomhaontú leis an íomhá ionchuir, ach d’fhéadfadh torann breise tarlú.

réamhshocrú 0.7

Rialú déantán treorach Chéim 1, agus éifeachtaí treorach níos láidre ag socruithe ísle á malartú ar aschur níos cobhsaí ag socruithe arda.

réamhshocrú 12

Líon na gcéimeanna dí-íslithe torainn don struchtúr tosaigh: tagann gnóthachain fhéideartha cáilíochta ó chéimeanna breise ar chostas próiseála níos moille.

réamhshocrú 5

Socraigh géire an aistrithe trí sceideal torainn ghiniúint na struchtúir: déanann méadú ar an luach seo na haistrithe níos géire.

réamhshocrú 7.5

Rialú dílseachta na céimseata mionsonraithe: cruthaíonn cloí níos fearr leis an íomhá ionchuir tuilleadh sonraí, agus baol torainn bhreise ann.

réamhshocrú 0.5

Méadaigh an socrú seo nuair a bhíonn an chéimseata torannach: laghdaíonn sé déantáin de bharr treorach láidre le linn chéim na crutha.

réamhshocrú 12

Líon na gcéimeanna dí-íslithe torainn le haghaidh mionchoigeartú na crutha: d’fhéadfadh céimseata níos míne teacht ar chostas luais nuair a úsáidtear céimeanna breise.

réamhshocrú 3

Socraigh géire mhionsonraí na céimseata trí sceideal torainn mhionchoigeartaithe na crutha; cruthaíonn méadú ar an luach seo sonraí níos géire.

réamhshocrú 1

Rialú dílseachta dathanna na huigeachta: méadaíonn cloí níos dlúithe le dathanna na híomhá ionchuir ag socruithe níos airde beogacht, ach d’fhéadfadh sé rósháithiú a chruthú.

réamhshocrú 0

Méadaigh an socrú seo chun uigeachtaí torannacha nó bandáil dathanna a cheartú: laghdaíonn sé déantáin de bharr treorach láidre le linn chéim na huigeachta.

réamhshocrú 12

Líon na gcéimeanna dí-íslithe torainn a úsáidtear chun uigeachtaí a ghiniúint. Tógann méadú ar an líon níos faide ach d’fhéadfadh uigeachtaí níos glaine a bheith mar thoradh air.

réamhshocrú 3

Socraigh géire mhionsonraí na huigeachta trí sceideal torainn ghiniúint na huigeachta; cruthaíonn méadú ar an luach seo sonraí níos géire.

réamhshocrú 1

Scálaigh an mogalra tátalaithe chun tionchar a imirt ar an meastachán fadcheamara a úsáideann an tsamhail.

réamhshocrú 49152

Uasteorainn tócan HR don samplálaí crutha cascáideach, ag cothromú céimseata níos míne ag socruithe arda le coigiltí cuimhne agus ama próiseála ag socruithe ísle.

réamhshocrú 200000

Sprioc chastacht na mogalra, léirithe mar líon rinn don toradh deiridh. Laghdaíonn ísliú na sprice méid an chomhaid ach íobartaíonn sé sonraí freisin.

Síol a úsáidtear le haghaidh giniúint randamach in-atáirgthe.

POST /run/pixal3d?wait=20 luachan → $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"

Rith an t-iarratas seo

Fanann d'eochair sa bhrabhsálaí seo: seoltar chuig Doitong API amháin í agus sábháiltear (localStorage) í ach amháin má chuireann tú tic le Meabhraigh. Faigh eochair API

Maidir le Pixal3d

Glacann sé íomhá amháin agus filleann sé samhail GLB mar aon leis an síol a úsáideadh. Tá a socruithe treorach, athscálaithe, comhair céimeanna agus sceidil torainn féin ag céimeanna struchtúir, crutha agus uigeachta. Is é `resolution` 1024 nó 1536, `texture_size` 1024, 2048 nó 4096, agus socraíonn `decimation_target` líon na rinn ó 5000 suas go 1586021. Atógann `remesh` an topolaíocht.

Paraiméadair

Seol an t-ainm canónach nó an t-ainm dúchasach, ní an dá cheann. Ainmneacha canónacha

AinmCineál RéamhshocrúCeadaithe Cur síos
image_urlriachtanach image
Cineálurl · image
URL a dhíríonn ar an íomhá foinse le haghaidh tiontú 3D.
seedroghnach
Cineálinteger | null
Síol a úsáidtear le haghaidh giniúint randamach in-atáirgthe.
resolutionroghnach
Cineálenum
Réamhshocrú1024
10241536
Taifeach an aschuir; cuireann méadú air sonraí leis ach tógann sé níos faide.
ss_guidance_strengthroghnach
Cineálnumber
Réamhshocrú7.5
0 – 10
Rialú ar dhílseacht na struchtúir 3D tosaigh: cuireann méadú leis an gcomhaontú leis an íomhá ionchuir, ach d’fhéadfadh torann breise tarlú.
ss_guidance_rescaleroghnach
Cineálnumber
Réamhshocrú0.7
0 – 1
Rialú déantán treorach Chéim 1, agus éifeachtaí treorach níos láidre ag socruithe ísle á malartú ar aschur níos cobhsaí ag socruithe arda.
ss_sampling_stepsroghnach
Cineálinteger
Réamhshocrú12
1 – 50
Líon na gcéimeanna dí-íslithe torainn don struchtúr tosaigh: tagann gnóthachain fhéideartha cáilíochta ó chéimeanna breise ar chostas próiseála níos moille.
ss_rescale_troghnach
Cineálnumber
Réamhshocrú5
1 – 6
Socraigh géire an aistrithe trí sceideal torainn ghiniúint na struchtúir: déanann méadú ar an luach seo na haistrithe níos géire.
shape_slat_guidance_strengthroghnach
Cineálnumber
Réamhshocrú7.5
0 – 10
Rialú dílseachta na céimseata mionsonraithe: cruthaíonn cloí níos fearr leis an íomhá ionchuir tuilleadh sonraí, agus baol torainn bhreise ann.
shape_slat_guidance_rescaleroghnach
Cineálnumber
Réamhshocrú0.5
0 – 1
Méadaigh an socrú seo nuair a bhíonn an chéimseata torannach: laghdaíonn sé déantáin de bharr treorach láidre le linn chéim na crutha.
shape_slat_sampling_stepsroghnach
Cineálinteger
Réamhshocrú12
1 – 50
Líon na gcéimeanna dí-íslithe torainn le haghaidh mionchoigeartú na crutha: d’fhéadfadh céimseata níos míne teacht ar chostas luais nuair a úsáidtear céimeanna breise.
shape_slat_rescale_troghnach
Cineálnumber
Réamhshocrú3
1 – 6
Socraigh géire mhionsonraí na céimseata trí sceideal torainn mhionchoigeartaithe na crutha; cruthaíonn méadú ar an luach seo sonraí níos géire.
tex_slat_guidance_strengthroghnach
Cineálnumber
Réamhshocrú1
0 – 10
Rialú dílseachta dathanna na huigeachta: méadaíonn cloí níos dlúithe le dathanna na híomhá ionchuir ag socruithe níos airde beogacht, ach d’fhéadfadh sé rósháithiú a chruthú.
tex_slat_guidance_rescaleroghnach
Cineálnumber
Réamhshocrú0
0 – 1
Méadaigh an socrú seo chun uigeachtaí torannacha nó bandáil dathanna a cheartú: laghdaíonn sé déantáin de bharr treorach láidre le linn chéim na huigeachta.
tex_slat_sampling_stepsroghnach
Cineálinteger
Réamhshocrú12
1 – 50
Líon na gcéimeanna dí-íslithe torainn a úsáidtear chun uigeachtaí a ghiniúint. Tógann méadú ar an líon níos faide ach d’fhéadfadh uigeachtaí níos glaine a bheith mar thoradh air.
tex_slat_rescale_troghnach
Cineálnumber
Réamhshocrú3
1 – 6
Socraigh géire mhionsonraí na huigeachta trí sceideal torainn ghiniúint na huigeachta; cruthaíonn méadú ar an luach seo sonraí níos géire.
mesh_scaleroghnach
Cineálnumber
Réamhshocrú1
0.1 – 4
Scálaigh an mogalra tátalaithe chun tionchar a imirt ar an meastachán fadcheamara a úsáideann an tsamhail.
max_num_tokensroghnach
Cineálinteger
Réamhshocrú49152
4,096 – 131,072
Uasteorainn tócan HR don samplálaí crutha cascáideach, ag cothromú céimseata níos míne ag socruithe arda le coigiltí cuimhne agus ama próiseála ag socruithe ísle.
decimation_targetroghnach
Cineálinteger
Réamhshocrú200000
5,000 – 1,586,021
Sprioc chastacht na mogalra, léirithe mar líon rinn don toradh deiridh. Laghdaíonn ísliú na sprice méid an chomhaid ach íobartaíonn sé sonraí freisin.
texture_sizeroghnach
Cineálenum
Réamhshocrú2048
102420484096
Taifeach uigeachta na mogalra le haghaidh bácála. Cruthaíonn mionsonraí dromchla níos míne comhaid níos mó nuair a mhéadaítear an taifeach seo.
remeshroghnach
Cineálboolean
Réamhshocrútrue
Atógáil thopolaíocht na mogalra, a théann chun tairbhe úsáide iartheachtach de ghnáth trí thriantáin níos glaine a chruthú, ar chostas próiseála níos faide.
enable_safety_checkerroghnach
Cineálboolean
Réamhshocrútrue
Is féidir an scagadh a mhaolú trí false a shocrú, ar choinníoll go bhfuil údarú ag an nglaoiteoir.
riachtanach Ainm canónach, glactar leis freisin

Glacann paraiméadair chomhaid le URL poiblí https://, URI data: suas le 10 MB, nó file_url uaslódála. Comhaid

Aschur

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"
  }
}
Do chuid comhad, do roghaIs cóip ar ár stóráil é gach outputs[].url: coinnithe go deo (íoctha in aghaidh GB-mhí) nó ar feadh 7 lá saor in aisce, de réir shocrú do chuntais nó ?storage=.
An cruth céanna ar gach samhailtype, url, content_type, width, height agus duration, d'íomhánna, d'fhíseáin agus d'fhuaim araon. Is é output réad toraidh na samhla féin.
Réimsí aschuir
model_glb
object {url, content_type, file_name, file_size}Samhail 3D ginte i bhformáid GLB.
seed
integerLuach an tsíl a úsáideadh i ndáiríre.

Do ghníomhairí AI: tá an leathanach seo mar Markdown ag https://doitong.com/ga/developers/models/pixal3d.md. Gach samhail agus treoir: https://doitong.com/developers/llms.txt