Passer au contenu principal
Tout ce qui a changé dans l’API REST, le MCP server et l’API de vérification de contenu. Les dates correspondent à la mise en production.
apimcpvideoimages

Moteur vidéo Kling 4.0 et vectorisation Ideogram

  • Kling 4.0 — nouveau moteur vidéo kling_4_0 sur POST /videos/generations, dans GET /videos/models et sur l’outil MCP generate_video. Les trois modes : image_to_video (avec une image de fin optionnelle), text_to_video et text_to_video_styled.
  • Durées — chaque seconde entière de 3 à 30. L’outil MCP utilise 5 si tu omets duration ; l’API REST l’exige, comme pour chaque moteur.
  • Résolution et format — 720p (par défaut) ou 1080p ; 16:9, 9:16 ou 1:1. En image_to_video, la vidéo suit le cadrage de l’image de départ.
  • Audio — une bande son est toujours générée, sans coût supplémentaire.
  • Credits — 15 par seconde en 720p, 25 par seconde en 1080p (un clip de 5 s coûte 75 / 125). text_to_video_styled ajoute le forfait habituel de 10.
  • Moteurs de vectorisation — POST /images/vectorizations et l’outil MCP vectorize_image ont un nouveau champ optionnel engine : recraft (par défaut) ou ideogram. Avec ideogram, le mode optionnel est default (détaillé) ou simple. Une requête sans engine fonctionne comme avant. Une valeur inconnue, ou un mode sans ideogram, renvoie 422 avant tout débit.
  • Credits de vectorisation — toujours 5 pour chaque moteur et chaque mode. Un résultat en cache (0 credit) ne compte désormais que s’il vient du même moteur et du même mode.
Kling 4.0 · Vectoriser une image · Tarification · Outils MCP
apimcpimages

Téléversement d’images, moteurs Magic Edit et statut de job terminal

  • Téléversement d’images — nouveau. Téléverse un fichier image local et obtiens un image_id en trois étapes : POST /images/uploads/prepare (envoie la size_bytes exacte) → PUT du fichier vers l’upload_url presignée (valable 1 heure) → POST /images/uploads/{image_id}/complete. JPEG, PNG ou WebP ; jusqu’à 10 Mo et 32 MP ; au plus 20 uploads en attente de finalisation par utilisateur. Gratuit. Requiert l’un de images.edit, images.transform ou videos.generate — aucun nouveau scope. L’image_id sert de source pour les éditions, les opérations d’images et l’image-to-video.
  • MCP — deux nouveaux outils gratuits, prepare_image_upload et complete_image_upload, font la même chose. Le server a désormais dix-huit outils.
  • Moteurs Magic Edit — POST /images/edits et l’outil MCP edit_image acceptent désormais aussi nano_banana_2 et nano_banana_2_1, en plus de nano_banana_pro (par défaut), gemini et kontext. resolution (1K / 2K / 4K) fonctionne sur les trois moteurs Nano Banana, à 5 / 10 / 20 credits par output ; gemini et kontext restent à une résolution fixe et 5 credits.
  • MCP edit_image — nouveaux paramètres optionnels resolution et num_images. Avant, les éditions MCP tournaient toujours en 1K.
  • Réponse d’édition — le 202 renvoie désormais en écho le engine et la resolution effectifs.
  • Changement de comportement : modèles entraînés avec un autre moteur — les modèles entraînés et une palette de couleurs dans une édition ne fonctionnent qu’avec nano_banana_pro. Une requête qui nomme un autre moteur avec eux renvoie désormais 422 avant tout débit. Avant, une telle requête basculait silencieusement sur nano_banana_pro.
  • Statut de job terminal pour les blocages compliance — un job d’image dont tous les outputs ont échoué dans le pipeline de conformité (par exemple la signature C2PA) se termine désormais en failed avec error delivery_blocked_compliance: <codes>, au lieu de rester processing. Un job avec certains outputs livrables est completed et liste les autres dans le nouveau champ blocked_images. Cela s’applique aux GET de job REST et à l’outil MCP get_job_status.
  • Outputs 4K — la signature C2PA des grands outputs (4K) fonctionne de nouveau, donc les images 4K sont de nouveau livrées.
