Documentation API
Modification d'images
Modifier une image envoyée à l'aide d'instructions en langage naturel
POST /api/v1/images/edits accepte multipart/form-data. Portée requise :
images:edit.
Champs du formulaire
| Champ | Type | Obligatoire | Défaut | Règles |
|---|---|---|---|---|
image | file | oui | — | PNG, JPEG ou WebP ; 10 Mio et 40 millions de pixels décodés au maximum |
prompt | string | oui | — | instruction de modification, 5 à 2 000 caractères |
aspect_ratio | string | non | dépend de la source | mêmes rapports publics que la génération |
resolution | string | non | 2K | 2K ou 4K |
count | integer | non | 1 | 1 à 4 |
Les signatures de fichier sont vérifiées indépendamment du type MIME déclaré.
Une image invalide, trop volumineuse ou dangereuse renvoie
400 INVALID_REQUEST, ou HTTP 413 avec le même code public.
Crédits
| Résolution | Crédits par sortie |
|---|---|
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'image envoyée est une entrée privée du job et n'est jamais renvoyée dans les réponses de job ou de journal. Les envois idempotents en double sont écartés ; les sources acceptées sont supprimées après un résultat terminal.

Documentation API