API publique
API de figures scientifiques
Générez et modifiez des illustrations scientifiques, tracez des graphiques à partir de vos données et créez des diagrammes de flux via HTTP, avec les mêmes moteurs que le site SciFig.
Les mêmes crédits que sur le site : achetez-les une fois sur la page des tarifs et utilisez-les partout.
curl -X POST https://scifig.ai/api/v1/images/generations \
-H "Authorization: Bearer $SCIFIG_API_KEY" \
-H "Idempotency-Key: $(uuidgen)" \
-H "Prefer: wait=25" \
-H "Content-Type: application/json" \
-d '{"prompt": "Mitochondrial electron transport chain, labelled", "aspect_ratio": "4:3"}'Obtenir l’accès
- 1
Se connecter
Utilisez votre compte SciFig. Les clés de lecture seule fonctionnent avec tous les comptes ; les clés permettant de créer des figures exigent un abonnement actif ou un solde positif de crédits achetés en packs.
- 2
Créer une clé
Dans Paramètres → Développeur, choisissez la lecture seule ou la lecture et la génération, ainsi qu’une date d’expiration. La clé n’est affichée qu’une seule fois.
- 3
Appeler et attendre
Envoyez une requête avec un Idempotency-Key et
Prefer: wait=25, puis téléchargez les résultats ou consultez la tâche jusqu’à sa fin.
Ce que permet l’API
Génération d’images
POST /images/generations
Des illustrations scientifiques à partir d’une description, avec des styles, des palettes et jusqu’à trois images de référence.
Modification d’images
POST /images/edits
Modifiez une image par instruction ou dans une zone masquée : fond blanc, nouveau rapport largeur/hauteur, couleurs différentes ou remplacement du texte sur place.
Agrandissements
POST /images/upscales
Agrandissez vos images en 2K, 4K ou 8K pour l’impression.
Conversions
POST /images/conversions
SVG modifiable par vectorisation ; export PNG, PDF, TIFF et PPTX à 300–1000 DPI, y compris pour les diagrammes de flux.
Graphiques
POST /charts/generations
Des graphiques prêts à publier à partir de CSV ou d’Excel, dans le style de revues scientifiques, puis des modifications ultérieures.
Organigrammes
POST /flowcharts/generations
Des diagrammes CONSORT, des flux de travail et des chaînes de traitement en SVG modifiable, puis des modifications ultérieures.
Fichiers
POST /files · GET /files/{id}
Importez des images, des masques et des pièces jointes ; téléchargez chaque résultat grâce à un lien signé.
Tâches et crédits
GET /jobs/{id} · GET /credits
Le statut, les résultats et le nombre exact de crédits réservés, facturés et remboursés.
Vous travaillez dans un assistant IA ?
Connectez Claude, ChatGPT, Claude Code, Codex ou Cursor au serveur MCP de SciFig. Claude, ChatGPT, Claude Code et Codex se connectent avec votre compte SciFig ; Cursor utilise une clé API.
Le coût de chaque appel
| Operation | Credits |
|---|---|
| Génération d’image | 50 / 75 / 100 (standard / advanced / premium) |
| Modification d’image | 50 / 75 / 100 ; zone ou texte 100 |
| Détection de texte | Gratuit |
| Agrandissement | 50 / 100 / 150 (2K / 4K / 8K) |
| Conversion | SVG 150 ; PNG, PDF, TIFF et PPTX gratuits |
| Création ou modification de graphique | 100 |
| Création ou modification de diagramme de flux | 100 |
| Consultation des tâches, fichiers, crédits et tarifs | Gratuit |
Les crédits sont réservés au démarrage d’une tâche, facturés une seule fois en cas de réussite et intégralement rendus en cas d’échec. Tous les tarifs.
Limites
20
requêtes de création par minute et par clé
40
requêtes de création par minute et par compte
120
requêtes de lecture par minute et par clé
30 s
attente maximale par requête
200
conversions matricielles gratuites par jour
Le nombre de tâches simultanées et de tâches par heure dépend de votre offre et est partagé avec le site. Une réponse 429 contient Retry-After : attendez, puis réessayez avec le même Idempotency-Key.
Questions
Ai-je besoin d’une offre payante ?+
Les clés de lecture seule fonctionnent avec tous les comptes. Les clés de création de figures exigent un abonnement actif ou un solde positif de crédits achetés en packs, car chaque création consomme des crédits.
Les crédits de l’API sont-ils distincts de ceux du site ?+
Non. Le site, l’API et le serveur MCP partagent un seul solde et une seule grille tarifaire.
Que se passe-t-il si une tâche échoue ?+
Les crédits réservés sont intégralement rendus. Une illustration ayant dépassé le délai peut encore être livrée gratuitement dans les 24 heures ; la tâche indique jusqu’à quand.
Mes résultats apparaissent-ils sur le site ?+
Oui. Les graphiques et diagrammes de flux apparaissent sous forme de conversations dans leurs espaces de travail, où vous pouvez poursuivre leur modification. Leurs résultats contiennent une editor_url permettant de les y ouvrir. Les liens de téléchargement des réponses API sont valables une heure ; consultez à nouveau la tâche pour en obtenir un nouveau.
Existe-t-il un mode de test ?+
Non. Les appels en lecture seule et les conversions PNG, PDF, TIFF et PPTX sont gratuits : vous pouvez donc mettre en place l’essentiel d’une intégration sans dépenser de crédits.
Puis-je obtenir des limites plus élevées ?+
Écrivez-nous via la page de contact en indiquant le volume prévu.
Commencez avec la requête ci-dessus
Créez une clé, collez la commande cURL dans un terminal et votre figure sera prête en une minute environ.