Vai al contenuto

Pixal3d

Integra

ID del modello 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"

Questa richiesta: 0,30 $ 300 crediti API · ≈ 31,64 ₽ Esegui in questa pagina

Ottieni la chiave API
Open model Da immagine a 3D #stylized#transform

Converte una singola immagine in un modello 3D GLB texturizzato con controllo dettagliato su ogni fase di generazione

Open model · 3D

Il tuo primo risultato apparirà qui

Crea una richiesta qui sotto ed eseguila con la tua chiave API. Gli output vengono copiati nella nostra archiviazione, conservati per sempre oppure 7 giorni gratuitamente.

Crea una richiesta

I controlli vengono generati dallo schema del modello. Il codice e il prezzo si aggiornano mentre li modifichi.

•obbligatorio image_url
Trascina un file oppure

URL che punta all'immagine sorgente per la conversione 3D.

resolution predefinito 1024

Risoluzione dell'output; aumentarla aggiunge dettagli ma richiede più tempo.

Avanzate 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 predefinito 2048

Risoluzione della texture della mesh per il baking. Un maggiore dettaglio della superficie comporta file più grandi quando si aumenta questa risoluzione.

predefinito 7.5

Controllo della fedeltà della struttura 3D iniziale: aumentarlo favorisce una maggiore corrispondenza con l'immagine input, con il rischio di più rumore.

predefinito 0.7

Controllo degli artefatti di guida dello stage 1, che privilegia effetti di guida più forti ai valori bassi e un output più stabile ai valori alti.

predefinito 12

Numero di passaggi di denoising della struttura iniziale: i possibili miglioramenti della qualità con passaggi aggiuntivi comportano un'elaborazione più lenta.

predefinito 5

Imposta la nitidezza della transizione tramite il programma di rumore della generazione della struttura: aumentare questo valore rende le transizioni più nette.

predefinito 7.5

Controllo della fedeltà della geometria dettagliata: aumentare l'aderenza all'immagine input aggiunge dettagli, con il rischio di più rumore.

predefinito 0.5

Aumenta questa impostazione quando la geometria appare rumorosa: riduce gli artefatti causati da una guida forte durante lo stage della forma.

predefinito 12

Numero di passaggi di denoising per il perfezionamento della forma: usare passaggi aggiuntivi può rendere la geometria più uniforme, a scapito della velocità.

predefinito 3

Imposta la nitidezza dei dettagli geometrici tramite il programma di rumore del perfezionamento della forma; aumentare questo valore produce dettagli più netti.

predefinito 1

Controllo della fedeltà cromatica della texture: una maggiore aderenza ai colori dell'immagine input con impostazioni elevate aumenta la vividezza, ma può causare sovrasaturazione.

predefinito 0

Aumenta questa impostazione per correggere texture rumorose o bande di colore: riduce gli artefatti causati da una guida forte durante lo stage della texture.

predefinito 12

Numero di passaggi di denoising usati per generare le texture. Aumentare il numero di passaggi richiede più tempo ma può produrre texture più pulite.

predefinito 3

Imposta la nitidezza dei dettagli della texture tramite il programma di rumore della generazione della texture; aumentare questo valore produce dettagli più netti.

predefinito 1

Ridimensiona la mesh per influenzare la stima della distanza della fotocamera usata dal modello.

predefinito 49152

Limite di token HR per il campionatore di forme concatenato, che bilancia una geometria più dettagliata con impostazioni elevate e il risparmio di memoria e tempo di elaborazione con impostazioni basse.

predefinito 200000

Obiettivo di complessità della mesh, espresso come numero di vertici del risultato finale. Ridurre la dimensione del file abbassando questo obiettivo comporta anche una perdita di dettagli.

Seed usato per una generazione casuale riproducibile.

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

Esegui questa richiesta

La tua chiave rimane in questo browser: viene inviata solo al Doitong API e salvata in localStorage solo se selezioni Ricorda. Ottieni una chiave API

Informazioni su Pixal3d

Accetta un'immagine e restituisce un modello GLB insieme al seed usato. Le fasi di struttura, forma e texture hanno impostazioni proprie per guida, ridimensionamento, numero di passaggi e programma del rumore. L'output `resolution` è 1024 o 1536, `texture_size` è 1024, 2048 o 4096 e `decimation_target` imposta il numero di vertici da 5000 a 1586021. `remesh` ricostruisce la topologia.

Parametri

Invia il nome canonico oppure il nome nativo, non entrambi. Nomi canonici

