UV inteligente

POST /v3/mesh/uv

Refaz o desdobramento UV de um modelo 3D e remapeia texturas, rigging e animações existentes para o novo layout.

Cada tarefa custa 20 créditos. O resultado inclui model_url e uma prévia do layout UV uv_render_url. O modelo de entrada não pode exceder 80.000 triângulos equivalentes (um quad conta como dois); modelos maiores são aceitos na criação, mas a tarefa falha e os créditos são reembolsados.

Parâmetros de solicitação

Solicitar cabeçalhos

Parâmetro	Tipo	Obrigatório	Padrão	Descrição
Content-Type	cadeia	Sim	-	`application/json`
Authorization	cadeia	Sim	-	`Bearer {api_key}`

Corpo da Solicitação

Parâmetro	Tipo	Obrigatório	Padrão	Descrição
input	cadeia	Sim	—	Origem do modelo. Aceita um task_id, um file_token ou uma URL
model	cadeia	Não	`default`	Versão do modelo de UV inteligente. Apenas `default` é suportado
bake	booleano	Não	`true`	Fazer bake das texturas existentes no novo layout UV. Com `false`, retorna apenas a geometria com UVs
export_orientation	cadeia	Não	—	Orientação do modelo exportado: `+x`, `-x`, `+y` ou `-y`
compress	cadeia	Não	—	Tipo de compressão. `geometry`: compressão meshopt

Exemplos de solicitação

curl -X POST https://openapi.tripo3d.ai/v3/mesh/uv \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {api_key}" \
  -d '{
    "input": "task_abc123",
    "bake": true
  }'

import requests

url = "https://openapi.tripo3d.ai/v3/mesh/uv"
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer {api_key}"
}
payload = {
    "input": "task_abc123",
    "bake": True
}

response = requests.post(url, headers=headers, json=payload)
print(response.json())

const url = "https://openapi.tripo3d.ai/v3/mesh/uv";

const response = await fetch(url, {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer {api_key}"
  },
  body: JSON.stringify({
    input: "task_abc123",
    bake: true
  })
});

const data = await response.json();
console.log(data);

Resposta

Resposta bem sucedida

JSON

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

Campos de resposta

Parâmetro	Tipo	Descrição
code	inteiro	Código de status. `0` indica sucesso
data.task_id	cadeia	Identificador único da tarefa para consultar o progresso e o resultado

Códigos de erro

Código de status HTTP	Código de erro	Descrição	Recomendação
429	2000	Limite de geração excedido	Reduza a taxa de solicitação e tente novamente mais tarde
400	1004	Parâmetro ou entrada inválidos	Verifique nomes, valores e a origem da entrada
403	2010	Créditos insuficientes	Recarregue os créditos e tente novamente