Multivisualização para modelo 3D — Série P

POST /v3/generation/multiview-to-model

Gere um modelo 3D a partir de imagens multivisualização usando os modelos da Série P. Otimizado para geração low-poly com topologia limpa.

Principais diferenças do padrão

Otimizado para saída low-poly (P1-20260311: 50–20.000 faces; P2-20260801: até 50.000)
quad é suportado apenas por P2-20260801; smart_low_poly, generate_parts e geometry_quality não são suportados

Parâmetros de solicitação

Parâmetro	Tipo	Obrigatório	Padrão	Descrição
inputs	sequência[]	Obrigatório	-	Lista de 4 imagens multivisualização [frente, esquerda, trás, direita]
original_task_id	cadeia	Opcional	-	Tarefa ID da geração multiview anterior. Mutuamente exclusivo com entradas
model	cadeia	Obrigatório	-	Versão do modelo da Série P. Deve ser definido para chamar a Série P; se omitido, a solicitação é executada no modelo padrão da Série H, `v3.1-20260211`. Valores: `P1-20260311` (otimizado para low-poly), `P2-20260801` (nova geração, suporta saída quad; Preview)
texture_alignment	cadeia	Opcional	original_image	`original_image` ou `geometry`
orientation	cadeia	Opcional	padrão	`default` ou `align_image`
model_seed	inteiro	Opcional	aleatório	Semente aleatória para geometria
face_limit	inteiro	Opcional	adaptativo	Contagem máxima de polígonos. `P1-20260311`: 50–20.000; `P2-20260801` triângulos: 48–50.000, com `quad=true`: 48–25.000
texture	booleano	Opcional	verdade	Habilitar mapas de textura
pbr	booleano	Opcional	verdade	Habilite PBR. Força textura=true
texture_seed	inteiro	Opcional	aleatório	Semente aleatória para textura
texture_quality	cadeia	Opcional	padrão	`fast` (requer `texture_version=v3.5-20260815`), `standard`, `detailed` ou `extreme`
texture_version	cadeia	Opcional	Derivado de model	Fixa o modelo de textura: `v3.5-20260815`, `v3.0-20250812` ou `v2.5-20250123`. Para geometria da série P, o padrão é `v3.0-20250812`
delight	booleano	Opcional	true	Remove a iluminação incorporada da imagem de referência antes da texturização. Considerado apenas quando `texture_version=v3.5-20260815`
auto_size	booleano	Opcional	falso	Dimensione para dimensões do mundo real
export_uv	booleano	Opcional	verdade	Controle de desembrulhamento UV
export_orientation	cadeia	Opcional	`+x`	Orientação para exportação. Valores disponíveis: `-x`, `-y`, `+y`
quad	booleano	Opcional	false	Apenas `P2-20260801`. Gera uma malha quad em vez de triângulos. Força o formato de saída para `FBX`; sem `face_limit`, o padrão é 10.000 faces.

Notas sobre export_orientation:

Aplica-se apenas a esta geração. Se o modelo for usado em tarefas de pós-processamento (textura, rig, redirecionamento, conversão, …), recomenda-se não definir este parâmetro.
Quando definido, o pós-processamento pode afetar o resultado final devido a uma orientação incorreta do modelo, embora a tarefa continue relatando status: success — nenhum erro é gerado. Use com cautela.
Se você planeja pós-processar o modelo, deixe este parâmetro sem definir e converta a orientação na última etapa via /v3/models/convert.

Exemplo

JSON

{
  "inputs": [
    "https://example.com/front.png",
    "https://example.com/back.png",
    "https://example.com/left.png",
    "https://example.com/right.png"
  ],
  "model": "P1-20260311",
  "face_limit": 5000,
  "texture": true
}

P2-20260801 com saída quad:

JSON

{
  "inputs": [
    "https://example.com/front.png",
    "https://example.com/back.png",
    "https://example.com/left.png",
    "https://example.com/right.png"
  ],
  "model": "P2-20260801",
  "quad": true,
  "face_limit": 8000,
  "texture": true
}