LogoLogoDocumentazione API
LogoLogoDocumentazione API
Homepage
PanoramicaAutenticazione e idempotenzaGenerazione di immaginiModifica di immaginiConversione di immaginiGenerazione di graficiJob e attesa limitataCreditiErroriLimiti di frequenza e concorrenzaChangelog dell'API
Documentazione 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

CampoTipoObbligatorioPredefinitoRegole
imagefilesì—PNG, JPEG o WebP; al massimo 10 MiB e 40 milioni di pixel decodificati
promptstringsì—istruzione di modifica, 5–2.000 caratteri
aspect_ratiostringnodipende dall'originalegli stessi rapporti pubblici della generazione
resolutionstringno2K2K o 4K
countintegerno11–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

RisoluzioneCrediti per output
2K10
4K20

cURL

Generazione di immagini

Creare job da testo a immagine

Conversione di immagini

Convertire immagini in SVG, PPTX, PNG, PDF o TIFF

Indice

Campi del modulo
Crediti
cURL
JavaScript
Python
Dimensioni di uscita
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',
  headers: { Authorization: `Bearer ${apiKey}`, 'Idempotency-Key': crypto.randomUUID() },
  body: form,
});

Python

with open("figure.png", "rb") as image:
    response = requests.post(
        "https://sci-draw.com/api/v1/images/edits",
        headers={"Authorization": f"Bearer {api_key}", "Idempotency-Key": str(uuid.uuid4())},
        files={"image": ("figure.png", image, "image/png")},
        data={"prompt": "Move the legend below the diagram"},
    )

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.

Dimensioni di uscita

2K e 4K sono livelli di dimensione, non lunghezze fisse dei lati. La tabella mostra i pixel effettivi. Le proporzioni non supportate restituiscono HTTP 400 (INVALID_REQUEST) prima di creare il processo o riservare crediti. Per le modifiche senza aspect_ratio, la proporzione originale deve essere compresa tra 1:3 e 3:1 e soddisfare il livello richiesto (almeno 6 milioni di pixel per 4K); altrimenti specifica una proporzione supportata.

aspect_ratio2K4K
1:12048×20482880×2880
16:92560×14403840×2160
9:161440×25602160×3840
4:32304×17283264×2448
3:41728×23042448×3264
3:22496×16643504×2336
2:31664×24962336×3504
5:42240×17923200×2560
4:51792×22402560×3200
21:93136×13443808×1632