Ridurre immagini API

Ridurre immagini API, ImmagineMini connette il job alla tua app: invii il file, controlli lo stato del job e scarichi l'output. Gli endpoint vengono eseguiti sul server, senza passare dal browser.

Avvio rapido

Crea una chiave nella sezione API per sviluppatori del tuo account; la chiave in chiaro viene mostrata solo al momento della creazione.
Invia la richiesta a https://api.pixepi.com con l'header Authorization: Bearer <key>.
Verifica lo stato del job nella risposta con GET https://api.pixepi.com/api/v1/jobs/{id}; quando lo stato è done, scarica l'output da download_url.

Richiesta di esempio

curl -X POST "https://api.pixepi.com/api/v1/apps/gorsel-kucult/run" \
  -H "Authorization: Bearer $PIXEPI_KEY" \
  -F "[email protected]" \
  -F "options[quality]=82" \
  -F "options[format]=same"

curl -H "Authorization: Bearer $PIXEPI_KEY" "https://api.pixepi.com/api/v1/jobs/42"

Endpoint di questo strumento

Metodo	Percorso	Descrizione
`POST`	`/run`	Esegue lo strumento, avvia un job e restituisce il risultato.

Opzioni

Le opzioni vengono inviate come options[<field>]; se lasci vuoto un campo, viene usato il valore predefinito.

Campo	Valori	Predefinito
`options[quality]` Qualità	40–95	`82`
`options[max_side]` Limite del lato lungo (facoltativo)	0–6000	`vuoto`
`options[format]` Formato di output	same · jpeg · webp · png	`same`
`options[auto_rotate]` Correggi automaticamente l'orientamento da smartphone	abilitato · disabilitato	`abilitato`

Endpoint condivisi

Metodo	Percorso	Descrizione
`GET`	`/api/v1/apps`	Catalogo API
`GET`	`/api/v1/apps/gorsel-kucult`	Contratto dello strumento
`GET`	`/api/v1/jobs/{id}`	Stato del job
`GET`	`/api/v1/jobs/{id}/download`	Scarica l'output del job
`GET`	`/api/v1/usage`	Riepilogo utilizzo
`GET`	`/api/v1/openapi.json`	Documento OpenAPI 3.1

Limiti

Al massimo 100 MB per file.
Batch: invia lo stesso campo file più di una volta.
Le informazioni su quota e piano sono associate al tuo account; controlla lo stato attuale con GET /api/v1/usage.

Codici di errore

Codice	Significato
`unauthorized`	Chiave API mancante o non valida.
`forbidden`	Operazione non consentita con questa chiave.
`not_found`	Strumento, job o record non trovato (404 anche per accesso tra account diversi).
`invalid_input`	Convalida dell'input fallita (campo mancante o non valido, data errata, ecc.).
`invalid_request`	Richiesta non valida.
`too_large`	Dimensione del file o del body oltre il limite.
`unsupported_media`	Tipo di file non supportato.
`not_supported`	Questo strumento non può essere eseguito su questo endpoint (app con stato).
`not_ready`	Il job non è ancora completato.
`expired`	L'output è scaduto.
`no_output`	Nessun output da scaricare per questo job.
`invalid_path`	Percorso di output non valido.
`quota_exceeded`	Quota o limite di richieste superato.
`rate_limited`	Troppe richieste in poco tempo; attendi un attimo e riprova.
`csrf`	Verifica del modulo browser non riuscita (l'API esterna usa chiavi).
`conflict`	L'operazione è in conflitto con lo stato attuale.
`unavailable`	Lo strumento è temporaneamente non disponibile.
`internal_error`	Errore imprevisto del server.

Documenti

Domande frequenti

Dove posso ottenere una chiave API?

Crea una chiave nella sezione API per sviluppatori del tuo account; la chiave viene mostrata una sola volta, al momento della creazione.

Come si invia una richiesta?

Gli endpoint rispondono su https://api.pixepi.com; ogni richiesta deve includere l'intestazione "Authorization: Bearer <key>".

Quali file accetta l'API di ImmagineMini?

Formati accettati: JPG · JPEG · PNG · WEBP. Il limite è di 100 MB per file; le opzioni sono le stesse disponibili nella pagina dello strumento.

Come si legge una risposta di errore?

Il corpo dell'errore include i campi {ok:false, error, code, request_id}; i valori di code sono consultabili nella tabella dei codici di errore.