Ir al contenido principal

tripo/tools/convert

Tripo Convert transforma un modelo 3D en GLB, FBX o STL y permite reducir caras, usar cuadriláteros, cambiar el tamaño de las texturas o restablecer el pivote, conservando esqueleto y animación.

Desde $0.072/solicitud

Playground

Enviar una solicitud

Inicio rápido

Los ejemplos usan las definiciones públicas de parámetros del endpoint seleccionado. Sustituye la clave de API y los medios de ejemplo, y envía la solicitud desde tu servidor.

SDK e integraciones
POSThttps://api.spicyapi.ai/api/v1/jobs/createTask

Autenticación de API

Guarda la clave de API en la variable de entorno del servidor SPICY_API_KEY. Usa autenticación Bearer y Content-Type: application/json en las solicitudes JSON.

Authorization: Bearer $SPICY_API_KEY
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $SPICY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
  -d '{
  "model": "tripo/tools/convert",
  "input": {
    "fbx_preset": "blender",
    "flatten_bottom": false,
    "forward_axis": "+x",
    "mesh_url": "https://example.com/reference.png",
    "output_format": "glb",
    "pivot_to_bottom": false,
    "quad_mesh": false
  }
}'

# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $SPICY_API_KEY"

Generado a partir del esquema de entrada de este modelo: el mismo con el que la API valida cada solicitud.

Parámetros de entrada

Incluye estos campos en el objeto input del cuerpo de la solicitud. Los nombres y tipos coinciden con la API. No supongas un valor predeterminado si no está indicado.

output_formatstringObligatorio

Obligatorio. glb para navegadores y juegos web, fbx para programas de animación y motores, stl para impresión 3D (solo geometría). No cambia el precio.

Valor predeterminado
Sin especificar
Valores permitidos
"glb""fbx""stl"
mesh_urlstringObligatorio

Modelo que quieres convertir: GLB, FBX binario, OBJ o STL, de hasta 90 MB. Admite archivos con esqueleto y animación.

Valor predeterminado
Sin especificar
Restricciones
minLength:1
contentMediaType:["model/gltf-binary","model/x-fbx","model/obj","model/stl"]
in_placebooleanOpcional

Desactivado por defecto. Al activarlo, elimina el desplazamiento hacia adelante de los clips de animación durante la exportación. No cambia el precio.

Valor predeterminado
false
keep_animationbooleanOpcional

Activado por defecto: escribe el esqueleto y los clips de animación en el nuevo archivo. Desactívalo para obtener una malla estática. No cambia el precio.

Valor predeterminado
true
bake_texturesbooleanOpcional

Activado por defecto: integra los materiales avanzados en las texturas base. No cambia el precio.

Valor predeterminado
true
fbx_presetstringOpcional

Ajuste de compatibilidad para exportar FBX: blender (predeterminado), 3dsmax, mixamo o bake_scale. No cambia el precio.

Valor predeterminado
"blender"
Valores permitidos
"blender""3dsmax""mixamo""bake_scale"
forward_axisstringOpcional

Eje hacia el que mira el modelo en el archivo exportado: +x (predeterminado), -x, +y o -y. No cambia el precio.

Valor predeterminado
"+x"
Valores permitidos
"+x""-x""+y""-y"
flatten_bottombooleanOpcionalAfecta al precio

Desactivado por defecto. Al activarlo, aplana la parte inferior, lo que resulta útil antes de imprimir en 3D. Aplica la tarifa superior.

Valor predeterminado
false
scale_factornumberOpcionalAfecta al precio

Escala uniforme de exportación, 1 por defecto. Cualquier otro valor aplica la tarifa superior.

Valor predeterminado
1
Restricciones
minimum:0.001
maximum:1000
pivot_to_bottombooleanOpcionalAfecta al precio

Desactivado por defecto. Al activarlo, mueve el pivote al centro de la base para que el modelo se apoye en el suelo al colocarlo. Aplica la tarifa superior.

Valor predeterminado
false
texture_formatstringOpcionalAfecta al precio

jpeg (predeterminado), png o webp para las texturas exportadas. png y webp aplican la tarifa superior.

Valor predeterminado
"jpeg"
Valores permitidos
"jpeg""png""webp"
texture_sizeintegerOpcionalAfecta al precio

Tamaño de la textura difusa en píxeles, de 128 a 8192; 4096 por defecto. Cualquier otro valor aplica la tarifa superior.

Valor predeterminado
4096
Restricciones
minimum:128
maximum:8192
face_limitintegerOpcionalAfecta al precio

Máximo opcional de caras, de 48 a 2,000,000. Déjalo vacío para conservar la cantidad original. Al configurarlo, se aplica la tarifa superior.

Valor predeterminado
Sin especificar
Restricciones
minimum:48
maximum:2000000
quad_meshbooleanOpcionalAfecta al precio

