Base URL — tous les endpoints REST vivent sous
Commence ici
Quickstart
Crée une clé et génère ta première image en cinq étapes, avec du curl, du
Python et du TypeScript prêts à copier-coller.
Référence API
La base URL, l’authentification et les conventions communes à chaque endpoint.
Créer une API key
Les clés appartiennent à l’organisation, sont scopées et affichées une seule
fois. Un admin de l’org les crée dans tes paramètres Samsa.
MCP server
Connecte Samsa à ChatGPT, Claude ou n’importe quel client MCP via OAuth ou une
API key.
Ce que tu peux construire
Génération d'images
Transforme un prompt en images, en composant éventuellement les modèles
style, objet, personne et décor entraînés de ton organisation
ainsi que des palettes de couleurs.
Magic Edit
Édite une image existante à partir d’un prompt — avec ou sans masque — et
réutilise les mêmes modèles entraînés pour des résultats fidèles à ta marque.
Génération de vidéos
Produis de la vidéo à partir d’une image de départ (avec une image de fin
optionnelle), à partir de texte, ou à partir de texte stylisé avec tes modèles
entraînés.
Entraînement de modèles
Crée des modèles personnalisés dans quatre catégories — style, objet, personne
et décor — à partir d’une poignée d’images de référence.
POST renvoie
202 Accepted avec un id de job, tu interroges le endpoint GET correspondant
pour connaître le statut, et — une fois le job completed — la réponse contient
les presigned URLs vers les assets terminés. Tu peux aussi passer un webhook_url
pour être notifié à la fin plutôt que d’interroger en boucle.
Authentification
Envoie ta clé comme bearer token sur chaque requête :images.generate, images.edit,
videos.generate, models.read, models.write, usage.read) et agissent pour
l’organisation de la clé — les credits sont prélevés sur le pool de cette
organisation et les assets générés apparaissent dans l’app sous le compte du
créateur de la clé. Consulte le quickstart pour créer ta
première clé.
Model Context Protocol (MCP)
Samsa expose aussi un MCP server distant afin que les clients agentiques puissent générer et éditer des médias sous forme d’outils :Authorization: Bearer <api key> pour les clients headless
comme les scripts et n8n. Consulte le guide MCP server pour le
catalogue d’outils et la configuration par client.
Credits et tarification
Les actions de l’API puisent dans le pool de credits Samsa existant de ton organisation aux mêmes tarifs que l’app — par exemple, la génération d’images coûte5 credits par output en 1K, mis à l’échelle selon la résolution (1K
×1, 2K ×2, 4K ×4). Quand le pool est épuisé, les requêtes renvoient 402.
Consulte ton solde à tout moment avec GET /credits ou GET /me.