# SciFig API

Créez des illustrations scientifiques, des graphiques et des diagrammes de flux via HTTP, avec les mêmes moteurs, tarifs et crédits que le site SciFig.

Source : https://scifig.ai/fr/docs/api

## Démarrage rapide

- Créez une clé API dans [Paramètres → Développeur](/fr/app/settings?tab=developer). Les clés de génération exigent un abonnement actif ou un solde positif de crédits achetés en packs ; les clés de lecture seule fonctionnent avec tous les comptes.
- Envoyez une requête de création avec un `Idempotency-Key`. Avec `Prefer: wait=25`, la réponse attend jusqu’à 25 secondes et renvoie la tâche terminée si elle s’achève à temps.
- Si la tâche est encore `queued` ou `processing`, consultez `GET /jobs/{id}` toutes les quelques secondes, en respectant `Retry-After`, jusqu’à ce qu’elle soit `succeeded` ou `failed`.
- Téléchargez chaque résultat depuis son `download_url`, valable une heure, ou transmettez son `file_id` à un autre point d’accès.

```bash
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"}'
```

URL de base : `https://scifig.ai/api/v1`. Contrat lisible par machine : [OpenAPI JSON](https://scifig.ai/api/v1/openapi.json) et [OpenAPI YAML](https://scifig.ai/api/v1/openapi.yaml). Les assistants IA peuvent utiliser les mêmes fonctions via le [serveur MCP](/fr/mcp).

## Points d’accès

| Point d’accès | Fonction | Crédits |
| --- | --- | --- |
| POST /images/generations | Générer une illustration scientifique à partir d’une description | 50 / 75 / 100 |
| POST /images/edits | Modifier par instruction ou par zone, rendre le fond blanc, changer le rapport largeur/hauteur ou les couleurs, remplacer du texte | 50 / 75 / 100 ; zone ou texte 100 |
| POST /images/text-detections | Détecter le texte d’une image avant de le remplacer | 0 |
| POST /images/upscales | Agrandir en 2K, 4K ou 8K | 50 / 100 / 150 |
| POST /images/conversions | Vectorisation SVG ; export PNG, PDF, TIFF et PPTX | SVG 150 ; PNG, PDF, TIFF et PPTX gratuits |
| POST /charts/generations | Tracer un graphique à partir de données CSV, TSV ou Excel | 100 |
| POST /charts/edits | Modifier la version la plus récente d’un graphique | 100 |
| POST /flowcharts/generations | Dessiner un diagramme de flux en SVG | 100 |
| POST /flowcharts/edits | Modifier la version la plus récente d’un diagramme de flux | 100 |
| POST /files | Importer une image, un masque ou une pièce jointe | 0 |
| GET /files/{file_id} | Télécharger un fichier | 0 |
| GET /jobs/{id} | Consulter une tâche | 0 |
| GET /jobs | Lister les tâches récentes | 0 |
| GET /credits | Solde, offre et limites des tâches | 0 |
| GET /pricing | Tous les tarifs, sans authentification | 0 |
| GET /openapi.json | Description OpenAPI 3.1, sans authentification | 0 |
| GET /openapi.yaml | La même description en YAML, sans authentification | 0 |

Il n’existe ni webhooks, ni SDK, ni outils en ligne de commande : appelez directement les points d’accès depuis un serveur ou un script. L’API n’autorise pas les requêtes CORS depuis un navigateur.