O Claude Code pode fazer toda a campanha de uma vez?

Ele pode encadear as chamadas, mas aprove o hero primeiro: cada criativo é feito a partir dele, então um hero errado significa seis imagens erradas.

Quanto custa a sessão?

Apenas as gerações. Criar o projeto, abrir e arquivar ativos é gratuito; cada imagem é cobrada na taxa publicada do seu modelo. O resultado de uma chamada de imagem não inclui seu preço, então leia o extrato.

Uma chamada expirou. Fui cobrado duas vezes?

Não. A mesma solicitação dentro de cinco minutos recebe um erro 409 que identifica o trabalho existente, e apenas o primeiro é cobrado. Encontre a imagem com as ferramentas de trabalhos ou ativos.

Ele pode colocar meu título na peça criativa?

Não com as ferramentas de imagem brutas. O pacote de pôsteres e redes sociais e os presets de anúncios estáticos definem suas palavras como texto real; execute-os com nolgia_run_preset ou pela página Campanhas.

Isso funciona no ChatGPT?

Ainda não. O ChatGPT está marcado como Em breve na página MCP. O Claude Code e o Cursor funcionam hoje.

Guias / MCP

Execute uma campanha publicitária de ponta a ponta do Claude Code com MCP

Você não abre um compositor. Você diz ao Claude Code o que a campanha precisa, ele chama as ferramentas da NOLGIA e os criativos chegam a um projeto que você pode abrir no site.

8 min de leitura
Atualizado 14 de outubro de 2026

Traduzido automaticamente do inglês. Ler o original

O herói

Criativos

Projeto

O que você cria, em ordem. Toque em um para ir até a etapa.

Você executa uma pequena campanha publicitária pelo Claude Code, conectando-o ao servidor MCP da NOLGIA e solicitando a campanha em linguagem natural. O Claude Code cria um projeto, abre a imagem principal que você aprovou, gera cada criativo a partir dessa imagem principal usando a ferramenta de imagem para imagem, renderiza todos os criativos nos tamanhos que você especificar e arquiva os resultados no projeto. Você revisa as imagens na página do projeto ou na sua Biblioteca, e nada no fluxo precisa de um compositor aberto.

Tudo abaixo é uma sessão real sobre um produto fictício: fones de ouvido pretos foscos com um anel de luz laranja. As chamadas de ferramentas são impressas como o Claude Code as fez, as imagens são o que foi retornado e os preços vêm do catálogo ao vivo quando esta página carrega. A configuração da conexão é coberta em Gerar do Claude Code ou Cursor com MCP; este guia começa depois disso.

O que dá errado e a correção

Erro	Por que prejudica	Corrigir
Pedir todas as seis imagens em uma única linha	O agente gera antes de o produto ser aprovado, e você paga por seis erradas	Aprove a imagem principal primeiro, depois distribua
Descrever o produto novamente para cada criativo	Cada descrição se desvia e o produto muda de forma	Crie os criativos a partir do hero aprovado usando imagem para imagem, para que a referência seja mantida
Pular o projeto	Seis ativos ficam soltos na Biblioteca sem nada que os vincule	Crie o projeto primeiro e passe seu id em cada geração
Ler o saldo da carteira como recibo	Em uma conta usada por outras pessoas, o saldo muda por motivos fora da sessão, então um preço inferido a partir dele pode ser várias vezes maior	Dê ao agente o limite máximo e a taxa por imagem de antemão, e leia o extrato, não o saldo
Tentar novamente uma chamada que expirou	A primeira chamada geralmente terminou no servidor; uma nova tentativa cega gera uma segunda imagem	Uma nova tentativa da mesma solicitação recebe um 409 em até cinco minutos e não é cobrada duas vezes; encontre o resultado com a ferramenta de ativos

Antes de começar

Claude Code conectado ao NOLGIA com um Personal Access Token, conforme o guia do MCP.
Créditos no seu saldo de recarga: um token gasta apenas créditos de recarga.
Uma imagem hero aprovada do produto na sua Biblioteca. A nossa é um produto fictício, criado com GPT Image 2.5 Flare.
Um breve com o modelo, os tamanhos e o limite. O nosso: três criativos, 1:1 e 9:16, no máximo oitenta créditos, com a taxa por imagem informada.

