Fotos de Produto

• Nano Banana 2

Artigos sobre este pipeline

• Melhor gerador de imagem IA: comparação prática de modelos

API do Fotos de Produto

Chame este pipeline a partir do seu próprio código. Um pedido lança uma execução; o modelo é um campo de entrada, não um endpoint separado.

import { createClient } from "@pipe2-ai/sdk";

const client = createClient(process.env.PIPE2_TOKEN!);

const { run_pipeline } = await client.RunPipeline({
  pipeline_slug: "product-shots",
  input: {
    product_image: "https://example.com/product.png",
    environments: ["white_background","lifestyle","detail_closeup"],
  },
});

import asyncio
import os

from pipe2 import Pipe2Client

client = Pipe2Client(token=os.environ["PIPE2_TOKEN"])

run = asyncio.run(client.run_pipeline(
    pipeline_slug="product-shots",
    input={
        "product_image": "https://example.com/product.png",
        "environments": ["white_background","lifestyle","detail_closeup"],
    },
))

client := pipe2.NewClient(os.Getenv("PIPE2_TOKEN"))

input := json.RawMessage(`{
  "product_image": "https://example.com/product.png",
  "environments": ["white_background","lifestyle","detail_closeup"]
}`)

run, err := pipe2.RunPipeline(context.Background(), client, "product-shots", input)
if err != nil {
    log.Fatal(err)
}

pipe2 pipelines run \
  --pipeline product-shots \
  --input-json '{"product_image": "https://example.com/product.png", "environments": ["white_background","lifestyle","detail_closeup"]}' \
  --wait

Obter um token de API →

Parâmetros

environments obrigatório

Lista de 1-7 ambientes a gerar. white_background é a imagem principal em conformidade com a Amazon (branco puro, produto preenchendo 85%). lifestyle é uma cena aspiracional do mundo real. in_use mostra mãos segurando ou usando o produto (comprovadamente aumenta a taxa de cliques via neurônios-espelho). detail_closeup é uma tomada macro de textura (justifica preço premium). scale_reference mostra o produto ao lado de uma mão ou objeto comum (reduz devoluções por incompatibilidade de tamanho). gradient_studio é um fundo premium para criativos de anúncio. outdoor é um ambiente natural para criativos de anúncio. A fórmula das 7 imagens da Amazon é: white_background + lifestyle + scale_reference + detail_closeup + in_use + um segundo lifestyle. Você paga por ambiente selecionado.

array predefinição white_background,lifestyle,detail_closeup

product_image obrigatório

URL da foto original do produto. Uma tomada basta, a IA preserva o formato, a cor e a marca do produto e altera apenas o fundo.

string

aspect_ratio

Output aspect ratio for the generated shots.

1:14:53:42:34:39:1616:9 predefinição 1:1

Use a partir de um agente de IA

Aponte qualquer cliente MCP para o pipe2 e o seu agente ganha estas ferramentas. Ele encontra este pipeline, lê o mesmo esquema acima e executa-o.

• list_pipelines
• get_pipeline_schema
• run_pipeline
• get_pipeline_run_status
• request_upload

{
  "mcpServers": {
    "pipe2ai": {
      "url": "https://mcp.pipe2.ai/mcp",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    }
  }
}

Referência completa da API→ Configuração de MCP→ Referência da CLI→

Perguntas frequentes