Téléversement d’images · Édition d’images · Blocages compliance · Outils MCP
apimcpimages

Moteurs text-to-image

POST /images/generations et l’outil MCP generate_image acceptent désormais sept moteurs text-to-image. Le moteur par défaut reste nano_banana_pro ; une requête sans engine se comporte comme avant.
  • Moteurs — nano_banana_pro (par défaut), nano_banana_2_1, nano_banana_2, et nouveaux : nano_banana, imagen_4, seedream_4, flux_1_pro. Chaque moteur a ses propres ratios et résolutions, validés avant toute facturation (422).
  • GET /images/models — nouveau. Liste les moteurs que tu peux utiliser, avec ratios, résolutions, limite de num_outputs, credits par image et prise en charge des modèles entraînés. Gratuit, scope images.generate.
  • MCP — generate_image a un nouveau paramètre optionnel engine. Cela remplace la note précédente selon laquelle generate_image utilise toujours le moteur par défaut. Le nouvel outil gratuit list_image_engines renvoie le même contenu que GET /images/models.
  • Modèles entraînés et palettes fonctionnent avec nano_banana_pro, nano_banana_2_1 et nano_banana_2. Sur les autres moteurs, ils renvoient 422 — jamais ignorés.
  • Credits identiques sur chaque moteur : 5 par output en 1K, ×2 en 2K, ×4 en 4K.
  • Changement de comportement pour les organisations limitées aux modèles entraînés — elles reçoivent une liste de moteurs vide (unavailable_reason: "organization_restricted"), tout engine renvoie 422, et une requête doit omettre engine et passer au moins un modèle entraîné ou une palette.
Génération d’images · Lister les moteurs d’image · Outils MCP
apimcpimages

Nano Banana 2.1

Un nouveau moteur d’images, nano_banana_2_1 (Nano Banana 2.1), est disponible à côté de nano_banana_pro et nano_banana_2.
  • POST /images/generations et POST /images/img2img acceptent engine: "nano_banana_2_1". Le moteur par défaut reste nano_banana_pro.
  • MCP — l’outil img2img accepte engine: "nano_banana_2_1". À cette version, generate_image n’avait pas de paramètre engine et utilisait toujours le défaut ; il en a un désormais (voir Moteurs text-to-image plus haut).
  • Mêmes ratios que nano_banana_2 (img2img autorise en plus 4:1, 1:4, 8:1, 1:8), résolutions 1K, 2K et 4K, et jusqu’à 14 sources img2img.
  • Mêmes credits que nano_banana_2 : 5 par output en 1K, ×2 en 2K, ×4 en 4K.
  • Non disponible pour Magic Edit (POST /images/edits) ni pour l’outil MCP edit_image — les deux renvoient 422.
Génération d’images · Transformer des images (img2img)
apimcpimages

Opérations d’images

Six façons de transformer une image que tu as déjà, chacune un POST asynchrone qui soumet un job plus un GET qui l’interroge.
  • POST /images/img2img · GET /images/img2img/{img2img_id} — transforme 1 à 14 images sources avec un prompt.
  • POST /images/variations · GET /images/variations/{variation_id} — variations créatives d’une image, ciblées sur l’ensemble, une personne, un objet ou la scène.
  • POST /images/resizes · GET /images/resizes/{resize_id} — change le format par outpainting plutôt que par recadrage.
  • POST /images/upscales · GET /images/upscales/{upscale_id} — passe à une résolution supérieure avec quatre modèles.
  • POST /images/background-removals · GET /images/background-removals/{background_removal_id} — détoure l’arrière-plan en PNG transparent.
  • POST /images/vectorizations · GET /images/vectorizations/{vectorization_id} — vectorise une image en SVG.
Nouveau scope. Variations, redimensionnements, upscalings, suppressions d’arrière-plan et vectorisations exigent images.transform. Img2img reste sous images.edit. Les clés créées avec tous les scopes le possèdent déjà ; pour une clé restreinte, ajoute-le dans Settings → API Keys.Aussi en MCP. Les mêmes six opérations existent comme outils img2img, create_variations, resize_image, upscale_image, remove_background et vectorize_image.Tarification. La suppression d’arrière-plan coûte 1 credit et la vectorisation 5, toutes deux 0 en cas de cache hit sur une source déjà traitée. Le reste est facturé 5 × résolution × sorties ; l’upscaling au palier cible multiplié par un coefficient propre au modèle. Opérations d’images · Tarification
content-verification

