Integre as imagens do AnonShot no seu app

1. Criar e proteger o token

O token completo só aparece uma vez. Guarde-o numa variável de ambiente do seu backend, nunca no Git, numa URL, em JavaScript enviado ao navegador ou num app mobile distribuído.

ANONSHOT_TOKEN=anon_live_…

Authorization: Bearer $ANONSHOT_TOKEN

• photos:write permite upload, edição e exclusão.
• photos:read permite listar, ver detalhes e baixar com autenticação.
• As cotas padrão são de 60 requisições por minuto e 10.000 por mês.
• Os tokens podem ser revogados e ter data de expiração.

2. Enviar uma foto

Envie um formulário multipart/form-data. O campo files pode se repetir: JPEG, PNG, WebP e GIF são aceitos, com até 50 MB por arquivo e 20 arquivos por requisição.

Exemplo com curl

curl -X POST https://anonshot.com/api/v1/photos \
  -H "Authorization: Bearer $ANONSHOT_TOKEN" \
  -F "files=@photo.jpg"

Opções: adicione -F "password=um-segredo-diferente" para proteger a página, ou -F "burnAfterRead=true" para uma imagem de visualização única. Não use essas opções se um serviço externo precisar ler a URL pública livremente.

Exemplo em JavaScript no servidor

import { readFile } from "node:fs/promises"

const bytes = await readFile("photo.jpg")
const form = new FormData()
form.append("files", new Blob([bytes], { type: "image/jpeg" }), "photo.jpg")

const response = await fetch("https://anonshot.com/api/v1/photos", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.ANONSHOT_TOKEN}`,
  },
  body: form,
})

const payload = await response.json()
if (!response.ok) throw new Error(payload.error?.message ?? "Falha no upload")

const photo = payload.data[0]
console.log(photo.shortUrl, photo.publicImageUrl)

Não defina você mesmo o cabeçalho Content-Type: o FormData adiciona automaticamente o boundary multipart correto.

3. A resposta e suas três URLs

{
  "data": [{
    "id": "…",
    "shortUrl": "Ab3dE7xK",
    "shareUrl": "https://anonshot.com/p/Ab3dE7xK",
    "publicImageUrl": "https://anonshot.com/p/Ab3dE7xK/image",
    "fileUrl": "https://anonshot.com/api/v1/photos/Ab3dE7xK/file",
    "mime": "image/webp",
    "size": 183421,
    "width": 2048,
    "height": 1365,
    "burnAfterRead": false,
    "passwordProtected": false
  }]
}

O endereço direto é sempre /p/{code}/image. Ele devolve os bytes da imagem em WebP, já processada, e não uma página HTML. Fotos criadas com um token de conta não expiram, a não ser que sejam apagadas ou abertas como compartilhamento de visualização única. Uma foto com senha não funciona para um LLM que não tenha o cookie de desbloqueio.

4. Conectar a imagem a um LLM

Se o provedor aceita URL de imagem, passe photo.publicImageUrl diretamente. Se a imagem não pode ser pública, busque os bytes em fileUrl no servidor e envie esses bytes ao provedor conforme a API dele.

const imageResponse = await fetch(photo.fileUrl, {
  headers: { Authorization: `Bearer ${process.env.ANONSHOT_TOKEN}` },
})

if (!imageResponse.ok) throw new Error("Imagem inacessível")
const imageBytes = await imageResponse.arrayBuffer()
// Depois passe imageBytes para o SDK do LLM.

Nunca passe o token do AnonShot ao LLM nem o coloque como parâmetro de URL. O token só serve entre o seu backend e o anonshot.com.

5. Ler, listar e apagar

# Listar suas fotos
curl https://anonshot.com/api/v1/photos \
  -H "Authorization: Bearer $ANONSHOT_TOKEN"

# Ver os dados de uma foto
curl https://anonshot.com/api/v1/photos/Ab3dE7xK \
  -H "Authorization: Bearer $ANONSHOT_TOKEN"

# Baixar o WebP limpo
curl https://anonshot.com/api/v1/photos/Ab3dE7xK/file \
  -H "Authorization: Bearer $ANONSHOT_TOKEN" \
  --output Ab3dE7xK.webp

# Apagar o compartilhamento de vez
curl -X DELETE https://anonshot.com/api/v1/photos/Ab3dE7xK \
  -H "Authorization: Bearer $ANONSHOT_TOKEN"

Limpar só os metadados EXIF

Esta rota recebe uma imagem e devolve direto um WebP limpo, sem criar link de compartilhamento.

curl -X POST https://anonshot.com/api/v1/exif/clean \
  -H "Authorization: Bearer $ANONSHOT_TOKEN" \
  -F "files=@photo.jpg" \
  --output foto-sem-metadados.webp

O cabeçalho X-AnonShot-Photo-Id traz o identificador da operação. JPEG, PNG e WebP são aceitos nesta rota.

Todas as rotas