Desactivado por defecto. Al activarlo, reconstruye la malla con polígonos de cuatro lados, unas 10,000 caras salvo que definas face_limit; requiere output_format fbx. Aplica la tarifa superior.

Valor predeterminado
false

Seguir la tarea

HTTP 202 significa que la tarea se aceptó, no que haya terminado. Guarda el taskId devuelto y consulta esa tarea. No crees otra mientras esperas el resultado.

Solicitud aceptada
HTTP/1.1 202 Accepted
Location: /api/v1/jobs/recordInfo?taskId=job_01k3m8x9q2z4v7n5p6r8s0t1w3

{
  "code": 200,
  "msg": "success",
  "request_id": "req_example_create",
  "data": {
    "taskId": "job_01k3m8x9q2z4v7n5p6r8s0t1w3",
    "state": "queued",
    "estimatedCost": "0.750000"
  }
}

La respuesta de aceptación incluye la estimación para que tu aplicación pueda mostrar el mismo importe en el historial de tareas y en la facturación.

Consultar la tarea
curl --get "https://api.spicyapi.ai/api/v1/jobs/recordInfo" \
  --data-urlencode "taskId=$TASK_ID" \
  -H "Authorization: Bearer $SPICY_API_KEY"

Empieza consultando cada 2 segundos aproximadamente y ve espaciando los intentos. Párate en un estado final. Si se cae la conexión, consulta el taskId original. Vuelve a crear la tarea solo con la clave de idempotencia y el cuerpo originales.

O recibe el resultado por callback
import { verifyWebhook } from "@spicyapi/sdk";

// express.raw keeps the bytes we signed; express.json never matches.
app.post("/hooks/spicy", express.raw({ type: "application/json" }), (req, res) => {
  const { payload } = verifyWebhook({
    rawBody: req.body,
    timestamp: req.header("X-Webhook-Timestamp"),
    signature: req.header("X-Webhook-Signature"),
    payloadVersion: Number(req.header("X-Webhook-Payload-Version")),
    secret: process.env.SPICY_WEBHOOK_SECRET,
  });
  res.status(200).end();
  void handleFinishedTask(payload);
});

Pasa callBackUrl al crear la tarea y recibirás el registro terminado por POST, sin un bucle de consultas de estado. Cada entrega lleva X-Webhook-Timestamp, X-Webhook-Signature y X-Webhook-Payload-Version. La firma es un HMAC-SHA256 en base64 sobre taskId.timestamp.sha256(body), así que debes verificarla con los bytes originales: si analizas el JSON y vuelves a serializarlo, los bytes cambian y la verificación falla. Las entregas fallidas se reintentan, de modo que el mismo taskId puede llegar dos veces; haz que tu manejador sea idempotente. Responde 2xx primero y haz el trabajo después: un manejador lento se trata como una entrega fallida.

Leer el resultado

Procesa output solo cuando state sea succeeded. Si falla, consulta errorCode, errorMessage y request_id. Los costos y estados de ejemplo no representan una factura real.

Ejemplo de respuesta completada
{
  "code": 200,
  "msg": "success",
  "request_id": "req_example_record",
  "data": {
    "taskId": "job_01k3m8x9q2z4v7n5p6r8s0t1w3",
    "model": "tripo/tools/convert",
    "state": "succeeded",
    "output": {
      "assets": [
        {
          "key": "tasks/2026/08/28/job_01k3m8x9q2z4v7n5p6r8s0t1w3/3f7a1c9e5b2d48f0a6c1e3d5b7f9a1c3.png",
          "mime": "image/png",
          "url": "https://example.r2.cloudflarestorage.com/results/job_01k3m8x9q2z4v7n5p6r8s0t1w3/result.png?X-Amz-Signature=SIGNATURE_FROM_RESPONSE",
          "expiresAt": "2026-08-28T12:20:08.000Z"
        }
      ]
    },
    "cost": "0.750000",
    "settled": true,
    "createdAt": "2026-08-28T12:00:00Z",
    "completedAt": "2026-08-28T12:00:30Z"
  }
}

Para cada archivo disponible, abre o descarga assets[].url directamente, sin la cabecera Authorization de la API. El enlace firmado expira en expiresAt: vuelve a consultar la tarea para renovarlo mientras el archivo siga dentro del periodo de conservación. Un archivo pendiente o no disponible no trae URL. Trata los enlaces firmados como datos privados.

SDK e integraciones

Usa SpicyAPI en tu app, terminal, asistente de IA o flujo visual. Elige una guía de configuración.

Úsalo en ComfyUI

Instala los nodos de SpicyAPI desde ComfyUI Manager o con el comando de abajo y busca Tripo 3D Tools · Convert en el lienzo. El nodo tiene las mismas opciones que esta página y muestra su precio antes de ejecutarse.

cd ComfyUI/custom_nodes
git clone https://github.com/spicyapi-ai/comfyui-spicyapi