Décodage hébergé des filigranes d’image

L’API de vérification de contenu décode désormais elle-même les deux techniques de filigrane d’image, au lieu de les signaler comme non vérifiées.
  • TrustMark Q — le corpus historique, couvrant les images marquées à l’époque où TrustMark était le fournisseur d’incrustation. Cette voie reste disponible en permanence pour ce corpus.
  • Meta PixelSeal — le filigrane d’image actuel que portent les nouvelles images générées par Samsa.
Les filigranes restent une corroboration : le verdict detected provient toujours de la vérification du manifeste C2PA, qui fait autorité. Le décodage du filigrane vidéo (Meta Video Seal) n’est pas encore disponible et est signalé not_checked — une technique jamais évaluée, jamais un faux négatif. Vérification de contenu
content-verification

API de vérification de contenu

Une API gratuite et sans authentification pour vérifier si une image ou une vidéo a été faite avec Samsa — le mécanisme public de détection de Samsa au titre de l’article 50(2) du règlement européen sur l’IA. Elle a sa propre URL de base, ne demande aucune clé API et ne consomme aucun credit.
  • POST /v1/public/detect — vérifie une image ou une vidéo téléversée.
  • GET /v1/public/detect/info — description lisible par machine de chaque technique de marquage et de sa détection.
  • GET /v1/public/detect/result/{request_id} — PDF signé d’un résultat passé.
  • GET /v1/public/detect/health — état du service et version.
Vérification de contenu
mcp

Modèles entraînés par nom, palettes et aperçus intégrés

Trois changements qui rendent les outils MCP plus faciles à piloter depuis une conversation, où le nom d’un modèle est sous la main mais pas son id.
  • Les noms fonctionnent comme les ids. style_id, object_ids, person_ids et setting_ids acceptent le nom ou l’id d’un modèle entraîné ; un nom se résout vers un modèle visible par la credential connectée.
  • color_palette — un nouveau paramètre sur generate_image et edit_image, donné lui aussi par nom ou par id.
  • edit_image atteint la parité avec generate_image et accepte les quatre paramètres de référence de modèles entraînés, pour que l’édition reste fidèle à la marque.
  • get_job_status renvoie un aperçu. Un job d’image matricielle terminé porte désormais une image réduite intégrée à côté du lien vers l’asset pleine résolution, pour que les clients affichent le résultat directement. La vectorisation renvoie du SVG et n’a pas d’aperçu matriciel.
MCP server
apimcplaunch

L’API publique Samsa et le MCP server

La première version publique. Le studio d’images et de vidéos de Samsa — et les modèles entraînés de ton organisation — via une API REST et un MCP server distant.
  • Images — POST /images/generations et POST /images/edits, en composant les modèles style, objet, personne et décor entraînés de ton organisation.
  • Vidéo — POST /videos/generations depuis une image de départ, depuis du texte, ou depuis du texte stylisé avec tes modèles, plus GET /videos/models pour la liste des moteurs.
  • Entraînement de modèles — POST /models, POST /models/prepare, POST /models/{model_id}/complete et GET /models/{model_id}/status.
  • Modèles — lister, récupérer, mettre à jour et supprimer sous /models.
  • Compte — GET /me, GET /credits et GET /usage.
Clés API d’organisation. Avec scopes, affichées une seule fois à la création, et agissant pour l’organisation de la clé — les credits viennent de son pool.Webhooks. Passe un webhook_url pour être notifié à la fin plutôt que d’interroger. Les callbacks sont signés et les échecs sont réessayés à 5s, 30s, 2m, 15m et 1h.MCP server. Un serveur distant en Streamable HTTP sur https://api.samsa.ai/mcp, acceptant soit OAuth 2.1 pour les clients interactifs comme Claude et ChatGPT, soit une clé API pour les clients headless. API Samsa · Quickstart · MCP server