Fone de ouvido over-ear preto fosco com um anel laranja brilhante fino em cada concha, apoiado sobre uma mesa de carvalho desgastada sob a luz da janela no fim da tarde. — **O herói aprovado.** Criado com GPT Image 2.5 Flare antes da sessão. Todos os criativos abaixo foram feitos a partir dele.

Brief para o Claude Code

Uma mensagem carrega todo o trabalho: o produto, o id do asset do herói, o modelo, os três criativos, os dois tamanhos, a regra de arquivamento, o limite com a taxa por imagem e quantas chamadas podem rodar ao mesmo tempo. Também dissemos quais ferramentas usar e para não mexer na lista de modelos, porque estávamos nomeando o modelo por conta própria.

O brief, como enviado

You are running a small ad campaign for me on NOLGIA through the nolgia MCP tools. Work only with those tools; do not run shell commands and do not call nolgia_list_models (I am telling you the model).

The product is fictional: matte black over-ear headphones with a thin glowing orange light ring on each ear cup. The approved hero image already exists in my library as asset 74391fde-9c67-44aa-a298-aa090f8d7949.

Do this, in order, and tell me each tool call you make and what came back (ids, sizes, credits):
1. Create a project named "Orange Ring campaign 2" with a one-line description.
2. Open the hero asset with nolgia_get_asset so you know what it looks like, and file it into the project.
3. Make three creatives from the hero with nolgia_image_to_image on the model gpt-image-2.5-flare, using the hero as the reference image so the product stays the same, each in two sizes, aspect ratio 1:1 and 9:16, so six images in total, every one filed into the project by passing the project id:
Creative A "Morning desk": the headphones on a worn oak desk in a shaft of morning window light, dust drifting in the beam, soft shadows, premium ad look.
Creative B "Night rain": the headphones in close-up with fine rain droplets on the matte shells and warm amber streetlight reflections, soft city bokeh behind, music-video look.
Creative C "Silhouette": a young dancer in a long dark coat seen from behind wearing the headphones, under one warm practical lamp in a dark rehearsal room with haze, the orange rings glowing, fashion-film look, no face visible.
4. Spend at most eighty credits in total; each image on this model bills eight credits. Run at most three image calls at once. If a call fails, report it and continue with the next; do not retry more than once.
5. Finish with a short table: creative, size, asset id, and the project id.

Dica:Nomeie o modelo e a referência. nolgia_list_models retorna o catálogo inteiro, muito mais do que uma sessão precisa. Diga o id do modelo no brief. O herói viaja como a imagem de referência em cada chamada de imagem para imagem, o que mantém o produto consistente entre os criativos.

A sessão, verbatim

O Claude Code carregou as quatro ferramentas necessárias, criou o projeto, abriu o hero e o arquivou, depois criou as seis imagens em três lotes, nunca mais de três chamadas de uma vez, e informou o gasto atual após cada lote. As URLs assinadas são encurtadas, os resultados JSON são impressos como linhas de chave e valor, e o início compartilhado por todos os prompts é impresso uma única vez; nada mais é editado.

Ferramentas, projeto e hero (argumentos e resultados como linhas de chave e valor)

CALL ToolSearch
  query: select:mcp__nolgia__nolgia_create_project,mcp__nolgia__nolgia_get_asset,mcp__nolgia__nolgia_add_project_assets,mcp__nolgia__nolgia_image_to_image
  max_results: 4

CALL nolgia_create_project
  name: Orange Ring campaign 2
  description: Ad creatives for matte black over-ear headphones with glowing orange light rings, built from the approved hero image.
CALL nolgia_get_asset
  asset_id: 74391fde-9c67-44aa-a298-aa090f8d7949
RESULT id: b73d2c7d-4a86-4785-8fb5-ddfb98da7b9d, name: Orange Ring campaign 2, asset_count: 0
RESULT status: ready, kind: image, name: Premium product photograph of fictional, asset_id: 74391fde-..., mime_type: image/png, model: gpt-image-2.5-flare, url: (signed url)

CALL nolgia_add_project_assets
  project_id: b73d2c7d-4a86-4785-8fb5-ddfb98da7b9d
  asset_ids: 74391fde-9c67-44aa-a298-aa090f8d7949
