Conversão de formato de modelo

POST /v3/models/convert

Converta um modelo 3D para outro formato.

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âmetros Básicos

Parâmetro	Tipo	Obrigatório	Padrão	Descrição
input	cadeia	Sim	-	Fonte do modelo. Aceita um task_id começando com `task_` ou um file_token começando com `file_`
format	cadeia	Sim	-	Formato de destino. Valores disponíveis: `GLTF`, `USDZ`, `FBX`, `OBJ`, `STL`, `3MF`. 3MF: 3D com uma única cor.

Opções de malha

Parâmetro	Tipo	Obrigatório	Padrão	Descrição
quad	booleano	Não	`false`	Redesenhação quádrupla
force_symmetry	booleano	Não	`false`	Simetria de força. Válido apenas quando `quad` é `true`
face_limit	inteiro	Não	-	Polycount máximo. Se omitido, a contagem original de faces será preservada
flatten_bottom	booleano	Não	`false`	Achatar fundo
flatten_bottom_threshold	flutuar	Não	`0.01`	Limiar de profundidade de achatamento

Opções de textura

Parâmetro	Tipo	Obrigatório	Padrão	Descrição
texture_size	inteiro	Não	`4096`	Tamanho da textura difusa em pixels
texture_format	cadeia	Não	`JPEG`	Formato de textura. Valores disponíveis: `BMP`, `DPX`, `HDR`, `JPEG`, `PNG`, `TARGA`, `TIFF`, `WEBP`
bake	booleano	Não	`true`	Transforme materiais avançados em texturas básicas
pack_uv	booleano	Não	`false`	Empacote todos os UVs em um layout unificado
export_vertex_colors	booleano	Não	`false`	Inclui cores de vértices. Válido apenas para os formatos `OBJ` e `GLTF`

Opções de exportação

Parâmetro	Tipo	Obrigatório	Padrão	Descrição
pivot_to_center_bottom	booleano	Não	`false`	Mova o pivô para o centro inferior
scale_factor	flutuar	Não	`1`	Fator de escala
with_animation	booleano	Não	`true`	Incluir dados de esqueleto e animação
animate_in_place	booleano	Não	`false`	Animação no local
part_names	sequência[]	Não	-	Nomes de peças a serem exportadas, a partir de dados mesh/segment
export_orientation	cadeia	Não	`+x`	Orientação para exportação. Valores disponíveis: `-x`, `-y`, `+y`
fbx_preset	cadeia	Não	`blender`	Predefinição FBX para compatibilidade. Valores disponíveis: `blender`, `3dsmax`, `mixamo`, `bake_scale`

Exemplos de solicitação

curl -X POST https://openapi.tripo3d.ai/v3/models/convert \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {api_key}" \
  -d '{
    "input": "task_abc123",
    "format": "FBX",
    "quad": true,
    "face_limit": 8000,
    "texture_size": 2048,
    "texture_format": "PNG",
    "pivot_to_center_bottom": true,
    "fbx_preset": "blender"
  }'

import requests

url = "https://openapi.tripo3d.ai/v3/models/convert"
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer {api_key}"
}
payload = {
    "input": "task_abc123",
    "format": "FBX",
    "quad": True,
    "face_limit": 8000,
    "texture_size": 2048,
    "texture_format": "PNG",
    "pivot_to_center_bottom": True,
    "fbx_preset": "blender"
}

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

const url = "https://openapi.tripo3d.ai/v3/models/convert";

const response = await fetch(url, {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer {api_key}"
  },
  body: JSON.stringify({
    input: "task_abc123",
    format: "FBX",
    quad: true,
    face_limit: 8000,
    texture_size: 2048,
    texture_format: "PNG",
    pivot_to_center_bottom: true,
    fbx_preset: "blender"
  })
});

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 de tarefa exclusivo usado para consultar o progresso e os resultados da geração

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	2002	Parâmetros de solicitação não suportados	Verifique os nomes dos parâmetros do corpo da solicitação e os intervalos de valores
400	2006	Tipo de tarefa de origem de entrada inválido	Confirme se o tipo de tarefa para `task_id` está correto
400	2007	A tarefa de origem não foi concluída com sucesso	Aguarde a conclusão da tarefa de origem antes de iniciar a conversão
403	2010	Créditos insuficientes	Recarregue créditos e tente novamente