VKDesenvolvedores

Objetos reais, no seu produto.

Um visualizador para qualquer página e uma API REST para criar objetos a partir do seu sistema.

Para marketplaces e portais.

Deixe seus usuários criarem o 360°.

Um portal de veículos, um marketplace ou uma rede de lojas liga a API uma vez. A partir daí, cada vendedor filma o produto em casa, envia pelo seu próprio app ou site, e o anúncio mostra o item em 360° com as fotos reais, em uns oito minutos.

Sua marca na tela de envio; o processamento é nosso
Franquia e chaves por conta
Rostos e placas desfocados automaticamente

Por que vale a pena.

94%

mais conversões, em média, nas lojas que usam 3D em vez de só fotos.

Shopify, 2020

44%

mais produtos no carrinho depois que o cliente interagiu com eles em 3D.

Rebecca Minkoff · Shopify

11×

mais chance de compra entre quem usou a visualização 3D no app da Houzz.

Houzz · Retail Dive, 2018

11%

das devoluções vêm de produtos diferentes das imagens que o cliente viu.

Coresight Research, 2024

Cole duas linhas. Ele gira.

O visualizador

Um arquivo JavaScript, sem dependências, WebGL2. Arrastar gira, dois dedos aproximam, setas do teclado giram. Ele dispara veyskar-pronto quando a primeira foto aparece.

Mantenha sempre a versão no endereço do script (?v=N). O navegador guarda o arquivo em cache.

Os objetos só abrem nos sites que você liberar na área do cliente (qualquer site, por padrão). No plano Teste, incorpore a página do link num iframe: ela mostra o selo Powered by VEYSKAR.

<script src="https://objetos.veyskar.com/js/veyskar-viewer.js?v=5"></script>
<veyskar-object
  src="https://objetos.veyskar.com/poltrona-cognac/"
  background="miv" ring></veyskar-object>

IncorporarCreator+

Atributo	O que faz
`src`	Endereço da pasta do objeto. O único obrigatório.
`background`	`miv` (estúdio escuro) ou `transparent`.
`ring`	Mostra o anel dos ângulos capturados.
`autoplay`	Gira devagar sozinho até o primeiro toque.
`zoom`	Libera aproximar com pinça e roda do mouse.
`az / el`	Vista inicial, em graus.

Crie objetos a partir do seu sistema

API REST

Disponível do Business para cima. Endereço base https://api.veyskar.com.

Autentique com Authorization: Bearer vk_live_…. As chaves são criadas na área do cliente, em Chaves de API, e aparecem uma vez só. Use em servidores, nunca no navegador.

Limite: 240 requisições por minuto por chave.

GET/v1/objetosLista os objetos da conta e a franquia: franquia {total, usadas, restantes}.

POST/v1/objetosCria um objeto. Corpo {"titulo", "altura_m"}. Devolve {objeto, envio_url}.

PUT<envio_url>Envia os bytes do vídeo direto para o armazenamento. Vale por 1 hora. Não passa pelos nossos servidores.

POST/v1/objetos/{id}/processarComeça o processamento depois do envio. Leva de 7 a 8 minutos.

GET/v1/objetos/{id}Estado atual, avisos, erro e arquivos.

DELETE/v1/objetos/{id}Tira o objeto do ar e apaga os arquivos públicos.

Fluxo completo

Webhooks por chave chegam em breve. Por enquanto, consulte o objeto enquanto ele processa.

# 1. criar
curl -X POST https://api.veyskar.com/v1/objetos \
  -H "Authorization: Bearer $VEYSKAR_KEY" -H "Content-Type: application/json" \
  -d '{"titulo":"Poltrona Cognac","altura_m":0.82}'
# -> {"objeto":{"id":42,"estado":"aguardando_video",...},"envio_url":"https://..."}

# 2. enviar o vídeo direto para o envio_url
curl -X PUT "$ENVIO_URL" -H "Content-Type: video/mp4" --data-binary @poltrona.mp4

# 3. processar e consultar a cada 20 a 30 s
curl -X POST https://api.veyskar.com/v1/objetos/42/processar -H "Authorization: Bearer $VEYSKAR_KEY"
curl https://api.veyskar.com/v1/objetos/42 -H "Authorization: Bearer $VEYSKAR_KEY"

Referência

Formato do objeto

Cada objeto é uma pasta pública: manifest.json, as fotos reais, splat.spz (0,5 a 1,4 MB), capa.jpg e export/giro.mp4 e .gif. Um objeto típico pesa de 12 a 20 MB, e o visitante baixa só o que vê.

Erros chegam como {"erro": "mensagem"}.

`estado`	`aguardando_video`, `processando`, `pronto` ou `falhou`
`etapa`	Etapa atual do processamento
`avisos[]`	`captura_com_buracos`, `uma_altura_so`, `altura_estimada`
`erro`	`{etapa, mensagem, regravar_segundos}` quando falhou
`src`	Pasta do objeto, para o visualizador
`capa, mp4, gif`	Imagem de prévia 1200×630 e o objeto girando
`link`	Página para compartilhar, quando pronto

Erros

`400`	Dados inválidos
`401`	Chave ausente ou inválida
`402`	Franquia esgotada ou pagamento pendente
`403`	Plano sem API
`404`	Não encontrado
`429`	Requisições demais