RESULT added: true

As seis imagens em três lotes (valores de créditos por extenso)

CALL nolgia_image_to_image
  model: gpt-image-2.5-flare
  aspect_ratio: 1:1
  project_id: b73d2c7d-...
  image_url: (signed url of the hero)
  prompt: Keep the exact same headphones from the reference image: matte black over-ear headphones with a thin glowing orange light ring on each ear cup, identical shape and details. Scene: the headphones resting on a worn oak desk in a shaft of morning window light, fine dust drifting visibly in the light beam, soft shadows, cool-to-warm morning tones, shallow depth of field, premium advertising product photography, photoreal. No text, no letters, no logos, no brand names, no watermark.
CALL nolgia_image_to_image
  (the same, with "vertical composition" added) aspect_ratio: 9:16
RESULT status: ready, kind: image, asset_id: fa93b7aa-cba8-427f-8920-38281358a39c
RESULT status: ready, kind: image, asset_id: 96429e72-73a9-4e00-b7c5-297cd426883a
TEXT: Sixteen credits spent so far. Next I'll run Creative B in both sizes and Creative C at 1:1, which is three calls at once.

CALL nolgia_image_to_image
  model: gpt-image-2.5-flare, aspect_ratio: 1:1, project_id: b73d2c7d-..., image_url: (signed url of the hero)
  prompt: Keep the exact same headphones from the reference image: (as above). Scene: night close-up of the headphones with fine rain droplets beaded on the matte shells, warm amber streetlight reflections gliding across the surfaces, the orange rings glowing, soft out-of-focus city bokeh behind, moody cinematic music-video look, photoreal. No text, no letters, no logos, no brand names, no watermark.
CALL nolgia_image_to_image
  (the same, with "vertical composition" added) aspect_ratio: 9:16
CALL nolgia_image_to_image
  model: gpt-image-2.5-flare, aspect_ratio: 1:1, project_id: b73d2c7d-..., image_url: (signed url of the hero)
  prompt: Keep the exact same headphones from the reference image: (as above). Scene: a young dancer in a long dark coat seen from behind, wearing the headphones, standing in a dark rehearsal room filled with light haze, lit by a single warm practical lamp, the orange rings glowing clearly, face not visible, fashion-film look, cinematic, photoreal. No text, no letters, no logos, no brand names, no watermark.
RESULT status: ready, kind: image, asset_id: 067eb5f3-76fd-4bb7-a513-44936650ed79
RESULT status: ready, kind: image, asset_id: 24b9247e-ce62-41fc-869b-a954c814e599
RESULT status: ready, kind: image, asset_id: 38521354-d302-4b3f-9081-3fe3ad253c52
TEXT: Forty credits spent so far. One image left.

CALL nolgia_image_to_image
  (Creative C again, with "vertical full-figure composition" added) aspect_ratio: 9:16
RESULT status: ready, kind: image, asset_id: e34a8f78-1872-4d3b-b6a4-dd9d4ab1e9d9

Executou sem erros: seis imagens, quarenta e oito créditos, dentro dos oitenta que definimos, sem paradas, sem timeouts e sem novas tentativas. Como o briefing especificava a taxa por imagem, ele contabilizou seu próprio gasto em vez de ler a carteira.

Sua mensagem final (valores de créditos por extenso)

All six images were made and filed into the project, for forty-eight credits in total (under your eighty limit). No calls failed and none were retried.

Tool calls, in order
1. nolgia_create_project with the name "Orange Ring campaign 2" and the description "Ad creatives for matte black over-ear headphones with glowing orange light rings, built from the approved hero image." It returned project b73d2c7d-4a86-4785-8fb5-ddfb98da7b9d, with 0 assets.
2. nolgia_get_asset on 74391fde-9c67-44aa-a298-aa090f8d7949 returned a ready PNG image made with gpt-image-2.5-flare. I didn't see the picture itself, only its details and the prompt it was made from. The prompt describes the headphones on a worn oak desk by a window in late-afternoon daylight, with a long warm shadow and shallow depth of field. I used its signed link as the reference image in every call below.
3. nolgia_add_project_assets filed the hero into the project and returned added: true.
4. nolgia_image_to_image ran six times on gpt-image-2.5-flare, with the hero as the reference and the project id passed each time. Every prompt starts by telling the model to keep the exact same headphones, and every one includes "no text, no logos, no watermark":
- First batch (2 calls at once): Creative A at 1:1 and 9:16. Both came back ready, eight credits each, sixteen so far.
- Second batch (3 calls at once): Creative B at 1:1 and 9:16, and Creative C at 1:1. All came back ready, eight credits each, forty so far.
- Third batch (1 call): Creative C at 9:16. It came back ready for eight credits, forty-eight in total.

