Siirry sisältöön

Pixal3d

Integroi

Mallin tunniste 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"

Tämä pyyntö: 0,30 $ 300 API-krediittiä Suorita tällä sivulla

Hanki API-avain
Open model Kuvasta 3D:ksi #stylized#transform

Muuttaa yhden kuvan teksturoiduksi GLB 3D -malliksi ja tarjoaa tarkan hallinnan jokaiseen generointivaiheeseen

Open model · 3D

Ensimmäinen tuloksesi tulee tähän

Muodosta pyyntö alla ja suorita se API-avaimellasi. Tulosteet kopioidaan tallennustilaamme, jossa ne säilytetään ikuisesti tai 7 päivää ilmaiseksi.

Muodosta pyyntö

Säätimet luodaan mallin skeemasta. Koodi ja hinta päivittyvät, kun muutat arvoja.

•pakollinen image_url
Pudota tiedosto tai

3D-muunnoksen lähdekuvaan osoittava URL-osoite.

resolution oletus 1024

Tulosteen resoluutio; sen kasvattaminen lisää yksityiskohtia mutta pidentää käsittelyä.

Lisäasetukset 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 oletus 2048

Verkon tekstuurin leivonnassa käytettävä resoluutio. Resoluutioasetuksen kasvattaminen tuottaa hienompia pintayksityiskohtia mutta suurempia tiedostoja.

oletus 7.5

Alkuperäisen 3D-rakenteen uskollisuuden säätö: suurempi arvo suosii tarkempaa vastaavuutta syötekuvan kanssa, mutta voi lisätä kohinaa.

oletus 0.7

Vaiheen 1 ohjausartefaktien säätö: pienet arvot korostavat ohjauksen vaikutuksia ja suuret arvot tuottavat vakaamman tulosteen.

oletus 12

Alkurakenteen kohinanpoistovaiheiden määrä: lisävaiheiden mahdolliset laatuhyödyt hidastavat käsittelyä.

oletus 5

Aseta siirtymän terävyys rakenteen generoinnin kohina-aikataululla: arvon kasvattaminen tekee siirtymistä terävämpiä.

oletus 7.5

Yksityiskohtaisen geometrian uskollisuuden säätö: suurempi vastaavuus syötekuvan kanssa lisää yksityiskohtia, mutta voi lisätä kohinaa.

oletus 0.5

Kasvata tätä asetusta, kun geometria näyttää kohinaiselta: se vähentää muotovaiheen voimakkaan ohjauksen aiheuttamia artefakteja.

oletus 12

Muodon hienosäädön kohinanpoistovaiheiden määrä: lisävaiheet voivat tasoittaa geometriaa, mutta hidastavat käsittelyä.

oletus 3

Aseta geometrisen yksityiskohdan terävyys muodon hienosäädön kohina-aikataululla; arvon kasvattaminen tuottaa terävämpiä yksityiskohtia.

oletus 1

Tekstuurin värien uskollisuuden säätö: suurempi vastaavuus syötekuvan väreihin lisää eloisuutta, mutta voi aiheuttaa ylikylläisyyttä.

oletus 0

Kasvata tätä asetusta kohinaisten tekstuurien tai värijuovien korjaamiseksi: se vähentää tekstuurivaiheen voimakkaan ohjauksen aiheuttamia artefakteja.

oletus 12

Tekstuurien generointiin käytettävien kohinanpoistovaiheiden määrä. Määrän kasvattaminen pidentää käsittelyä, mutta voi tuottaa puhtaampia tekstuureja.

oletus 3

Aseta tekstuurin yksityiskohtien terävyys tekstuurien generoinnin kohina-aikataululla; arvon kasvattaminen tuottaa terävämpiä yksityiskohtia.

oletus 1

Skaalaa pääteltyä verkkoa vaikuttaaksesi mallin käyttämään kameran etäisyyden arvioon.

oletus 49152

