Texto para modelo 3D - Série P

POST /v3/generation/text-to-model

Gere um modelo 3D a partir de um prompt de texto usando os modelos da Série P. A Série P é otimizada para a melhor geração de low-poly com topologia limpa e refinada – ideal para ativos de jogos, conteúdo estilizado e fluxos de trabalho 3D leves.

Principais diferenças do padrão

Otimizado para contagens baixas de rostos (48–20.000)
Geração de malha de ~2s com topologia estruturada
não suporta: quad, smart_low_poly, generate_parts, geometry_quality

Parâmetros de solicitação

Parâmetro	Tipo	Obrigatório	Padrão	Descrição
prompt	cadeia	Obrigatório	-	Prompt de texto, até 1024 caracteres
negative_prompt	cadeia	Opcional	-	Prompt negativo, até 255 caracteres
image_seed	inteiro	Opcional	aleatório	Semente aleatória para o estágio de texto para imagem
model	cadeia	Opcional	tripo-p1	Versão do modelo Série P. Valores: `tripo-p1`
model_seed	inteiro	Opcional	aleatório	Semente aleatória para geração de geometria
face_limit	inteiro	Opcional	adaptativo	Contagem máxima de polígonos. Faixa: 48–20.000
texture	booleano	Opcional	verdade	Habilitar mapas de textura
pbr	booleano	Opcional	verdade	Habilite mapas de materiais PBR. Força textura=true
texture_seed	inteiro	Opcional	aleatório	Semente aleatória para geração de textura
texture_quality	cadeia	Opcional	padrão	`standard`, `detailed` ou `extreme`
auto_size	booleano	Opcional	falso	Dimensione para dimensões do mundo real (metros)
compress	cadeia	Opcional	-	Tipo de compactação: `geometry` (meshopt)
export_uv	booleano	Opcional	verdade	UV desembrulhando. false = arquivo menor e mais rápido

Exemplo

JSON

{
  "prompt": "a low poly medieval sword",
  "model": "tripo-p1",
  "face_limit": 3000,
  "texture": true,
  "texture_quality": "detailed"}

Resposta

JSON

{
  "code": 0,
  "data": {
    "task_id": "task_abc123"}
}