The project now holds 7 assets: the hero plus the six new images. I haven't looked at any of the new images. Before you use them, check that the headphones match the hero and that no face shows in the Silhouette images.

Ele nunca viu as imagens, apenas seus detalhes, por isso suas últimas linhas pedem que você as verifique: abra o projeto e olhe cada imagem em tamanho real. A linha "No text, no letters, no logos, no brand names, no watermark" em cada prompt foi uma adição própria do Claude Code; o briefing não a solicitou. Se você quiser um letreiro ou seu logotipo em um criativo, nomeie-o no briefing ou anexe a imagem exata do logotipo, e regenere se o texto voltar distorcido.

A campanha

Seis imagens, todas a partir do mesmo herói, todas no GPT Image 2.5 Flare, cada uma cobrada na taxa do modelo. O produto é o mesmo objeto em todas porque o herói foi a referência em cada chamada.

Os fones de ouvido em uma mesa de carvalho sob um raio de luz da janela pela manhã, poeira flutuando no feixe, quadrado. — **Criativo A, 1:1.** Mesa pela manhã.

Os fones de ouvido em uma mesa de carvalho sob um raio de luz da janela pela manhã, poeira flutuando no feixe, vertical. — **Criativo A, 9:16.**

Close dos fones de ouvido cobertos de gotas de chuva, reflexos de luz de rua âmbar e bokeh da cidade ao fundo, quadrado. — **Criativo B, 1:1.** Chuva noturna, luz de rua quente nas gotas.

Close dos fones de ouvido cobertos de gotas de chuva, reflexos de luz de rua âmbar e bokeh da cidade ao fundo, vertical. — **Criativo B, 9:16.**

Uma jovem dançarina vista de costas, com um casaco longo escuro, usando os fones de ouvido em uma sala de ensaio com névoa, uma lâmpada quente, os anéis laranja brilhando, formato quadrado. — **Criativo C, 1:1.** Silhueta sob uma lâmpada quente.

Onde fica no site

Abra Projetos e o projeto da campanha. O hero e os seis criativos estão na mídia do projeto, e os slots de Elenco, Locações e Kit de marca do projeto estão prontos se a próxima rodada precisar de um performer recorrente, um lugar ou sua paleta e logo. Daqui você baixa o conjunto ou abre qualquer imagem no Studio.

Grade de mídia do Projeto da campanha Orange Ring 2: o hero e os seis criativos, quadrados e verticais, com seus tamanhos — **A mídia do projeto.** Sete assets, arquivados pela sessão.

A mesma sessão pode executar os presets da campanha na página Campanhas com nolgia_run_preset: posters em quatro tamanhos com suas palavras definidas como texto real, pacotes de anúncios estáticos, outdoors e filmes de lançamento. Ficamos nas ferramentas de imagem brutas aqui para que a transcrição mostre cada parâmetro.

Três formas de executar

Caminho	Como	Melhor quando
Mais rápido	Um preset por formato com nolgia_run_preset do Claude Code, ou no site em Campanhas	Você quer os layouts comprovados e texto real nos posters
Mãos à obra	Dê as instruções ao NOLGIA Agent no chat; ele trabalha nos formatos e arquiva os arquivos	Você não está em um terminal
Mais controle	Claude Code com as ferramentas de imagem brutas, como neste guia	Você quer dirigir cada criativo e manter a referência

O que fica fora da sessão