HR-sanakkeiden yläraja porrastetulle muotohahmottimelle: suuremmat arvot mahdollistavat hienomman geometrian, pienemmät säästävät muistia ja käsittelyaikaa.

oletus 200000

Verkon monimutkaisuustavoite lopullisen tuloksen verteksimääränä. Tiedoston koon pienentäminen tavoitetta laskemalla vähentää myös yksityiskohtia.

Toistettavaan satunnaisgenerointiin käytetty siemen.

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

Suorita tämä pyyntö

Avaimesi säilyy tässä selaimessa: se lähetetään vain Doitong APIlle ja tallennetaan localStorageen vain, jos valitset Muista. Hanki API-avain

Tietoja: Pixal3d

Ottaa yhden kuvan ja palauttaa GLB-mallin sekä käytetyn seed-arvon. Rakenne-, muoto- ja tekstuurivaiheilla on omat ohjaus-, uudelleenskaalaus-, askelmäärä- ja kohinaaikatauluasetuksensa. Tulosteen `resolution` on 1024 tai 1536, `texture_size` 1024, 2048 tai 4096 ja `decimation_target` asettaa verteksimääräksi 5000–1586021. `remesh` rakentaa topologian uudelleen.

Parametrit

Lähetä joko kanoninen nimi tai natiivi nimi, älä molempia. Kanoniset nimet

