Uma linha por produto, uma coluna com a URL de uma imagem. O GridShot processa o arquivo como um trabalho em lote, cria os produtos e os entrega à mesma esteira de geração que as integrações de loja usam.
CSV, XLSX, XLS e XLSM são aceitos, até 20 MB e 10.000 linhas por arquivo. Os separadores são detectados automaticamente, então uma exportação com ponto e vírgula funciona como está.
O GridShot detecta a coluna com a URL da imagem e as colunas de produto mais comuns pelos cabeçalhos. Antes de rodar você vê o mapeamento detectado e uma prévia das linhas, e pode apontar para outra coluna se o palpite estiver errado.
O arquivo vira um trabalho processado por um pool de workers, com progresso ao vivo. As linhas são lidas, as imagens baixadas e os produtos criados enquanto o contador avança — e uma linha ruim falha sozinha, em vez de derrubar a execução inteira.
Daqui em diante é o fluxo normal de estúdio: cada execução produz uma grade de 16 a 25 variações em cerca de 5 a 15 minutos, e você entrega como imagem final apenas as fotos que quiser.
Exatamente uma coluna é obrigatória: uma URL apontando para uma imagem de produto. Todo o resto é opcional e só melhora o resultado. Os cabeçalhos são reconhecidos sem diferenciar maiúsculas, com vários nomes comuns aceitos por campo:
| Campo | Cabeçalhos reconhecidos | Para que serve |
|---|---|---|
| URL da imagem (obrigatória) | url, image_url, image, product_url, image_link, photo_url … | A foto de produto com que o GridShot trabalha. Linhas sem uma URL http(s) utilizável são puladas e reportadas. |
| Nome do produto | name, product_name, title, product_title | Vira o nome do produto. Sem ele, fica mais difícil distinguir os produtos na biblioteca. |
| Marca | brand, brand_name, manufacturer, vendor | Fica gravada no produto — útil quando várias etiquetas passam por um mesmo espaço. |
| SKU | sku, product_sku, product_id, id | Permanece ligado ao produto, para que as imagens finais sejam rastreáveis até o seu catálogo. |
| Preço | price, product_price, cost | Guardado como preço de origem junto com a moeda, apenas para referência. |
| Descrição | description, product_description, desc | Mantida como contexto do produto e editável. |
| Todo o resto | qualquer outra coluna | Preservado com a importação, para que a linha original continue rastreável mesmo onde um valor não corresponde a nenhum campo de produto. |
Este é o ponto que vale entender antes de montar o arquivo. Cada linha cria um produto a partir de uma imagem. Se você listar frente, costas e detalhe da mesma peça como três linhas, obtém três produtos separados — não um produto com três vistas.
Para várias vistas de um mesmo item, use o caminho da URL do produto: o GridShot lê a página, resolve a galeria e cria um produto cujas fotos viram perspectivas. São exatamente essas perspectivas que a geração usa como referência de caimento, então o passo extra compensa nos seus produtos principais. Para amplitude — uma boa imagem de cada item em um catálogo grande — o CSV é a ferramenta certa.
Nome, marca, descrição, SKU, preço e moeda são gravados no produto, junto com a loja de origem, o link do produto e o identificador original, de modo que cada imagem gerada continua rastreável até a linha de onde veio.
Categoria e cor funcionam de outro jeito. Essas colunas são lidas e preservadas com a importação, mas os valores que acabam no produto vêm da própria análise de imagem do GridShot, que olha a foto real em vez de confiar na planilha. Na prática é a fonte mais confiável: árvores de categoria exportadas raramente correspondem ao tratamento que uma peça precisa na geração.
O GridShot reproduz comprimento e caimento a partir de valores curados — a verdade da marca, que prevalece sobre o que a IA deduz da foto e entra na geração como instrução inegociável. Uma coluna «Comprimento» ou «Modelagem» na sua exportação é justamente o tipo de dado de onde esses valores deveriam vir, porque você os mantém para a sua clientela em vez de adivinhar.
Hoje essas colunas não são mapeadas: comprimento e caimento curados são definidos produto a produto dentro do GridShot. Em uma importação grande isso significa uma passada pelos seus produtos principais, e não por todos — o restante fica com os valores deduzidos pela IA, com influência mais suave sobre o prompt.
Importações em massa falham de formas bem entediantes. Esta se comporta assim:
A importação em si é gratuita. Você paga pelas imagens que publica:
Um exemplo calculado: um lançamento de estação com 200 produtos e três imagens publicadas cada um dá 600 imagens publicadas — cerca de US$ 600, mais o processamento das execuções por trás. Importar as 200 linhas não custa nada, e o crédito inicial de US$ 10 cobre suas dez primeiras imagens, então dá para validar o resultado em peças reais antes de assumir o lote inteiro.
Ver todos os preçosOs três caminhos alimentam a mesma esteira de geração. Diferem apenas em como os produtos entram.
Conecte a loja somente para leitura via OAuth para percorrer seu catálogo e depois traga os produtos pela URL do produto ou por este caminho em lote.
Integração com ShopifyA conexão com o WooCommerce usa chaves de API REST somente leitura e funciona igual a partir da seleção de produtos.
Integração com WooCommerceUma: uma coluna com a URL de uma imagem. Nome do produto, marca, SKU, preço e descrição são opcionais e são captados automaticamente quando seus cabeçalhos usam um nome comum. Todo o resto do arquivo é preservado com a importação.
XLSX, XLS e XLSM funcionam tão bem quanto CSV, até 20 MB e 10.000 linhas. Os separadores são detectados automaticamente, então exportações com ponto e vírgula não precisam de limpeza, e campos entre aspas com vírgulas dentro são lidos corretamente.
Por CSV, não — cada linha vira um produto próprio com uma imagem. Para frente, costas e detalhe da mesma peça, importe esse produto pela URL do produto: o GridShot transforma a galeria em perspectivas de um único produto, e são essas perspectivas que a geração usa como referência de caimento.
Linhas sem URL utilizável são puladas e reportadas. Downloads que falham temporariamente são repetidos com espera crescente; uma linha que ainda assim falha é marcada como falha e o lote continua. Só uma execução que falha de forma persistente se interrompe sozinha — então você descobre cedo, e não na linha nove mil.
Sim, e essa é a ordem sensata. Importe vinte linhas, gere para duas ou três e julgue o resultado nas suas próprias peças. O crédito inicial de US$ 10 cobre isso, e o mapeamento validado em vinte linhas é o mesmo que vai rodar em dez mil.
Não. O caminho em lote é a entrada mais rápida para quem tem mais produtos do que paciência, seja qual for o tamanho do catálogo: uma planilha de quarenta itens vale tanto quanto uma de quatro mil. Operações maiores costumam somar a API por cima, em vez de substituir este caminho.