<!--
Source: https://swappr.fr
Canonical: https://swappr.fr/llm/api-docs.md
Last-updated: 2026-07-09
-->

# Swappr — API documentation

**TL;DR** : l'API REST publique Swappr permet de lire le profil/crédits, uploader des références, lancer des générations image/vidéo/audio, suivre les jobs et lire la bibliothèque.

Base URL : `https://swappr.fr/api/v1`
Auth : `Authorization: Bearer sk_swp_<24 chars>`

## Endpoints essentiels

| Method | Path | Description |
|---|---|---|
| GET | /me | Profil, crédits et abonnement |
| GET | /credits/balance | Solde crédits |
| GET | /studio/models | Catalogue modèles |
| POST | /uploads | Upload image de référence |
| POST | /studio/image/generate | Génération image async |
| POST | /studio/video/generate | Génération vidéo async |
| POST | /faceswap/generate | Face Swap async |
| GET | /jobs/{id} | Statut et outputs |
| GET | /library/items | Bibliothèque |

Documentation complète HTML : https://swappr.fr/api-docs
OpenAPI : https://swappr.fr/openapi.yaml