Integra le immagini AnonShot nella tua applicazione

1. Creare e proteggere il token

Il token completo viene mostrato una sola volta. Mettilo in una variabile d'ambiente del tuo backend, mai in Git, in un URL, in JavaScript inviato al browser o in un'app mobile distribuita.

ANONSHOT_TOKEN=anon_live_…

Authorization: Bearer $ANONSHOT_TOKEN

• photos:write consente upload, modifica ed eliminazione.
• photos:read consente elenco, dettagli e download autenticato.
• Le quote predefinite sono 60 richieste al minuto e 10.000 al mese.
• I token si possono revocare e possono avere una data di scadenza.

2. Caricare una foto

Invia un modulo multipart/form-data. Il campo files è ripetibile: sono accettati JPEG, PNG, WebP e GIF, fino a 50 MB per file e 20 file per richiesta.

Esempio con curl

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

Opzioni: aggiungi -F "password=un-segreto-diverso" per proteggere la pagina, oppure -F "burnAfterRead=true" per un'immagine a visione singola. Non usare queste opzioni se un servizio esterno deve poter leggere liberamente l'URL pubblico.

Esempio JavaScript lato server

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 ?? "Upload non riuscito")

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

Non impostare tu l'intestazione Content-Type: FormData aggiunge automaticamente il boundary multipart corretto.

3. La risposta e i suoi tre URL

{
  "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
  }]
}

L'indirizzo diretto è sempre /p/{code}/image. Restituisce i byte dell'immagine in WebP, già elaborata, e non una pagina HTML. Le foto create con un token di account non scadono, salvo eliminazione o apertura di una condivisione a visione singola. Una foto protetta da password non va bene per un LLM che non ha il cookie di sblocco.

4. Collegare l'immagine a un LLM

Se il fornitore accetta un URL di immagine, passagli direttamente photo.publicImageUrl. Se l'immagine non deve essere pubblica, recupera invece i byte da fileUrl lato server e inviali al fornitore secondo la sua API.

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

if (!imageResponse.ok) throw new Error("Immagine non raggiungibile")
const imageBytes = await imageResponse.arrayBuffer()
// Poi passa imageBytes all'SDK dell'LLM.

Non passare mai il token AnonShot all'LLM e non aggiungerlo mai come parametro dell'URL. Il token serve solo tra il tuo backend e anonshot.com.

5. Leggere, elencare ed eliminare

# Elencare le tue foto
curl https://anonshot.com/api/v1/photos \
  -H "Authorization: Bearer $ANONSHOT_TOKEN"

# Leggere i dettagli di una foto
curl https://anonshot.com/api/v1/photos/Ab3dE7xK \
  -H "Authorization: Bearer $ANONSHOT_TOKEN"

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

# Eliminare definitivamente la condivisione
curl -X DELETE https://anonshot.com/api/v1/photos/Ab3dE7xK \
  -H "Authorization: Bearer $ANONSHOT_TOKEN"

Ripulire solo i metadati EXIF

Questa rotta riceve un'immagine e restituisce direttamente un WebP ripulito, senza creare un link di condivisione.

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

L'intestazione X-AnonShot-Photo-Id contiene l'identificativo dell'operazione. Su questa rotta sono accettati JPEG, PNG e WebP.

Tutte le rotte