Documentazione APIDocumentazione API
Modifica di immagini
Modificare un'immagine caricata con istruzioni in linguaggio naturale
POST /api/v1/images/edits accetta multipart/form-data. Ambito richiesto:
images:edit.
Campi del modulo
| Campo | Tipo | Obbligatorio | Predefinito | Regole |
|---|---|---|---|---|
image | file | sì | — | PNG, JPEG o WebP; al massimo 10 MiB e 40 milioni di pixel decodificati |
prompt | string | sì | — | istruzione di modifica, 5–2.000 caratteri |
aspect_ratio | string | no | dipende dall'originale | gli stessi rapporti pubblici della generazione |
resolution | string | no | 2K | 2K o 4K |
count | integer | no | 1 | 1–4 |
Le firme dei file sono verificate indipendentemente dal tipo MIME dichiarato.
Immagini non valide, troppo grandi o non sicure restituiscono
400 INVALID_REQUEST, oppure HTTP 413 con lo stesso codice pubblico.
Crediti
| Risoluzione | Crediti per output |
|---|---|
2K | 10 |
4K | 20 |
cURL
curl https://sci-draw.com/api/v1/images/edits \
-H 'Authorization: Bearer sd_YOUR_KEY' \
-H 'Idempotency-Key: revise-figure-7-v2' \
-F 'image=@figure.png;type=image/png' \
-F 'prompt=Move the legend below the diagram and increase label contrast' \
-F 'resolution=2K' \
-F 'count=1'JavaScript
const form = new FormData();
form.set('image', file);
form.set('prompt', 'Move the legend below the diagram');
const response = await fetch('https://sci-draw.com/api/v1/images/edits', {
method: 'POST',
Python
with open("figure.png", "rb") as image:
response = requests.post(
"https://sci-draw.com/api/v1/images/edits",
headers={"Authorization": f"Bearer
L'immagine caricata è input privato del job e non viene mai restituita nelle risposte di job o di log. I caricamenti idempotenti duplicati vengono scartati; gli originali accettati sono rimossi dopo un risultato terminale.