NimiTyyppi OletusSallitut Kuvaus
image_urlpakollinen image
Tyyppiurl · image
3D-muunnoksen lähdekuvaan osoittava URL-osoite.
seedvalinnainen
Tyyppiinteger | null
Toistettavaan satunnaisgenerointiin käytetty siemen.
resolutionvalinnainen
Tyyppienum
Oletus1024
10241536
Tulosteen resoluutio; sen kasvattaminen lisää yksityiskohtia mutta pidentää käsittelyä.
ss_guidance_strengthvalinnainen
Tyyppinumber
Oletus7.5
0 – 10
Alkuperäisen 3D-rakenteen uskollisuuden säätö: suurempi arvo suosii tarkempaa vastaavuutta syötekuvan kanssa, mutta voi lisätä kohinaa.
ss_guidance_rescalevalinnainen
Tyyppinumber
Oletus0.7
0 – 1
Vaiheen 1 ohjausartefaktien säätö: pienet arvot korostavat ohjauksen vaikutuksia ja suuret arvot tuottavat vakaamman tulosteen.
ss_sampling_stepsvalinnainen
Tyyppiinteger
Oletus12
1 – 50
Alkurakenteen kohinanpoistovaiheiden määrä: lisävaiheiden mahdolliset laatuhyödyt hidastavat käsittelyä.
ss_rescale_tvalinnainen
Tyyppinumber
Oletus5
1 – 6
Aseta siirtymän terävyys rakenteen generoinnin kohina-aikataululla: arvon kasvattaminen tekee siirtymistä terävämpiä.
shape_slat_guidance_strengthvalinnainen
Tyyppinumber
Oletus7.5
0 – 10
Yksityiskohtaisen geometrian uskollisuuden säätö: suurempi vastaavuus syötekuvan kanssa lisää yksityiskohtia, mutta voi lisätä kohinaa.
shape_slat_guidance_rescalevalinnainen
Tyyppinumber
Oletus0.5
0 – 1
Kasvata tätä asetusta, kun geometria näyttää kohinaiselta: se vähentää muotovaiheen voimakkaan ohjauksen aiheuttamia artefakteja.
shape_slat_sampling_stepsvalinnainen
Tyyppiinteger
Oletus12
1 – 50
Muodon hienosäädön kohinanpoistovaiheiden määrä: lisävaiheet voivat tasoittaa geometriaa, mutta hidastavat käsittelyä.
shape_slat_rescale_tvalinnainen
Tyyppinumber
Oletus3
1 – 6
Aseta geometrisen yksityiskohdan terävyys muodon hienosäädön kohina-aikataululla; arvon kasvattaminen tuottaa terävämpiä yksityiskohtia.
tex_slat_guidance_strengthvalinnainen
Tyyppinumber
Oletus1
0 – 10
Tekstuurin värien uskollisuuden säätö: suurempi vastaavuus syötekuvan väreihin lisää eloisuutta, mutta voi aiheuttaa ylikylläisyyttä.
tex_slat_guidance_rescalevalinnainen
Tyyppinumber
Oletus0
0 – 1
Kasvata tätä asetusta kohinaisten tekstuurien tai värijuovien korjaamiseksi: se vähentää tekstuurivaiheen voimakkaan ohjauksen aiheuttamia artefakteja.
tex_slat_sampling_stepsvalinnainen
Tyyppiinteger
Oletus12
1 – 50
Tekstuurien generointiin käytettävien kohinanpoistovaiheiden määrä. Määrän kasvattaminen pidentää käsittelyä, mutta voi tuottaa puhtaampia tekstuureja.
tex_slat_rescale_tvalinnainen
Tyyppinumber
Oletus3
1 – 6
Aseta tekstuurin yksityiskohtien terävyys tekstuurien generoinnin kohina-aikataululla; arvon kasvattaminen tuottaa terävämpiä yksityiskohtia.
mesh_scalevalinnainen
Tyyppinumber
Oletus1
0,1 – 4
Skaalaa pääteltyä verkkoa vaikuttaaksesi mallin käyttämään kameran etäisyyden arvioon.
max_num_tokensvalinnainen
Tyyppiinteger
Oletus49152
4 096 – 131 072
HR-sanakkeiden yläraja porrastetulle muotohahmottimelle: suuremmat arvot mahdollistavat hienomman geometrian, pienemmät säästävät muistia ja käsittelyaikaa.
decimation_targetvalinnainen
Tyyppiinteger
Oletus200000
5 000 – 1 586 021
Verkon monimutkaisuustavoite lopullisen tuloksen verteksimääränä. Tiedoston koon pienentäminen tavoitetta laskemalla vähentää myös yksityiskohtia.
texture_sizevalinnainen
Tyyppienum
Oletus2048
102420484096
Verkon tekstuurin leivonnassa käytettävä resoluutio. Resoluutioasetuksen kasvattaminen tuottaa hienompia pintayksityiskohtia mutta suurempia tiedostoja.
remeshvalinnainen
Tyyppiboolean
Oletustrue
Verkon topologian uudelleenrakennus, joka yleensä helpottaa jatkokäyttöä luomalla puhtaampia kolmioita, mutta pidentää käsittelyä.
enable_safety_checkervalinnainen
Tyyppiboolean
Oletustrue
Suodatusta voi höllentää asettamalla arvoksi false, jos kutsujalla on siihen valtuutus.
pakollinen Kanoninen nimi, myös hyväksytty

Tiedostoparametrit hyväksyvät julkisen https://-URL:n, enintään 10 MB:n data:-URI:n tai lähetyksen file_url-arvon. Tiedostot

Tulos

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"
  }
}
Tiedostosi, valintasiJokainen outputs[].url on kopio tallennustilassamme: säilytetään ikuisesti (maksetaan gigatavu-kuukauden mukaan) tai 7 päivää ilmaiseksi tiliasetuksesi tai ?storage= perusteella.
Sama rakenne kaikissa malleissatype, url, content_type, width, height ja duration kuville, videolle ja äänelle. output on mallin oma tulosobjekti.
Tuloksen kentät
model_glb
object {url, content_type, file_name, file_size}GLB-muodossa generoitu 3D-malli.
seed
integerTodellisuudessa käytetty siemenen arvo.

Tekoälyagenteille: tämän sivun Markdown-muoto on osoitteessa https://doitong.com/fi/developers/models/pixal3d.md. Kaikki mallit ja oppaat: https://doitong.com/developers/llms.txt