Da sua imagem
ao próximo objeto.

Um fluxo, dentro do seu produto.

Crie uma chave nesta página e use-a no servidor da sua aplicação. Defina THINGBLOOM_API_KEY com sua chave. Nunca coloque a chave em páginas públicas ou aplicativos distribuídos.

Gerações exigem uma assinatura ativa e usam o mesmo saldo de créditos do estúdio. O custo por modelo está na página de planos. O custo da impressão física é separado.

1. Envie uma imagem.

Use uma imagem limpa do objeto, com o formato e as cores que deseja preservar. A API recebe o arquivo por upload e retorna seu identificador; não é necessário tornar a imagem pública. Use um único arquivo PNG, JPG, WebP ou HEIC de até 10 MB.

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

2. Inicie a geração.

Envie o identificador da imagem e as características do objeto. A resposta confirma o recebimento e inclui um identificador para acompanhar o trabalho. O processamento continua em 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. Consulte e baixe.

Consulte o identificador recebido até o processamento terminar. Os endereços de download ficam disponíveis no resultado quando o respectivo arquivo estiver pronto.

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

Baixe os arquivos usando a mesma chave de API. GLB permite visualizar o modelo em 3D; STL contém a geometria; 3MF preserva os dados preparados para a impressão disponíveis naquele resultado.

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

Troque 3mf por glb ou stl para obter outro formato. Cor e preparação não dispensam a compatibilidade com o equipamento e o material usados na fabricação.

Repetições seguras.

Use uma Idempotency-Key única, com 16 a 160 caracteres, para cada geração. Se a conexão cair, repita a mesma solicitação com a mesma chave e os mesmos parâmetros. Crie outra chave apenas para uma nova geração.

• O estado pode ser queued, running, succeeded ou paused. Em paused, retryable:true permite repetir o mesmo POST com a mesma chave para retomar o trabalho salvo. retryable:false pede que você acompanhe a solicitação existente; uma confirmação de cobrança incerta nunca provoca outra geração automática.
• Consulte o andamento com intervalos entre as requisições; não crie outra geração para verificar o estado da anterior.
• Em uma resposta de limite temporário, respeite Retry-After antes de tentar novamente.
• Uma chave só tem acesso às imagens, trabalhos e arquivos da conta à qual pertence.
• Guarde o ID do trabalho junto ao pedido da sua aplicação para retomar o acompanhamento depois de uma interrupção.

Suas chaves de API.

Crie uma chave para seu servidor. A chave completa aparece uma única vez e deve ser guardada em um local seguro.