Ir para o conteúdo

Pixal3d

Integrar

ID do modelo 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"

Esta solicitação: $ 0,30 300 créditos de API Executar nesta página

Obter chave de API
Open model Imagem para 3D #stylized#transform

Converte uma única imagem em um modelo 3D GLB texturizado, com controle detalhado sobre cada etapa de geração

Open model · 3D

Seu primeiro resultado aparecerá aqui

Monte uma requisição abaixo e execute-a com sua chave de API. As saídas são copiadas para nosso armazenamento, mantidas para sempre ou por 7 dias gratuitamente.

Criar uma solicitação

Os controles são gerados a partir do esquema do modelo. O código e o preço são atualizados conforme você os altera.

•obrigatório image_url
Solte um arquivo ou

URL que aponta para a imagem de origem da conversão 3D.

resolution padrão 1024

Resolução da saída; aumentá-la adiciona detalhes, mas leva mais tempo.

Avançado 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 padrão 2048

Resolução da textura da malha para baking. Detalhes de superfície mais refinados geram arquivos maiores quando essa resolução é aumentada.

padrão 7.5

Controle de fidelidade da estrutura 3D inicial: aumentá-lo favorece uma correspondência mais próxima com a imagem de entrada, com risco de ruído adicional.

padrão 0.7

Controle de artefatos de orientação do estágio 1, trocando efeitos de orientação mais fortes em configurações baixas por uma saída mais estável em configurações altas.

padrão 12

Quantidade de etapas de redução de ruído da estrutura inicial: possíveis ganhos de qualidade com etapas adicionais resultam em processamento mais lento.

padrão 5

Defina a nitidez da transição pela programação de ruído da geração da estrutura: aumentar este valor torna as transições mais nítidas.

padrão 7.5

Controle de fidelidade da geometria detalhada: aumentar a aderência à imagem de entrada adiciona detalhes, com risco de ruído adicional.

padrão 0.5

Aumente esta configuração quando a geometria parecer ruidosa: ela reduz artefatos causados por orientação forte durante o estágio de forma.

padrão 12

Quantidade de etapas de redução de ruído do refinamento da forma: uma geometria potencialmente mais suave custa velocidade quando são usadas etapas adicionais.

padrão 3

Defina a nitidez dos detalhes geométricos pela programação de ruído do refinamento da forma; aumentar este valor produz detalhes mais nítidos.

padrão 1

Controle de fidelidade das cores da textura: maior aderência às cores da imagem de entrada em configurações altas aumenta a vivacidade, mas pode causar saturação excessiva.

padrão 0

Aumente esta configuração para corrigir texturas ruidosas ou faixas de cor: ela reduz artefatos causados por orientação forte durante o estágio de textura.

padrão 12

Quantidade de etapas de redução de ruído usadas para gerar texturas. Aumentar essa quantidade demora mais, mas pode produzir texturas mais limpas.

padrão 3

Defina a nitidez dos detalhes da textura pela programação de ruído da geração da textura; aumentar este valor produz detalhes mais nítidos.

padrão 1

Escale a malha inferida para influenciar a estimativa de distância da câmera usada pelo modelo.

padrão 49152

Limite de tokens HR para o amostrador de formas em cascata, equilibrando uma geometria mais refinada em configurações altas com economia de memória e tempo de processamento em configurações baixas.

padrão 200000

Alvo de complexidade da malha, expresso como quantidade de vértices do resultado final. Reduzir o tamanho do arquivo diminuindo esse alvo também sacrifica detalhes.

Seed usado para geração aleatória reproduzível.

POST /run/pixal3d?wait=20 cotação → $ 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"

Executar esta solicitação

Sua chave permanece neste navegador: ela é enviada somente à Doitong API e salva (localStorage) apenas se você marcar Lembrar. Obter uma chave de API

Sobre Pixal3d

Recebe uma imagem e retorna um modelo GLB, além da semente usada. As etapas de estrutura, forma e textura têm suas próprias configurações de orientação, redimensionamento, contagem de passos e programação de ruído. A `resolution` de saída é 1024 ou 1536, `texture_size` é 1024, 2048 ou 4096, e `decimation_target` define a contagem de vértices de 5000 a 1586021. `remesh` reconstrói a topologia.

Parâmetros

Envie o nome canônico ou o nome nativo, não ambos. Nomes canônicos