NomeTipo PredefinitoConsentiti Descrizione
image_urlobbligatorio image
Tipourl · image
URL che punta all'immagine sorgente per la conversione 3D.
seedfacoltativo
Tipointeger | null
Seed usato per una generazione casuale riproducibile.
resolutionfacoltativo
Tipoenum
Predefinito1024
10241536
Risoluzione dell'output; aumentarla aggiunge dettagli ma richiede più tempo.
ss_guidance_strengthfacoltativo
Tiponumber
Predefinito7.5
0 – 10
Controllo della fedeltà della struttura 3D iniziale: aumentarlo favorisce una maggiore corrispondenza con l'immagine input, con il rischio di più rumore.
ss_guidance_rescalefacoltativo
Tiponumber
Predefinito0.7
0 – 1
Controllo degli artefatti di guida dello stage 1, che privilegia effetti di guida più forti ai valori bassi e un output più stabile ai valori alti.
ss_sampling_stepsfacoltativo
Tipointeger
Predefinito12
1 – 50
Numero di passaggi di denoising della struttura iniziale: i possibili miglioramenti della qualità con passaggi aggiuntivi comportano un'elaborazione più lenta.
ss_rescale_tfacoltativo
Tiponumber
Predefinito5
1 – 6
Imposta la nitidezza della transizione tramite il programma di rumore della generazione della struttura: aumentare questo valore rende le transizioni più nette.
shape_slat_guidance_strengthfacoltativo
Tiponumber
Predefinito7.5
0 – 10
Controllo della fedeltà della geometria dettagliata: aumentare l'aderenza all'immagine input aggiunge dettagli, con il rischio di più rumore.
shape_slat_guidance_rescalefacoltativo
Tiponumber
Predefinito0.5
0 – 1
Aumenta questa impostazione quando la geometria appare rumorosa: riduce gli artefatti causati da una guida forte durante lo stage della forma.
shape_slat_sampling_stepsfacoltativo
Tipointeger
Predefinito12
1 – 50
Numero di passaggi di denoising per il perfezionamento della forma: usare passaggi aggiuntivi può rendere la geometria più uniforme, a scapito della velocità.
shape_slat_rescale_tfacoltativo
Tiponumber
Predefinito3
1 – 6
Imposta la nitidezza dei dettagli geometrici tramite il programma di rumore del perfezionamento della forma; aumentare questo valore produce dettagli più netti.
tex_slat_guidance_strengthfacoltativo
Tiponumber
Predefinito1
0 – 10
Controllo della fedeltà cromatica della texture: una maggiore aderenza ai colori dell'immagine input con impostazioni elevate aumenta la vividezza, ma può causare sovrasaturazione.
tex_slat_guidance_rescalefacoltativo
Tiponumber
Predefinito0
0 – 1
Aumenta questa impostazione per correggere texture rumorose o bande di colore: riduce gli artefatti causati da una guida forte durante lo stage della texture.
tex_slat_sampling_stepsfacoltativo
Tipointeger
Predefinito12
1 – 50
Numero di passaggi di denoising usati per generare le texture. Aumentare il numero di passaggi richiede più tempo ma può produrre texture più pulite.
tex_slat_rescale_tfacoltativo
Tiponumber
Predefinito3
1 – 6
Imposta la nitidezza dei dettagli della texture tramite il programma di rumore della generazione della texture; aumentare questo valore produce dettagli più netti.
mesh_scalefacoltativo
Tiponumber
Predefinito1
0,1 – 4
Ridimensiona la mesh per influenzare la stima della distanza della fotocamera usata dal modello.
max_num_tokensfacoltativo
Tipointeger
Predefinito49152
4096 – 131.072
Limite di token HR per il campionatore di forme concatenato, che bilancia una geometria più dettagliata con impostazioni elevate e il risparmio di memoria e tempo di elaborazione con impostazioni basse.
decimation_targetfacoltativo
Tipointeger
Predefinito200000
5000 – 1.586.021
Obiettivo di complessità della mesh, espresso come numero di vertici del risultato finale. Ridurre la dimensione del file abbassando questo obiettivo comporta anche una perdita di dettagli.
texture_sizefacoltativo
Tipoenum
Predefinito2048
102420484096
Risoluzione della texture della mesh per il baking. Un maggiore dettaglio della superficie comporta file più grandi quando si aumenta questa risoluzione.
remeshfacoltativo
Tipoboolean
Predefinitotrue
Ricostruzione della topologia della mesh, generalmente utile per l'uso downstream perché crea triangoli più puliti, a fronte di un'elaborazione più lunga.
enable_safety_checkerfacoltativo
Tipoboolean
Predefinitotrue
Il controllo può essere allentato impostando false, se il chiamante è autorizzato.
obbligatorio Nome canonico, accettato anche

I parametri file accettano un URL pubblico https://, un URI data: fino a 10 MB oppure il file_url di un caricamento. File

Output

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"
  }
}
I tuoi file, la tua sceltaOgni outputs[].url è una copia nella nostra archiviazione: conservata per sempre (a pagamento per GB-mese) oppure 7 giorni gratuitamente, in base all'impostazione dell'account o a ?storage=.
Stessa struttura per ogni modellotype, url, content_type, width, height e duration, per immagini, video e audio. output è l'oggetto risultato del modello.
Campi dell'output
model_glb
object {url, content_type, file_name, file_size}Modello 3D generato in formato GLB.
seed
integerValore del seed effettivamente usato.

Per gli agenti AI: questa pagina in Markdown è disponibile all'indirizzo https://doitong.com/it/developers/models/pixal3d.md. Tutti i modelli e le guide: https://doitong.com/developers/llms.txt