Ugrás a tartalomhoz

Pixal3d

Integráció

Modellazonosító 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"

Ez a kérés: 0,30 $ 300 API-jóváírás · ≈ 31,64 ₽ Futtatás ezen az oldalon

API-kulcs beszerzése
Open model Képből 3D #stylized#transform

Egyetlen képet részletesen vezérelhető, textúrázott GLB 3D-modellé alakít

Open model · 3D

Az első eredményed itt jelenik meg

Állíts össze egy kérést alább, majd futtasd az API-kulcsoddal. A kimeneteket a tárhelyünkre másoljuk, és örökre vagy 7 nap ideig ingyenesen őrizzük meg.

Kérés összeállítása

A vezérlők a modell sémájából jönnek létre. A kód és az ár a módosításokkal együtt frissül.

•kötelező image_url
Húzz egy fájlt ide, vagy

A 3D-konverzióhoz használt forrásképre mutató URL.

resolution alapértelmezett: 1024

A kimenet felbontása; növelése részletesebb eredményt ad, de hosszabb ideig tart.

Speciális 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 alapértelmezett: 2048

A háló textúrafelvételeinek felbontása. A felbontás növelése finomabb felületi részleteket ad, de nagyobb fájlokat eredményez.

alapértelmezett: 7.5

A kezdeti 3D-struktúra hűségének vezérlése: növelése a bemeneti képhez való szorosabb egyezést részesíti előnyben, további zaj kockázatával.

alapértelmezett: 0.7

Az 1. szakasz vezérlési műtermékeinek beállítása: alacsony értékeknél erősebb vezérlési hatást, magas értékeknél stabilabb kimenetet biztosít.

alapértelmezett: 12

A kezdeti struktúra zajmentesítési lépésszáma: a további lépések lehetséges minőségjavulása lassabb feldolgozással jár.

alapértelmezett: 5

Az átmenet élességének beállítása a struktúragenerálás zajütemezésén keresztül: az érték növelése élesebb átmeneteket eredményez.

alapértelmezett: 7.5

A részletes geometria hűségének vezérlése: a bemeneti képhez való nagyobb igazodás további részleteket ad, de növeli a zaj kockázatát.

alapértelmezett: 0.5

Növelje ezt a beállítást, ha a geometria zajos: csökkenti az alakfázisban az erős vezérlés okozta műtermékeket.

alapértelmezett: 12

Az alakfinomítás zajmentesítési lépésszáma: további lépések használatakor simább geometria érhető el, a sebesség rovására.

alapértelmezett: 3

A geometriai részletek élességének beállítása az alakfinomítás zajütemezésén keresztül; az érték növelése élesebb részleteket eredményez.

alapértelmezett: 1

A textúraszínek hűségének vezérlése: magasabb értékeknél a bemeneti kép színeihez való szorosabb igazodás élénkebb színeket adhat, de túltelítettséget okozhat.

alapértelmezett: 0

Növelje ezt a beállítást zajos textúrák vagy színsávosodás esetén: csökkenti a textúrafázisban az erős vezérlés okozta műtermékeket.

alapértelmezett: 12

A textúrák generálásához használt zajmentesítési lépések száma. A lépésszám növelése hosszabb feldolgozást igényelhet, de tisztább textúrákat eredményezhet.

alapértelmezett: 3

A textúrarészletek élességének beállítása a textúragenerálás zajütemezésén keresztül; az érték növelése élesebb részleteket eredményez.

alapértelmezett: 1

A következtetett háló méretezése a modell által használt kameratávolság-becslés befolyásolásához.

alapértelmezett: 49152

A kaszkádolt alakmintavevő HR-tokenkorlátja: magasabb értékeknél finomabb geometriát, alacsonyabb értékeknél memóriamegtakarítást és rövidebb feldolgozási időt biztosít.

alapértelmezett: 200000

A háló komplexitásának célértéke, a végső eredmény csúcsszámával megadva. A célérték csökkentésével csökken a fájlméret, de a részletesség is.

Reprodukálható véletlenszerű generáláshoz használt seed.

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

Kérés futtatása

A kulcsod ebben a böngészőben marad: csak a Doitong API-nak küldjük el, és csak akkor mentjük a localStorage-ba, ha bejelölöd az Emlékezz rám lehetőséget. API-kulcs igénylése

A(z) Pixal3d bemutatása

Egy képet fogad, és egy GLB-modellt, valamint a használt seedet adja vissza. A szerkezet, az alak és a textúra szakaszai saját útmutatási, újraméretezési, lépésszám- és zajütemezési beállításokkal rendelkeznek. A kimeneti `resolution` 1024 vagy 1536, a `texture_size` 1024, 2048 vagy 4096, a `decimation_target` pedig 5000 és 1586021 közötti csúcspontszámot állít be. A `remesh` újraépíti a topológiát.

Paraméterek

Küldd el a kanonikus nevet vagy a natív nevet, de ne mindkettőt. Kanonikus nevek

