Avançar 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.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"

Este pedido: 0,30 $ 300 créditos da API · ≈ 31,64 ₽ Executar nesta página

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

Converte uma única imagem num modelo 3D GLB texturizado, com controlo detalhado sobre cada fase de geração

Open model · 3D

O seu primeiro resultado aparece aqui

Crie um pedido abaixo e execute-o com a sua chave de API. As saídas são copiadas para o nosso armazenamento, guardadas para sempre ou durante 7 dias gratuitamente.

Criar um pedido

Os controlos são gerados a partir do esquema do modelo. O código e o preço são atualizados à medida que os altera.

•obrigatório image_url
Largue um ficheiro ou

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

resolution predefinição 1024

Resolução da saída; aumentá-la adiciona detalhes, mas demora 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 predefinição 2048

Resolução da textura da malha para baking. Um detalhe de superfície mais fino implica ficheiros maiores quando esta resolução é aumentada.

predefinição 7.5

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

predefinição 0.7

Controlo de artefactos de orientação da fase 1, trocando efeitos de orientação mais fortes em definições baixas por uma saída mais estável em definições altas.

predefinição 12

Número de passos de denoising da estrutura inicial: os possíveis ganhos de qualidade com passos adicionais implicam um processamento mais lento.

predefinição 5

Defina a nitidez da transição através do calendário de ruído de geração da estrutura: aumentar este valor torna as transições mais nítidas.

predefinição 7.5

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

predefinição 0.5

Aumente esta definição quando a geometria apresentar ruído: reduz os artefactos causados por uma orientação forte durante a fase de forma.

predefinição 12

Número de passos de denoising do refinamento da forma: uma geometria potencialmente mais suave sacrifica velocidade quando são usados passos adicionais.

predefinição 3

Defina a nitidez dos detalhes geométricos através do calendário de ruído do refinamento da forma; aumentar este valor produz detalhes mais nítidos.

predefinição 1

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

predefinição 0

Aumente esta definição para corrigir texturas com ruído ou bandas de cor: reduz os artefactos causados por uma orientação forte durante a fase de textura.

predefinição 12

Número de passos de denoising usados para gerar texturas. Aumentar o número de passos demora mais tempo, mas pode produzir texturas mais limpas.

predefinição 3

Defina a nitidez dos detalhes da textura através do calendário de ruído de geração da textura; aumentar este valor produz detalhes mais nítidos.

predefinição 1

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

predefinição 49152

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

predefinição 200000

Objetivo de complexidade da malha, expresso como número de vértices do resultado final. Reduzir o tamanho do ficheiro diminuindo este objetivo 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.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"

Executar este pedido

A sua chave permanece neste navegador: é enviada apenas para a Doitong API e guardada em localStorage apenas se selecionar Lembrar. Obter uma chave de API

Sobre Pixal3d

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

Parâmetros

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

