De tu imagen
al siguiente objeto.

Un flujo, dentro de tu producto.

Crear una clave en esta pagina y utilícelo en su servidor de aplicaciones. Definir THINGBLOOM_API_KEY con tu llave. Nunca coloque la clave en páginas públicas o aplicaciones distribuidas.

Las generaciones requieren una suscripción activa y usan el mismo saldo de créditos del estudio. El costo por modelo está en la página de planes. El costo de la impresión física es aparte.

1. Sube una imagen.

Utilice una imagen limpia del objeto, con la forma y los colores que desee conservar. La API recibe el archivo cargado y devuelve su identificador; No es necesario hacer pública la imagen. Utilice un único archivo PNG, JPG, WebP o HEIC de hasta 10 MB.

curl "https://thingbloom.com/api/v1/uploads" \
  -H "Authorization: Bearer $THINGBLOOM_API_KEY" \
  -F "file=@objeto.png"

2. Iniciar generación.

Enviar el identificador de la imagen y las características del objeto. La respuesta confirma la recepción e incluye un identificador para realizar un seguimiento del trabajo. El procesamiento continúa en segundo plano.

curl "https://thingbloom.com/api/v1/generations" \
  -H "Authorization: Bearer $THINGBLOOM_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: exemplo-vaso-00000001" \
  -d '{
    "imageId": "ID_RETORNADO_PELO_UPLOAD",
    "title": "Meu vaso",
    "colorCount": 2,
    "material": "pla",
    "maxDimensionMm": 100,
    "purpose": "decorative",
    "palette": ["#F5F5F5", "#0086D6"],
    "rightsConfirmed": true
  }'

3. Ver y descargar.

Consulta el identificador recibido hasta que finalice el procesamiento. Las direcciones de descarga están disponibles en el resultado cuando el archivo respectivo esté listo.

curl "https://thingbloom.com/api/v1/generations/ID_DA_GERACAO" \
  -H "Authorization: Bearer $THINGBLOOM_API_KEY"

Descargue los archivos usando la misma clave API. GLB te permite visualizar el modelo en 3D; STL contiene la geometría; 3MF conserva los datos listos para imprimir disponibles en ese resultado.

curl "https://thingbloom.com/api/v1/generations/ID_DA_GERACAO/files/3mf" \
  -H "Authorization: Bearer $THINGBLOOM_API_KEY" \
  --output modelo.3mf

Cambia 3mf por glb o stl para obtener otro formato. El color y la preparación no sustituyen la compatibilidad con el equipo y el material usados en la fabricación.

Reintentos seguros.

Usa una Idempotency-Key única, de 16 a 160 caracteres, para cada generación. Si la conexión se cae, repite la misma solicitud con la misma clave y los mismos parámetros. Crea otra clave solo para una nueva generación.

• El estado puede ser queued, running, succeeded o paused. En paused, retryable:true permite repetir el mismo POST con la misma clave para retomar el trabajo guardado. retryable:false indica que sigas la solicitud existente; una confirmación de cobro incierta nunca provoca otra generación automática.
• Verifique el progreso con intervalos entre solicitudes; No crees otra generación para comprobar el estado de la anterior.
• Ante una respuesta de límite temporal, respeta Retry-After antes de volver a intentarlo.
• Una clave sólo tiene acceso a las imágenes, trabajos y archivos de la cuenta a la que pertenece.
• Guarda el ID del trabajo junto al pedido de tu aplicación para retomar el seguimiento tras una interrupción.

Tus claves de API.

Crea una clave para tu servidor. Solo se muestra completa una vez; guárdala en un lugar seguro.