LogoLogoDocumentation API
LogoLogoDocumentation API
Accueil
Vue d'ensembleAuthentification et idempotenceGénération d'imagesModification d'imagesConversion d'imagesJobs et attente bornéeCréditsErreursLimites de débit et concurrenceJournal des versions de l'API
Documentation API

Conversion d'images

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

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

Champs du formulaire

ChampTypeObligatoireDéfautRègles
imagefileoui—PNG, JPEG ou WebP ; 10 Mio et 40 millions de pixels décodés au maximum
formatstringoui—svg, pptx, png, pdf ou tiff
vector_modestringnoneditable_textSVG uniquement
dpistringnon300300, 600 ou 1000 ; PNG, PDF et TIFF uniquement

Les deux modes SVG

Les deux options SVG sont implémentées et disponibles via le même point de terminaison :

vector_modeRésultatCrédits
editable_textSVG au texte modifiable lorsque c'est possible10
full_vectorsortie SVG entièrement vectorisée15

Ces noms décrivent des capacités de sortie. L'acheminement des capacités est géré par SciDraw AI et ne fait pas partie du contrat public.

Modification d'images

Modifier une image envoyée à l'aide d'instructions en langage naturel

Jobs et attente bornée

Interroger le travail asynchrone et lire des résultats assainis

Table des matières

Champs du formulaire
Les deux modes SVG
Autres formats et crédits
cURL : SVG à texte modifiable
JavaScript
Python

Autres formats et crédits

FormatOptionCrédits
pptx—10
png, pdf, tiffdpi=3005
png, pdf, tiffdpi=60010
png, pdf, tiffdpi=100015

Envoyer full_vector pour un format autre que SVG, ou une DPI non par défaut pour SVG ou PPTX, renvoie 400 INVALID_REQUEST.

cURL : SVG à texte modifiable

curl https://sci-draw.com/api/v1/images/conversions \
  -H 'Authorization: Bearer sd_YOUR_KEY' \
  -H 'Idempotency-Key: figure-12-svg-editable' \
  -F 'image=@figure.png;type=image/png' \
  -F 'format=svg' \
  -F 'vector_mode=editable_text'

JavaScript

const form = new FormData();
form.set('image', file);
form.set('format', 'svg');
form.set('vector_mode', 'full_vector');
const response = await fetch('https://sci-draw.com/api/v1/images/conversions', {
  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/conversions",
        headers={"Authorization": f"Bearer {api_key}", "Idempotency-Key": str(uuid.uuid4())},
        files={"image": ("figure.png", image, "image/png")},
        data={"format": "svg", "vector_mode": "full_vector"},
    )

Utilisez vector_mode=full_vector pour la seconde capacité SVG. En cas de succès, result.files[0] du job indique format, mime_type et l'URL de téléchargement.