Přejít na obsah

Pixal3d

Integrace

ID modelu 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"

Tento požadavek: 0,30 $ 300 kreditů API · ≈ 31,64 ₽ Spustit na této stránce

Získat API klíč
Open model Obrázek na 3D #stylized#transform

Převádí jediný obrázek na texturovaný 3D model GLB s podrobným řízením každé fáze generování

Open model · 3D

Zde se zobrazí váš první výsledek

Níže sestavte požadavek a spusťte ho pomocí svého API klíče. Výstupy se kopírují do našeho úložiště a uchovávají se navždy nebo 7 dne zdarma.

Sestavit požadavek

Ovládací prvky se generují ze schématu modelu. Kód a cena se aktualizují podle provedených změn.

•povinné image_url
Přetáhněte soubor nebo

URL odkazující na zdrojový obrázek pro převod do 3D.

resolution výchozí 1024

Rozlišení výstupu; jeho zvýšení přidá detaily, ale prodlouží zpracování.

Pokročilé 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 výchozí 2048

Rozlišení textury sítě pro baking. Zvýšení rozlišení přináší jemnější povrchové detaily, ale větší soubory.

výchozí 7.5

Řízení věrnosti počáteční 3D struktury: zvýšení podporuje lepší shodu se vstupním obrázkem za cenu dodatečného šumu.

výchozí 0.7

Řízení artefaktů vedení ve fázi 1, které při nízkých hodnotách upřednostňuje silnější účinky vedení a při vysokých stabilnější výstup.

výchozí 12

Počet kroků odšumování počáteční struktury: případné zvýšení kvality dalšími kroky zpomaluje zpracování.

výchozí 5

Nastavte ostrost přechodů pomocí rozvrhu šumu generování struktury: zvýšení této hodnoty přechody zostří.

výchozí 7.5

Řízení věrnosti detailní geometrie: vyšší shoda se vstupním obrázkem přidává detaily, ale hrozí dodatečný šum.

výchozí 0.5

Toto nastavení zvyšte, pokud geometrie vypadá zašuměně; omezí artefakty způsobené silným vedením během fáze tvaru.

výchozí 12

Počet kroků odšumování pro vylepšení tvaru: další kroky mohou vytvořit hladší geometrii, ale zpomalí zpracování.

výchozí 3

Nastavte ostrost geometrických detailů pomocí rozvrhu šumu vylepšení tvaru; zvýšení této hodnoty vytvoří ostřejší detaily.

výchozí 1

Řízení věrnosti barev textury: vyšší shoda s barvami vstupního obrázku zvyšuje živost, ale může způsobit přesycení.

výchozí 0

Toto nastavení zvyšte pro řešení zašuměných textur nebo pruhování barev; omezí artefakty způsobené silným vedením během fáze textury.

výchozí 12

Počet kroků odšumování použitých k vytvoření textur. Vyšší počet trvá déle, ale může vytvořit čistší textury.

výchozí 3

Nastavte ostrost detailů textury pomocí rozvrhu šumu generování textury; zvýšení této hodnoty vytvoří ostřejší detaily.

výchozí 1

Změňte měřítko odvozené sítě a ovlivněte odhad vzdálenosti kamery používaný modelem.

výchozí 49152

Limit tokenů HR pro kaskádový sampler tvaru, který při vyšších hodnotách podporuje jemnější geometrii a při nižších šetří paměť a čas zpracování.

výchozí 200000

Cílová složitost sítě vyjádřená počtem vrcholů výsledku. Snížení velikosti souboru zmenšením tohoto cíle obětuje detaily.

Seed použitý pro reprodukovatelné náhodné generování.

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

Spustit tento požadavek

Váš klíč zůstává v tomto prohlížeči: odesílá se pouze do Doitong API a uloží se do localStorage jen tehdy, když zaškrtnete možnost Zapamatovat. Získat klíč API

O modelu Pixal3d

Přijímá jeden obrázek a vrací model GLB spolu s použitým seed. Fáze struktury, tvaru a textury mají vlastní nastavení vedení, změny měřítka, počtu kroků a rozvrhu šumu. Výstupní `resolution` je 1024 nebo 1536, `texture_size` je 1024, 2048 nebo 4096 a `decimation_target` určuje počet vrcholů od 5000 do 1586021. `remesh` znovu vytvoří topologii.

Parametry

Odešlete buď kanonický název, nebo nativní název, ne oba. Kanonické názvy