NévTípus AlapértelmezettEngedélyezett Leírás
image_urlkötelező image
Típusurl · image
A 3D-konverzióhoz használt forrásképre mutató URL.
seednem kötelező
Típusinteger | null
Reprodukálható véletlenszerű generáláshoz használt seed.
resolutionnem kötelező
Típusenum
Alapértelmezett1024
10241536
A kimenet felbontása; növelése részletesebb eredményt ad, de hosszabb ideig tart.
ss_guidance_strengthnem kötelező
Típusnumber
Alapértelmezett7.5
0 – 10
A kezdeti 3D-struktúra hűségének vezérlése: növelése a bemeneti képhez való szorosabb egyezést részesíti előnyben, további zaj kockázatával.
ss_guidance_rescalenem kötelező
Típusnumber
Alapértelmezett0.7
0 – 1
Az 1. szakasz vezérlési műtermékeinek beállítása: alacsony értékeknél erősebb vezérlési hatást, magas értékeknél stabilabb kimenetet biztosít.
ss_sampling_stepsnem kötelező
Típusinteger
Alapértelmezett12
1 – 50
A kezdeti struktúra zajmentesítési lépésszáma: a további lépések lehetséges minőségjavulása lassabb feldolgozással jár.
ss_rescale_tnem kötelező
Típusnumber
Alapértelmezett5
1 – 6
Az átmenet élességének beállítása a struktúragenerálás zajütemezésén keresztül: az érték növelése élesebb átmeneteket eredményez.
shape_slat_guidance_strengthnem kötelező
Típusnumber
Alapértelmezett7.5
0 – 10
A részletes geometria hűségének vezérlése: a bemeneti képhez való nagyobb igazodás további részleteket ad, de növeli a zaj kockázatát.
shape_slat_guidance_rescalenem kötelező
Típusnumber
Alapértelmezett0.5
0 – 1
Növelje ezt a beállítást, ha a geometria zajos: csökkenti az alakfázisban az erős vezérlés okozta műtermékeket.
shape_slat_sampling_stepsnem kötelező
Típusinteger
Alapértelmezett12
1 – 50
Az alakfinomítás zajmentesítési lépésszáma: további lépések használatakor simább geometria érhető el, a sebesség rovására.
shape_slat_rescale_tnem kötelező
Típusnumber
Alapértelmezett3
1 – 6
A geometriai részletek élességének beállítása az alakfinomítás zajütemezésén keresztül; az érték növelése élesebb részleteket eredményez.
tex_slat_guidance_strengthnem kötelező
Típusnumber
Alapértelmezett1
0 – 10
A textúraszínek hűségének vezérlése: magasabb értékeknél a bemeneti kép színeihez való szorosabb igazodás élénkebb színeket adhat, de túltelítettséget okozhat.
tex_slat_guidance_rescalenem kötelező
Típusnumber
Alapértelmezett0
0 – 1
Növelje ezt a beállítást zajos textúrák vagy színsávosodás esetén: csökkenti a textúrafázisban az erős vezérlés okozta műtermékeket.
tex_slat_sampling_stepsnem kötelező
Típusinteger
Alapértelmezett12
1 – 50
A textúrák generálásához használt zajmentesítési lépések száma. A lépésszám növelése hosszabb feldolgozást igényelhet, de tisztább textúrákat eredményezhet.
tex_slat_rescale_tnem kötelező
Típusnumber
Alapértelmezett3
1 – 6
A textúrarészletek élességének beállítása a textúragenerálás zajütemezésén keresztül; az érték növelése élesebb részleteket eredményez.
mesh_scalenem kötelező
Típusnumber
Alapértelmezett1
0,1 – 4
A következtetett háló méretezése a modell által használt kameratávolság-becslés befolyásolásához.
max_num_tokensnem kötelező
Típusinteger
Alapértelmezett49152
4096 – 131 072
A kaszkádolt alakmintavevő HR-tokenkorlátja: magasabb értékeknél finomabb geometriát, alacsonyabb értékeknél memóriamegtakarítást és rövidebb feldolgozási időt biztosít.
decimation_targetnem kötelező
Típusinteger
Alapértelmezett200000
5000 – 1 586 021
A háló komplexitásának célértéke, a végső eredmény csúcsszámával megadva. A célérték csökkentésével csökken a fájlméret, de a részletesség is.
texture_sizenem kötelező
Típusenum
Alapértelmezett2048
102420484096
A háló textúrafelvételeinek felbontása. A felbontás növelése finomabb felületi részleteket ad, de nagyobb fájlokat eredményez.
remeshnem kötelező
Típusboolean
Alapértelmezetttrue
A háló topológiájának újraépítése, amely tisztább háromszögek létrehozásával általában javítja a további felhasználást, hosszabb feldolgozási idő árán.
enable_safety_checkernem kötelező
Típusboolean
Alapértelmezetttrue
A szűrés a false érték beállításával enyhíthető, ha a hívó jogosult erre.
kötelező Kanonikus név, szintén elfogadva

A fájlparaméterek nyilvános https:// URL-t, legfeljebb 10 MB-os data: URI-t vagy egy feltöltés file_url értékét fogadják el. Fájlok

Kimenet

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"
  }
}
Az Ön fájljai, az Ön döntéseMinden outputs[].url a tárhelyünkön lévő másolat: örökre megőrizve (GB-hónaponként fizetve) vagy 7 nap ideig ingyenesen, a fiókbeállításod vagy a ?storage= alapján.
Azonos struktúra minden modellentype, url, content_type, width, height és duration képekhez, videókhoz és hanganyagokhoz egyaránt. Az output a modell saját eredményobjektuma.
A kimenet mezői
model_glb
object {url, content_type, file_name, file_size}GLB formátumban generált 3D-modell.
seed
integerA ténylegesen használt seedérték.

AI-ügynököknek: ez az oldal Markdown formátumban itt található: https://doitong.com/hu/developers/models/pixal3d.md. Minden modell és útmutató: https://doitong.com/developers/llms.txt