Panoramica

L'API REST di SciDraw AI offre endpoint stabili basati su job per la generazione di immagini, la modifica di immagini e la conversione di formato.

URL di base: https://sci-draw.com

Specifica leggibile da macchina: OpenAPI JSON · OpenAPI YAML

I due file descrivono la stessa API in formato OpenAPI. Importane uno in Postman o Insomnia e avrai tutti gli endpoint già compilati; passalo a un generatore di codice e ottieni un client tipizzato; consegnalo a un agente IA e potrà chiamare l'API senza che tu scriva la richiesta a mano. I due formati sono intercambiabili: usa quello che il tuo strumento accetta.

Avvio rapido

1. Crea una chiave API in Impostazioni → Chiavi API e seleziona solo gli ambiti che servono alla tua integrazione.
2. Invia la chiave come Authorization: Bearer sd_....
3. Aggiungi un Idempotency-Key univoco a ogni richiesta di creazione.
4. Conserva l'ID del job restituito e interroga il suo URL Location finché non arriva a succeeded, failed o canceled.

curl https://sci-draw.com/api/v1/images/generations \
  -H 'Authorization: Bearer sd_YOUR_KEY' \
  -H 'Idempotency-Key: order-7842-figure-1' \
  -H 'Content-Type: application/json' \
  -d '{
    "prompt": "A clean scientific illustration of exosome biogenesis",
    "aspect_ratio": "16:9",
    "resolution": "2K",
    "count": 1
  }'

Una richiesta di creazione restituisce di norma 202 Accepted, un oggetto job, un header Location e Retry-After: 2. Puoi aggiungere Prefer: wait=10 per attendere fino a dieci secondi. L'attesa non cambia mai la semantica del job: lo stato è 200 solo se il job è già terminato, altrimenti resta 202.

Endpoint

Tutte le risposte sono buste JSON. Ogni risposta porta un X-Request-Id: indica quell'ID quando contatti il supporto. Gli unici riferimenti a file restituiti sono gli URL di output e gli ID pubblici dei file. L'instradamento delle capacità è gestito da SciDraw AI.