NázevTyp VýchozíPovolené Popis
image_urlpovinné image
Typurl · image
URL odkazující na zdrojový obrázek pro převod do 3D.
seedvolitelné
Typinteger | null
Seed použitý pro reprodukovatelné náhodné generování.
resolutionvolitelné
Typenum
Výchozí1024
10241536
Rozlišení výstupu; jeho zvýšení přidá detaily, ale prodlouží zpracování.
ss_guidance_strengthvolitelné
Typnumber
Výchozí7.5
0 – 10
Řízení věrnosti počáteční 3D struktury: zvýšení podporuje lepší shodu se vstupním obrázkem za cenu dodatečného šumu.
ss_guidance_rescalevolitelné
Typnumber
Výchozí0.7
0 – 1
Řízení artefaktů vedení ve fázi 1, které při nízkých hodnotách upřednostňuje silnější účinky vedení a při vysokých stabilnější výstup.
ss_sampling_stepsvolitelné
Typinteger
Výchozí12
1 – 50
Počet kroků odšumování počáteční struktury: případné zvýšení kvality dalšími kroky zpomaluje zpracování.
ss_rescale_tvolitelné
Typnumber
Výchozí5
1 – 6
Nastavte ostrost přechodů pomocí rozvrhu šumu generování struktury: zvýšení této hodnoty přechody zostří.
shape_slat_guidance_strengthvolitelné
Typnumber
Výchozí7.5
0 – 10
Řízení věrnosti detailní geometrie: vyšší shoda se vstupním obrázkem přidává detaily, ale hrozí dodatečný šum.
shape_slat_guidance_rescalevolitelné
Typnumber
Výchozí0.5
0 – 1
Toto nastavení zvyšte, pokud geometrie vypadá zašuměně; omezí artefakty způsobené silným vedením během fáze tvaru.
shape_slat_sampling_stepsvolitelné
Typinteger
Výchozí12
1 – 50
Počet kroků odšumování pro vylepšení tvaru: další kroky mohou vytvořit hladší geometrii, ale zpomalí zpracování.
shape_slat_rescale_tvolitelné
Typnumber
Výchozí3
1 – 6
Nastavte ostrost geometrických detailů pomocí rozvrhu šumu vylepšení tvaru; zvýšení této hodnoty vytvoří ostřejší detaily.
tex_slat_guidance_strengthvolitelné
Typnumber
Výchozí1
0 – 10
Řízení věrnosti barev textury: vyšší shoda s barvami vstupního obrázku zvyšuje živost, ale může způsobit přesycení.
tex_slat_guidance_rescalevolitelné
Typnumber
Výchozí0
0 – 1
Toto nastavení zvyšte pro řešení zašuměných textur nebo pruhování barev; omezí artefakty způsobené silným vedením během fáze textury.
tex_slat_sampling_stepsvolitelné
Typinteger
Výchozí12
1 – 50
Počet kroků odšumování použitých k vytvoření textur. Vyšší počet trvá déle, ale může vytvořit čistší textury.
tex_slat_rescale_tvolitelné
Typnumber
Výchozí3
1 – 6
Nastavte ostrost detailů textury pomocí rozvrhu šumu generování textury; zvýšení této hodnoty vytvoří ostřejší detaily.
mesh_scalevolitelné
Typnumber
Výchozí1
0,1 – 4
Změňte měřítko odvozené sítě a ovlivněte odhad vzdálenosti kamery používaný modelem.
max_num_tokensvolitelné
Typinteger
Výchozí49152
4 096 – 131 072
Limit tokenů HR pro kaskádový sampler tvaru, který při vyšších hodnotách podporuje jemnější geometrii a při nižších šetří paměť a čas zpracování.
decimation_targetvolitelné
Typinteger
Výchozí200000
5 000 – 1 586 021
Cílová složitost sítě vyjádřená počtem vrcholů výsledku. Snížení velikosti souboru zmenšením tohoto cíle obětuje detaily.
texture_sizevolitelné
Typenum
Výchozí2048
102420484096
Rozlišení textury sítě pro baking. Zvýšení rozlišení přináší jemnější povrchové detaily, ale větší soubory.
remeshvolitelné
Typboolean
Výchozítrue
Přestavba topologie sítě, která obecně usnadňuje následné použití tvorbou čistších trojúhelníků za cenu delšího zpracování.
enable_safety_checkervolitelné
Typboolean
Výchozítrue
Kontrolu lze uvolnit nastavením na false, pokud je volající autorizován.
povinné Kanonický název, také podporován

Parametry souborů přijímají veřejnou adresu https:// URL, data: URI do 10 MB nebo file_url nahraného souboru. Soubory

Výstup

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"
  }
}
Vaše soubory, vaše volbaKaždý outputs[].url je kopie v našem úložišti: uchovávaná navždy (zpoplatněná za GB-měsíc) nebo 7 dne zdarma podle nastavení účtu nebo ?storage=.
Stejná struktura u každého modelutype, url, content_type, width, height a duration pro obrázky, video i zvuk. output je vlastní objekt výsledku modelu.
Pole výstupu
model_glb
object {url, content_type, file_name, file_size}3D model vygenerovaný ve formátu GLB.
seed
integerSkutečně použitá hodnota seedu.

Pro AI agenty: tato stránka je ve formátu Markdown na adrese https://doitong.com/cs/developers/models/pixal3d.md. Všechny modely a návody: https://doitong.com/developers/llms.txt