# SciFig API

Erstellen Sie wissenschaftliche Illustrationen, Diagramme und Flussdiagramme über HTTP, mit denselben Engines, Preisen und Credits wie auf der SciFig-Website.

Quelle: https://scifig.ai/de/docs/api

## Schnellstart

- Erstellen Sie unter [Einstellungen → Entwickler](/de/app/settings?tab=developer) einen API-Schlüssel. Generierungsschlüssel erfordern ein aktives Abonnement oder ein positives Guthaben aus Credit-Paketen; Leseschlüssel funktionieren mit jedem Konto.
- Senden Sie eine Erstellungsanfrage mit einem `Idempotency-Key`. Mit `Prefer: wait=25` wartet die Antwort bis zu 25 Sekunden und gibt den abgeschlossenen Auftrag zurück, sofern er rechtzeitig fertig wird.
- Wenn der Auftrag noch `queued` oder `processing` ist, fragen Sie alle paar Sekunden `GET /jobs/{id}` ab, bis er `succeeded` oder `failed` ist. Beachten Sie dabei `Retry-After`.
- Laden Sie jedes Ergebnis über seine `download_url` herunter, die eine Stunde gilt, oder übergeben Sie seine `file_id` an einen anderen Endpunkt.

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

Basis-URL: `https://scifig.ai/api/v1`. Maschinenlesbarer Vertrag: [OpenAPI JSON](https://scifig.ai/api/v1/openapi.json) und [OpenAPI YAML](https://scifig.ai/api/v1/openapi.yaml). KI-Assistenten können dieselben Funktionen über den [MCP-Server](/de/mcp) nutzen.

## Endpunkte

| Endpunkt | Funktion | Credits |
| --- | --- | --- |
| POST /images/generations | Wissenschaftliche Illustration aus einer Beschreibung erstellen | 50 / 75 / 100 |
| POST /images/edits | Per Anweisung oder Bereich bearbeiten, Hintergrund weiß färben, Seitenverhältnis ändern, umfärben, Text ersetzen | 50 / 75 / 100; Bereich oder Text 100 |
| POST /images/text-detections | Text in einem Bild vor dem Ersetzen erkennen | 0 |
| POST /images/upscales | Auf 2K, 4K oder 8K vergrößern | 50 / 100 / 150 |
| POST /images/conversions | SVG-Vektorisierung; Export als PNG, PDF, TIFF und PPTX | SVG 150; PNG, PDF, TIFF und PPTX kostenlos |
| POST /charts/generations | Diagramm aus CSV-, TSV- oder Excel-Daten erstellen | 100 |
| POST /charts/edits | Neueste Version eines Diagramms ändern | 100 |
| POST /flowcharts/generations | Flussdiagramm als SVG erstellen | 100 |
| POST /flowcharts/edits | Neueste Version eines Flussdiagramms ändern | 100 |
| POST /files | Bild, Maske oder Anhang hochladen | 0 |
| GET /files/{file_id} | Datei herunterladen | 0 |
| GET /jobs/{id} | Einen Auftrag abfragen | 0 |
| GET /jobs | Neueste Aufträge auflisten | 0 |
| GET /credits | Guthaben, Tarif und Aufgabenlimits | 0 |
| GET /pricing | Alle Preise ohne Authentifizierung | 0 |
| GET /openapi.json | OpenAPI-3.1-Beschreibung ohne Authentifizierung | 0 |
| GET /openapi.yaml | Dieselbe Beschreibung als YAML ohne Authentifizierung | 0 |

Es gibt keine Webhooks, SDKs oder Befehlszeilenwerkzeuge: Rufen Sie die Endpunkte direkt von einem Server oder Skript auf. Die API erlaubt keine CORS-Anfragen aus dem Browser.
