Riferimento API

SciFig API

Name: SciFig
Author: SciFig

Crea illustrazioni scientifiche, grafici e diagrammi di flusso tramite HTTP, con gli stessi motori, prezzi e crediti del sito SciFig.

Visualizza in Markdown

Avvio rapido#

Crea una chiave API in Impostazioni → Sviluppatore. Le chiavi di generazione richiedono un abbonamento attivo o un saldo positivo di crediti acquistati in pacchetti; le chiavi di sola lettura funzionano con qualsiasi account.
Invia una richiesta di creazione con un Idempotency-Key. Con Prefer: wait=25, la risposta attende fino a 25 secondi e restituisce il processo completato se termina in tempo.
Se il processo è ancora queued o processing, consulta GET /jobs/{id} ogni pochi secondi, rispettando Retry-After, finché diventa succeeded o failed.
Scarica ogni risultato dal relativo download_url, valido per un’ora, oppure passa il suo file_id a un altro endpoint.

curl -X POST https://scifig.ai/api/v1/images/generations \
  -H "Authorization: Bearer $SCIFIG_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Prefer: wait=25" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "Mitochondrial electron transport chain, labelled", "aspect_ratio": "4:3"}'

URL di base: https://scifig.ai/api/v1. Contratto leggibile dalle macchine: OpenAPI JSON e OpenAPI YAML. Gli assistenti IA possono usare le stesse funzioni tramite il server MCP.

Endpoint#

Endpoint	Funzione	Crediti
POST /images/generations	Genera un’illustrazione scientifica da una descrizione	50 / 75 / 100
POST /images/edits	Modifica tramite istruzioni o regione, sfondo bianco, proporzioni, cambio di colori, sostituzione del testo	50 / 75 / 100; regione o testo 100
POST /images/text-detections	Rileva il testo in un’immagine prima di sostituirlo	0
POST /images/upscales	Ingrandisci a 2K, 4K o 8K	50 / 100 / 150
POST /images/conversions	Vettorializzazione SVG; esportazione PNG, PDF, TIFF e PPTX	SVG 150; PNG, PDF, TIFF e PPTX gratuiti
POST /charts/generations	Crea un grafico da dati CSV, TSV o Excel	100
POST /charts/edits	Modifica l’ultima versione di un grafico	100
POST /flowcharts/generations	Disegna un diagramma di flusso in SVG	100
POST /flowcharts/edits	Modifica l’ultima versione di un diagramma di flusso	100
POST /files	Carica un’immagine, una maschera o un allegato	0
GET /files/{file_id}	Scarica un file	0
GET /jobs/{id}	Consulta un processo	0
GET /jobs	Elenca i processi recenti	0
GET /credits	Saldo, piano e limiti delle attività	0
GET /pricing	Tutti i prezzi, senza autenticazione	0
GET /openapi.json	Descrizione OpenAPI 3.1, senza autenticazione	0
GET /openapi.yaml	La stessa descrizione in YAML, senza autenticazione	0

Non sono disponibili webhook, SDK o strumenti da riga di comando: chiama gli endpoint direttamente da un server o da uno script. L’API non consente richieste CORS dal browser.

SuccessivoAutenticazione e idempotenzaCredenziali, ambiti, Idempotency-Key e identificativi delle richieste per ogni chiamata all’API SciFig.