NomeTipo PadrãoPermitido Descrição
image_urlobrigatório image
Tipourl · image
URL que aponta para a imagem de origem da conversão 3D.
seedopcional
Tipointeger | null
Seed usado para geração aleatória reproduzível.
resolutionopcional
Tipoenum
Padrão1024
10241536
Resolução da saída; aumentá-la adiciona detalhes, mas leva mais tempo.
ss_guidance_strengthopcional
Tiponumber
Padrão7.5
0 – 10
Controle de fidelidade da estrutura 3D inicial: aumentá-lo favorece uma correspondência mais próxima com a imagem de entrada, com risco de ruído adicional.
ss_guidance_rescaleopcional
Tiponumber
Padrão0.7
0 – 1
Controle de artefatos de orientação do estágio 1, trocando efeitos de orientação mais fortes em configurações baixas por uma saída mais estável em configurações altas.
ss_sampling_stepsopcional
Tipointeger
Padrão12
1 – 50
Quantidade de etapas de redução de ruído da estrutura inicial: possíveis ganhos de qualidade com etapas adicionais resultam em processamento mais lento.
ss_rescale_topcional
Tiponumber
Padrão5
1 – 6
Defina a nitidez da transição pela programação de ruído da geração da estrutura: aumentar este valor torna as transições mais nítidas.
shape_slat_guidance_strengthopcional
Tiponumber
Padrão7.5
0 – 10
Controle de fidelidade da geometria detalhada: aumentar a aderência à imagem de entrada adiciona detalhes, com risco de ruído adicional.
shape_slat_guidance_rescaleopcional
Tiponumber
Padrão0.5
0 – 1
Aumente esta configuração quando a geometria parecer ruidosa: ela reduz artefatos causados por orientação forte durante o estágio de forma.
shape_slat_sampling_stepsopcional
Tipointeger
Padrão12
1 – 50
Quantidade de etapas de redução de ruído do refinamento da forma: uma geometria potencialmente mais suave custa velocidade quando são usadas etapas adicionais.
shape_slat_rescale_topcional
Tiponumber
Padrão3
1 – 6
Defina a nitidez dos detalhes geométricos pela programação de ruído do refinamento da forma; aumentar este valor produz detalhes mais nítidos.
tex_slat_guidance_strengthopcional
Tiponumber
Padrão1
0 – 10
Controle de fidelidade das cores da textura: maior aderência às cores da imagem de entrada em configurações altas aumenta a vivacidade, mas pode causar saturação excessiva.
tex_slat_guidance_rescaleopcional
Tiponumber
Padrão0
0 – 1
Aumente esta configuração para corrigir texturas ruidosas ou faixas de cor: ela reduz artefatos causados por orientação forte durante o estágio de textura.
tex_slat_sampling_stepsopcional
Tipointeger
Padrão12
1 – 50
Quantidade de etapas de redução de ruído usadas para gerar texturas. Aumentar essa quantidade demora mais, mas pode produzir texturas mais limpas.
tex_slat_rescale_topcional
Tiponumber
Padrão3
1 – 6
Defina a nitidez dos detalhes da textura pela programação de ruído da geração da textura; aumentar este valor produz detalhes mais nítidos.
mesh_scaleopcional
Tiponumber
Padrão1
0,1 – 4
Escale a malha inferida para influenciar a estimativa de distância da câmera usada pelo modelo.
max_num_tokensopcional
Tipointeger
Padrão49152
4.096 – 131.072
Limite de tokens HR para o amostrador de formas em cascata, equilibrando uma geometria mais refinada em configurações altas com economia de memória e tempo de processamento em configurações baixas.
decimation_targetopcional
Tipointeger
Padrão200000
5.000 – 1.586.021
Alvo de complexidade da malha, expresso como quantidade de vértices do resultado final. Reduzir o tamanho do arquivo diminuindo esse alvo também sacrifica detalhes.
texture_sizeopcional
Tipoenum
Padrão2048
102420484096
Resolução da textura da malha para baking. Detalhes de superfície mais refinados geram arquivos maiores quando essa resolução é aumentada.
remeshopcional
Tipoboolean
Padrãotrue
Reconstrução da topologia da malha que geralmente beneficia o uso posterior ao criar triângulos mais limpos, ao custo de um processamento mais longo.
enable_safety_checkeropcional
Tipoboolean
Padrãotrue
A filtragem pode ser relaxada definindo false, desde que o chamador esteja autorizado.
obrigatório Nome canônico, também aceito

Os parâmetros de arquivo aceitam uma URL https:// pública, um URI data: de até 10 MB ou o file_url de um upload. Arquivos

Saída

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"
  }
}
Seus arquivos, sua escolhaCada outputs[].url é uma cópia em nosso armazenamento: mantida para sempre (cobrada por GB-mês) ou por 7 dias gratuitamente, conforme a configuração da sua conta ou ?storage=.
Mesmo formato em todos os modelostype, url, content_type, width, height e duration, para imagens, vídeos e áudios. output é o próprio objeto de resultado do modelo.
Campos da saída
model_glb
object {url, content_type, file_name, file_size}Modelo 3D gerado no formato GLB.
seed
integerValor de seed realmente usado.

Para agentes de IA: esta página em Markdown está em https://doitong.com/pt-BR/developers/models/pixal3d.md. Todos os modelos e guias: https://doitong.com/developers/llms.txt