# SciFig API

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

Fonte: https://scifig.ai/it/docs/api

## Avvio rapido

- Crea una chiave API in [Impostazioni → Sviluppatore](/it/app/settings?tab=developer). 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.

```bash
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](https://scifig.ai/api/v1/openapi.json) e [OpenAPI YAML](https://scifig.ai/api/v1/openapi.yaml). Gli assistenti IA possono usare le stesse funzioni tramite il [server MCP](/it/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.