LogoLogoDocumentation API
LogoLogoDocumentation API
Accueil
Vue d'ensembleAuthentification et idempotenceGénération d'imagesModification d'imagesConversion d'imagesGénération de graphiquesJobs et attente bornéeCréditsErreursLimites de débit et concurrenceJournal des versions de l'API
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

ChampTypeObligatoireDéfautRègles
imagefileoui—PNG, JPEG ou WebP ; 10 Mio et 40 millions de pixels décodés au maximum
promptstringoui—instruction de modification, 5 à 2 000 caractères
aspect_ratiostringnondépend de la sourcemêmes rapports publics que la génération
resolutionstringnon2K2K ou 4K
countintegernon11 à 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ésolutionCrédits par sortie
2K10
4K20

cURL

Génération d'images

Créer des jobs de texte vers image

Conversion d'images

Convertir des images en SVG, PPTX, PNG, PDF ou TIFF

Table des matières

Champs du formulaire
Crédits
cURL
JavaScript
Python
Dimensions de sortie
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.

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