Voltar ao início
altgen.
Todos os posts
Todos os posts

Conectando o AltGen ao Seu Pipeline de Upload com a API

O painel é ótimo para lotes pontuais, mas se as imagens circulam constantemente no seu produto, você não quer um humano no meio do caminho para o texto alternativo. Veja como conectar o AltGen diretamente ao seu próprio fluxo de upload.

Consiga uma chave de API com escopo limitado

Crie uma em Settings → API Keys. As chaves têm escopo por workspace, podem expirar opcionalmente e podem ser revogadas sem afetar o resto da sua integração.

curl -X POST https://api.altgen.io/v1/images/generate \
  -H "Authorization: Bearer $ALTGEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://cdn.yourstore.com/sneaker.jpg",
    "preset": "ecommerce",
    "style": "concise",
    "languages": ["en", "de", "tr"]
  }'

A resposta volta com o texto alternativo principal mais uma tradução para cada idioma solicitado:

{
  "altText": "Burgundy low-top sneaker with a white sole, floating on a yellow background",
  "translations": { "de": "…", "tr": "…" },
  "status": "completed",
  "creditsCost": 1
}

Duas formas de consumir os resultados

Síncrona — chame o endpoint e espere a resposta. Simples, mas só faz sentido para imagens únicas ou volume baixo.

Webhooks — para qualquer coisa em escala, assine os eventos de geração em vez disso. O AltGen envia um payload para seu endpoint assim que uma imagem termina de ser processada, então seu manipulador de upload não fica esperando um lote de 500 imagens.

Uma integração típica com CMS

  1. O editor faz upload de uma imagem no seu CMS.
  2. Seu manipulador de upload chama POST /v1/images/generate com a URL da imagem.
  3. O AltGen processa e dispara um webhook para seu endpoint ao concluir.
  4. Seu manipulador grava o texto alternativo retornado diretamente no campo de metadados da imagem.

Sem painel, sem etapa de revisão manual, sem imagem publicada sem texto alternativo porque alguém esqueceu de preencher um campo.

Reprocessando falhas sem vigiar um lote

Se uma geração falhar, chame PATCH /v1/images/{id}/retry em vez de reenviar tudo. É o mesmo mecanismo que os lotes em massa usam internamente, apenas exposto para os casos em que você gerencia imagens individuais pela API.

Essa é toda a superfície: um endpoint para gerar, listar, atualizar e reprocessar, além de webhooks se você não quiser fazer polling. A referência completa está na documentação da API.