NomeTipo Predefiniçã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
Predefinição1024
10241536
Resolução da saída; aumentá-la adiciona detalhes, mas demora mais tempo.
ss_guidance_strengthopcional
Tiponumber
Predefinição7.5
0 – 10
Controlo inicial da fidelidade da estrutura 3D: aumentá-lo favorece uma maior correspondência com a imagem de entrada, com risco de ruído adicional.
ss_guidance_rescaleopcional
Tiponumber
Predefinição0.7
0 – 1
Controlo de artefactos de orientação da fase 1, trocando efeitos de orientação mais fortes em definições baixas por uma saída mais estável em definições altas.
ss_sampling_stepsopcional
Tipointeger
Predefinição12
1 – 50
Número de passos de denoising da estrutura inicial: os possíveis ganhos de qualidade com passos adicionais implicam um processamento mais lento.
ss_rescale_topcional
Tiponumber
Predefinição5
1 – 6
Defina a nitidez da transição através do calendário de ruído de geração da estrutura: aumentar este valor torna as transições mais nítidas.
shape_slat_guidance_strengthopcional
Tiponumber
Predefinição7.5
0 – 10
Controlo da fidelidade da geometria detalhada: aumentar a aderência à imagem de entrada adiciona detalhes, com risco de ruído adicional.
shape_slat_guidance_rescaleopcional
Tiponumber
Predefinição0.5
0 – 1
Aumente esta definição quando a geometria apresentar ruído: reduz os artefactos causados por uma orientação forte durante a fase de forma.
shape_slat_sampling_stepsopcional
Tipointeger
Predefinição12
1 – 50
Número de passos de denoising do refinamento da forma: uma geometria potencialmente mais suave sacrifica velocidade quando são usados passos adicionais.
shape_slat_rescale_topcional
Tiponumber
Predefinição3
1 – 6
Defina a nitidez dos detalhes geométricos através do calendário de ruído do refinamento da forma; aumentar este valor produz detalhes mais nítidos.
tex_slat_guidance_strengthopcional
Tiponumber
Predefinição1
0 – 10
Controlo da fidelidade das cores da textura: uma maior aderência às cores da imagem de entrada em definições mais altas aumenta a vivacidade, mas pode causar saturação excessiva.
tex_slat_guidance_rescaleopcional
Tiponumber
Predefinição0
0 – 1
Aumente esta definição para corrigir texturas com ruído ou bandas de cor: reduz os artefactos causados por uma orientação forte durante a fase de textura.
tex_slat_sampling_stepsopcional
Tipointeger
Predefinição12
1 – 50
Número de passos de denoising usados para gerar texturas. Aumentar o número de passos demora mais tempo, mas pode produzir texturas mais limpas.
tex_slat_rescale_topcional
Tiponumber
Predefinição3
1 – 6
Defina a nitidez dos detalhes da textura através do calendário de ruído de geração da textura; aumentar este valor produz detalhes mais nítidos.
mesh_scaleopcional
Tiponumber
Predefinição1
0,1 – 4
Escale a malha inferida para influenciar a estimativa da distância da câmara usada pelo modelo.
max_num_tokensopcional
Tipointeger
Predefinição49152
4096 – 131 072
Limite de tokens HR para o amostrador de formas em cascata, equilibrando uma geometria mais fina em definições altas com poupanças de memória e tempo de processamento em definições baixas.
decimation_targetopcional
Tipointeger
Predefinição200000
5000 – 1 586 021
Objetivo de complexidade da malha, expresso como número de vértices do resultado final. Reduzir o tamanho do ficheiro diminuindo este objetivo também sacrifica detalhes.
texture_sizeopcional
Tipoenum
Predefinição2048
102420484096
Resolução da textura da malha para baking. Um detalhe de superfície mais fino implica ficheiros maiores quando esta resolução é aumentada.
remeshopcional
Tipoboolean
Predefiniçãotrue
Reconstrução da topologia da malha, que geralmente beneficia a utilização posterior ao criar triângulos mais limpos, à custa de um processamento mais longo.
enable_safety_checkeropcional
Tipoboolean
Predefiniçãotrue
A filtragem pode ser flexibilizada definindo false, desde que o autor do pedido esteja autorizado.
obrigatório Nome canónico, também aceite

Os parâmetros de ficheiro aceitam um URL https:// público, um URI data: até 10 MB ou o file_url de um carregamento. Ficheiros

Resultado

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"
  }
}
Os seus ficheiros, a sua escolhaCada outputs[].url é uma cópia no nosso armazenamento: guardada para sempre (paga por GB-mês) ou durante 7 dias gratuitamente, conforme a definição da sua conta ou ?storage=.
A mesma estrutura em todos os modelostype, url, content_type, width, height e duration, tanto para imagens como para vídeo e áudio. output é o próprio objeto de resultado do modelo.
Campos do resultado
model_glb
object {url, content_type, file_name, file_size}Modelo 3D gerado no formato GLB.
seed
integerValor de seed efetivamente usado.

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