Publicação. O NOLGIA não publica em plataformas de anúncios nem agenda. Você baixa o conjunto e envia para onde a campanha roda.
Texto na imagem. As ferramentas de imagem brutas não definem texto real; os presets de poster sim.
Criativos em vídeo. A mesma sessão pode chamar nolgia_text_to_video e nolgia_image_to_video; este guia ficou nas imagens estáticas.
Um preço no resultado. Um resultado de imagem retorna o asset, não os créditos que custou. O extrato na sua página de cobrança tem o custo por imagem.
ChatGPT. Marcado como Em breve na página do MCP; este guia é apenas para Claude Code.

Quanto custa

A leitura é gratuita: listar modelos, criar um projeto, abrir um asset e arquivar assets não consomem nada. Cada imagem é cobrada na taxa do seu modelo. Taxas atuais para o modelo neste guia e os presets que a página de Campanhas executa:

Static ad formats
8 credits per ad, 32 for four versions, 21 each at 2K
Leva under 2 min
Social and poster pack
Priced on the review card before it runs
Leva 3 to 8 minutes

GPT Image 2.5 FlareEvery plan
Per image
Native 8 créditos · 2K 21 créditos · 4K 58 créditos

Lido ao vivo do catálogo quando esta página carrega. Todo preço aparece antes de você gerar. Ver todas as tarifas.

Experimente você mesmo

O hero e o brief

Hero de fones de ouvido, 2048x2048 WebPImagem WebP · 2048x2048 · 233 KBBaixar

Envie o hero para sua Biblioteca, coloque o id do asset dele no brief acima em vez do nosso e envie o brief para o Claude Code com o NOLGIA conectado. Permita também as ferramentas de jobs. Seus criativos diferirão dos nossos; o produto não deve, porque o hero é a referência em cada chamada.

Checklist

Token conectado; nolgia_get_account responde.
Hero aprovado antes de qualquer criativo; seu id de asset no brief.
Projeto criado; seu id em cada geração.
Modelo nomeado no brief; a lista de modelos não alterada.
Teto e a taxa por imagem no brief; as ferramentas de jobs permitidas.
Um timeout é verificado, não tentado novamente às cegas.
Abra o projeto no site e olhe cada imagem em tamanho completo.

Perguntas e respostas

O Claude Code pode fazer toda a campanha de uma vez?: Ele pode encadear as chamadas, mas aprove o hero primeiro: cada criativo é feito a partir dele, então um hero errado significa seis imagens erradas.
Quanto custa a sessão?: Apenas as gerações. Criar o projeto, abrir e arquivar ativos é gratuito; cada imagem é cobrada na taxa publicada do seu modelo. O resultado de uma chamada de imagem não inclui seu preço, então leia o extrato.
Uma chamada expirou. Fui cobrado duas vezes?: Não. A mesma solicitação dentro de cinco minutos recebe um erro 409 que identifica o trabalho existente, e apenas o primeiro é cobrado. Encontre a imagem com as ferramentas de trabalhos ou ativos.
Ele pode colocar meu título na peça criativa?: Não com as ferramentas de imagem brutas. O pacote de pôsteres e redes sociais e os presets de anúncios estáticos definem suas palavras como texto real; execute-os com nolgia_run_preset ou pela página Campanhas.
Isso funciona no ChatGPT?: Ainda não. O ChatGPT está marcado como Em breve na página MCP. O Claude Code e o Cursor funcionam hoje.

Execute sua primeira campanha pelo terminal

Conectar Claude Code

MCP

Gerar do Claude Code ou Cursor com MCP

Conecte o NOLGIA ao Claude Code ou Cursor com um token e um comando ou entrada de configuração, depois peça imagens, vídeos e áudios em palavras simples.

14 de outubro de 2026 · 5 min de leitura

Agente

O livro de receitas do NOLGIA Agent: o que dizer e o que acontece em seguida

Dez mensagens que você pode enviar ao NOLGIA Agent, o que ele faz com cada uma e o preset por trás delas, desde fotos de produtos e um conjunto de listagem até uma pontuação de gancho e uma edição avaliada.

14 de outubro de 2026 · 6 min de leitura

Vídeo de produto

Vídeos de produto sem filmagem: escolha o formato

Sete formatos de vídeo de produto, de um tutorial a um unboxing e a demonstrações apenas com as mãos, cada um com um exemplo real, sua finalidade e quando escolhê-lo.

14 de outubro de 2026 · 8 min de leitura