Vue d'ensemble

L'API REST de SciDraw AI fournit des points de terminaison stables et fondés sur des jobs pour la génération d'images, la modification d'images et la conversion de formats.

URL de base : https://sci-draw.com

Spécification lisible par machine : OpenAPI JSON · OpenAPI YAML

Ces deux fichiers décrivent la même API au format OpenAPI. Importez l'un ou l'autre dans Postman ou Insomnia et tous les points de terminaison sont préremplis ; donnez-le à un générateur de code et vous obtenez un client typé ; confiez-le à un agent IA et il peut appeler l'API sans que vous écriviez la requête à la main. Les deux formats sont interchangeables — prenez celui que votre outil accepte.

Démarrage rapide

1. Créez une clé API dans Paramètres → Clés API et ne sélectionnez que les portées dont votre intégration a besoin.
2. Envoyez la clé sous la forme Authorization: Bearer sd_....
3. Ajoutez un Idempotency-Key unique à chaque requête de création.
4. Conservez l'identifiant de job renvoyé et interrogez son URL Location jusqu'à succeeded, failed ou canceled.

curl https://sci-draw.com/api/v1/images/generations \
  -H 'Authorization: Bearer sd_YOUR_KEY' \
  -H 'Idempotency-Key: order-7842-figure-1' \
  -H 'Content-Type: application/json' \
  -d '{
    "prompt": "A clean scientific illustration of exosome biogenesis",
    "aspect_ratio": "16:9",
    "resolution": "2K",
    "count": 1
  }'

Une requête de création renvoie normalement 202 Accepted, un objet job, un en-tête Location et Retry-After: 2. Vous pouvez ajouter Prefer: wait=10 pour attendre jusqu'à dix secondes. Attendre ne change jamais la sémantique du job : le statut n'est 200 que si le job est déjà terminé, sinon il reste 202.

Points de terminaison

Toutes les réponses sont des enveloppes JSON. Chaque réponse porte un X-Request-Id ; indiquez cet identifiant lorsque vous contactez le support. Les seules références de fichiers renvoyées sont les URL de sortie et les identifiants de fichiers publics. L'acheminement des capacités est géré par SciDraw AI.