Modification d'images

POST /api/v1/images/edits accepte multipart/form-data. Portée requise : images:edit.

Champs du formulaire

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

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',
  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'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.

Dimensions de sortie

2K et 4K sont des niveaux de taille, pas des longueurs de côté fixes. Le tableau indique les dimensions réelles en pixels. Les proportions non prises en charge renvoient HTTP 400 (INVALID_REQUEST) avant la création du travail ou la réservation de crédits. Pour une modification sans aspect_ratio, la proportion source doit être comprise entre 1:3 et 3:1 et respecter le niveau demandé (au moins 6 millions de pixels en 4K) ; sinon, indiquez une proportion de sortie prise en charge.