API
OpenAPI-Spezifikation (Swagger)
OpenAPI-3.1-Spezifikation der SovrGPT-API: maschinenlesbar, importierbar in Swagger UI, Redoc, Postman, Insomnia und Code-Generatoren für Client-SDKs.
Die SovrGPT-API liegt als OpenAPI-3.1-Spezifikation vor. Sie importieren sie in gängige Werkzeuge oder erzeugen daraus Client-SDKs.
Spezifikation: https://sovrgpt.com/openapi.json
Verwenden
- Swagger UI / Swagger Editor: editor.swagger.io öffnen →
File → Import URL →
https://sovrgpt.com/openapi.json. - Redoc:
npx @redocly/cli preview-docs https://sovrgpt.com/openapi.json. - Postman / Insomnia: Import → Link → URL einfügen. Sie erhalten eine Sammlung mit allen Endpunkten.
- Client-SDKs generieren:
openapi-generator,openapi-typescriptu. a. lesen die Datei direkt.
Enthaltene Endpunkte
Die Pfade sind relativ zur Basis-URL https://sovrgpt.com/api/v1.
| Endpunkt | Zweck | Scope |
|---|---|---|
GET /models | Verfügbare Modelle abfragen (Chat, Embeddings, Rerank, TTS, STT, Entscheidungen) | – |
GET /me | Rechte des aufrufenden Schlüssels | – |
POST /chat/completions | Chat-Completion | chat |
POST /embeddings | Text-Embeddings | embeddings |
POST /rerank | Relevanz-Neuordnung | rerank |
POST /audio/speech | Text-to-Speech (Stimmenkatalog, Supertonic, CosyVoice) | speech |
GET /audio/voices, GET /audio/voices/design-options | Stimmenkatalog, Sprecherkartei | – |
/audio/voices/designs mit /{id}, /{id}/adopt, /suggest | Eigene Stimmen entwerfen, prüfen, übernehmen | speech |
POST /audio/transcriptions | Speech-to-Text (Voxtral) | transcribe |
POST /audio/uploads | Upload-Ticket für große Audiodateien | transcribe |
POST /decisions | Entscheidung anfragen | decisions |
GET /decisions/presets, GET /decisions/models | Fragenpakete, Entscheidungsmodelle | – |
Die MCP-Endpunkte (/mcp/mcp, /mcp/docs/mcp) stehen nicht in der Spezifikation, siehe
MCP-Server.
Die Spezifikation ist die maschinenlesbare Referenz. Erklärte Beispiele stehen auf den Doku-Seiten zu Chat, Modellen, Audio und Entscheidungen.