API pubblica
API per figure scientifiche
Genera e modifica illustrazioni scientifiche, crea grafici dai tuoi dati e disegna diagrammi di flusso tramite HTTP, con gli stessi motori del sito SciFig.
Gli stessi crediti del sito: acquistali una volta sulla pagina dei prezzi e usali ovunque.
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"}'Ottieni l’accesso
- 1
Accedi
Usa il tuo account SciFig. Le chiavi di sola lettura funzionano con qualsiasi account; le chiavi che creano figure richiedono un abbonamento attivo o un saldo positivo di crediti acquistati in pacchetti.
- 2
Crea una chiave
In Impostazioni → Sviluppatore, scegli sola lettura o lettura e generazione e una scadenza. La chiave viene mostrata una sola volta.
- 3
Invia la richiesta e attendi
Invia una richiesta con un Idempotency-Key e
Prefer: wait=25, poi scarica i risultati o consulta il processo fino al completamento.
Cosa permette l’API
Generazione di immagini
POST /images/generations
Illustrazioni scientifiche da una descrizione, con stili, palette e fino a tre immagini di riferimento.
Modifica di immagini
POST /images/edits
Modifica tramite istruzioni o una regione mascherata: sfondo bianco, nuove proporzioni, altri colori o sostituzione del testo nella sua posizione.
Ingrandimenti
POST /images/upscales
Ingrandisci a 2K, 4K o 8K per la stampa.
Conversioni
POST /images/conversions
SVG modificabile tramite vettorializzazione; PNG, PDF, TIFF e PPTX a 300–1000 DPI, anche per i diagrammi di flusso.
Grafici
POST /charts/generations
Grafici pronti per la pubblicazione da CSV o Excel, negli stili delle riviste scientifiche, con modifiche successive.
Diagrammi di flusso
POST /flowcharts/generations
Diagrammi CONSORT, flussi di lavoro e sequenze di elaborazione in SVG modificabile, con modifiche successive.
File
POST /files · GET /files/{id}
Carica immagini, maschere e allegati; scarica ogni risultato con un link firmato.
Processi e crediti
GET /jobs/{id} · GET /credits
Stato, risultati e quantità esatte di crediti riservati, addebitati e restituiti.
Lavori in un assistente IA?
Collega Claude, ChatGPT, Claude Code, Codex o Cursor al server MCP di SciFig. Claude, ChatGPT, Claude Code e Codex accedono con il tuo account SciFig; Cursor usa una chiave API.
Il costo di ogni chiamata
| Operation | Credits |
|---|---|
| Generazione di immagine | 50 / 75 / 100 (standard / advanced / premium) |
| Modifica di immagine | 50 / 75 / 100; regione o testo 100 |
| Rilevamento del testo | Gratis |
| Ingrandimento | 50 / 100 / 150 (2K / 4K / 8K) |
| Conversione | SVG 150; PNG, PDF, TIFF e PPTX gratuiti |
| Creazione o modifica di grafico | 100 |
| Creazione o modifica di diagramma di flusso | 100 |
| Consultazione di processi, file, crediti e prezzi | Gratis |
I crediti vengono riservati all’avvio del processo, addebitati una sola volta in caso di successo e restituiti integralmente in caso di errore. Tutti i prezzi.
Limiti
20
richieste di creazione al minuto per chiave
40
richieste di creazione al minuto per account
120
richieste di lettura al minuto per chiave
30 s
attesa massima per richiesta
200
conversioni raster gratuite al giorno
I processi simultanei e quelli per ora dipendono dal tuo piano e sono condivisi con il sito. Una risposta 429 include Retry-After: attendi, poi riprova con lo stesso Idempotency-Key.
Domande
Serve un piano a pagamento?+
Le chiavi di sola lettura funzionano con qualsiasi account. Le chiavi che creano figure richiedono un abbonamento attivo o un saldo positivo di crediti acquistati in pacchetti, perché ogni creazione consuma crediti.
I crediti API sono separati da quelli del sito?+
No. Il sito, l’API e il server MCP condividono un unico saldo e un unico listino.
Cosa succede se un processo non riesce?+
I crediti riservati vengono restituiti integralmente. Un’illustrazione che ha superato il tempo limite può ancora essere consegnata gratuitamente entro 24 ore; il processo indica fino a quando.
I risultati compaiono sul sito?+
Sì. Grafici e diagrammi di flusso compaiono come conversazioni nei rispettivi spazi di lavoro, dove puoi continuare a modificarli. I risultati includono una editor_url che li apre lì. I link di download nelle risposte API durano un’ora; consulta di nuovo il processo per riceverne uno nuovo.
Esiste una modalità di prova?+
No. Le chiamate di sola lettura e le conversioni PNG, PDF, TIFF e PPTX sono gratuite, quindi puoi predisporre gran parte di un’integrazione senza spendere crediti.
Posso ottenere limiti più alti?+
Scrivici dalla pagina di contatto indicando il volume previsto.
Inizia con la richiesta qui sopra
Crea una chiave, incolla il comando cURL in un terminale e la tua figura sarà pronta in circa un minuto.