{
"error": {
"type": "authentication_error",
"code": "invalid_api_key",
"message": "The provided API key is invalid, expired, or revoked.",
"request_id": "8f14e45fceea167a5a36dedd4bea2543",
"param": "aspect_ratio"
}
}
{
"error": {
"type": "authentication_error",
"code": "invalid_api_key",
"message": "The provided API key is invalid, expired, or revoked.",
"request_id": "8f14e45fceea167a5a36dedd4bea2543",
"param": "aspect_ratio"
}
}
{
"error": {
"type": "authentication_error",
"code": "invalid_api_key",
"message": "The provided API key is invalid, expired, or revoked.",
"request_id": "8f14e45fceea167a5a36dedd4bea2543",
"param": "aspect_ratio"
}
}
{
"error": {
"type": "authentication_error",
"code": "invalid_api_key",
"message": "The provided API key is invalid, expired, or revoked.",
"request_id": "8f14e45fceea167a5a36dedd4bea2543",
"param": "aspect_ratio"
}
}
{
"error": {
"type": "authentication_error",
"code": "invalid_api_key",
"message": "The provided API key is invalid, expired, or revoked.",
"request_id": "8f14e45fceea167a5a36dedd4bea2543",
"param": "aspect_ratio"
}
}
{
"error": {
"type": "authentication_error",
"code": "invalid_api_key",
"message": "The provided API key is invalid, expired, or revoked.",
"request_id": "8f14e45fceea167a5a36dedd4bea2543",
"param": "aspect_ratio"
}
}
Récupère le statut d’un job de suppression d’arrière-plan. Tant qu’il est pending
ou processing, continue d’interroger ; une fois completed, la réponse porte un
seul objet résultat image — un PNG transparent avec une presigned url valable
24 heures. Un job en hit de cache naît completed avec son résultat déjà
attaché. Seuls les jobs créés par ton organisation sont visibles ; tout autre id
renvoie 404 not_found. Requiert le scope
images.transform.
Exemple : job terminé
L’image est un objet résultat de format dérivé ; pour la suppression
d’arrière-plan, model, width et height sont toujours null. Cet exemple est un
hit de cache, donc credits_used vaut 0 (un miss normal affiche 1) :
Passe un webhook_url sur la
requête de suppression d’arrière-plan
d’origine pour recevoir un callback signé au lieu d’interroger — sur un hit de
cache, l’événement completed se déclenche immédiatement. Voir
Webhooks.
Autorisations
Authorization
string
header
requis
Organization API key (Authorization: Bearer samsa_sk_...) or OAuth 2.1 access token (Authorization: Bearer samsa_at_...).
Paramètres de chemin
background_removal_id
string<uuid>
requis
Réponse
Successful Response
GET /images/background-removals/{id} body (SAM-820 / S8.8 — ADR §7.2).
The standard async-job envelope plus ONE nullable image result object (an
image_formats derivative — a transparent PNG — built by the S8.2 egress
builder; model/width/height are always null for background removal).
created_at is the job's submit time from the credit ledger (the
image_generation_tasks table has no created_at column). A cache-hit job is
born completed with a frozen result; a normal job progresses
pending → processing → completed/failed.
id
string<uuid>
requis
status
enum<string>
requis
pending, processing, completed, failed, or cancelled.
Options disponibles:
pending,
processing,
completed,
failed,
cancelled
Exemple:
"completed"
created_at
string<date-time>
requis
When the job was submitted.
credits_used
integer | null
Net credits charged for this job, after any refunds (0 for a cache hit).
Exemple:
1
image
PublicImageFormatResult · object | null
The produced transparent PNG (presigned URL); null until completed.
Show child attributes
error
string | null
Failure detail when status is failed; otherwise null.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Samsa","description":"Developer documentation for the Samsa public API — image generation with trained models, Magic Edit, video generation, model training, and the MCP server.","colors":{"primary":"#15123A","light":"#F3F0EA","dark":"#15123A"},"logo":{"light":"https://mintcdn.com/samsa-6b52d36f/KpPcBLFywFmPfDV-/logo/light.svg?fit=max\u0026auto=format\u0026n=KpPcBLFywFmPfDV-\u0026q=85\u0026s=7959ddf7b4b354d12d95c8cdd42b4c61","dark":"https://mintcdn.com/samsa-6b52d36f/KpPcBLFywFmPfDV-/logo/dark.svg?fit=max\u0026auto=format\u0026n=KpPcBLFywFmPfDV-\u0026q=85\u0026s=74213957254837206e4bb0ce9e2096b6","href":"https://samsa.ai"},"favicon":"https://mintcdn.com/samsa-6b52d36f/KpPcBLFywFmPfDV-/favicon.svg?fit=max\u0026auto=format\u0026n=KpPcBLFywFmPfDV-\u0026q=85\u0026s=24292e198dbc5bbc4dcbc1a41e807c52","appearance":{"default":"system"},"navbar":{"links":[{"href":"mailto:support@samsa.ai","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.samsa.ai"}},"seo":{"organization":{"id":"https://samsa.ai/#organization","name":"Samsa","legalName":"Samsa Labs AG","url":"https://samsa.ai","logo":"https://samsa.ai/wp-content/uploads/2026/01/samsa_logo.webp","sameAs":["https://www.linkedin.com/company/samsa-ai/"]}},"contextual":{"options":["copy","chatgpt","claude","cursor","vscode",{"title":"Connect to Microsoft Copilot","description":"Install MCP Server in Microsoft Copilot","icon":"microsoft","href":"https://docs.samsa.ai/mcp-server/clients"}],"display":"header"},"thumbnails":{"appearance":"dark","background":"https://mintcdn.com/samsa-6b52d36f/KpPcBLFywFmPfDV-/images/thumbnail-world.webp?fit=max\u0026auto=format\u0026n=KpPcBLFywFmPfDV-\u0026q=85\u0026s=ad0e6f187da0ece3388c05736841babd"},"styling":{"latex":false},"navigation":{"languages":[{"language":"en","default":true,"footer":{"socials":{"linkedin":"https://www.linkedin.com/company/samsa-ai","website":"https://samsa.ai"},"links":[{"header":"Information","items":[{"label":"Docs home","href":"/"},{"label":"Changelog","href":"/changelog"},{"label":"Dashboard","href":"https://app.samsa.ai"},{"label":"Pricing","href":"https://samsa.ai/pricing"},{"label":"Contact us","href":"https://samsa.ai/contact"}]},{"header":"Legal","items":[{"label":"Terms of Service","href":"https://samsa.ai/terms-of-service"},{"label":"Acceptable Use Policy","href":"https://samsa.ai/acceptable-use-policy"},{"label":"Privacy Policy","href":"https://samsa.ai/privacy-policy"},{"label":"Imprint","href":"https://samsa.ai/imprint"}]}]},"href":""},{"language":"de","footer":{"socials":{"linkedin":"https://www.linkedin.com/company/samsa-ai","website":"https://samsa.ai"},"links":[{"header":"Informationen","items":[{"label":"Doku-Startseite","href":"/de"},{"label":"Changelog","href":"/de/changelog"},{"label":"Dashboard","href":"https://app.samsa.ai"},{"label":"Preise","href":"https://samsa.ai/de/preise"},{"label":"Kontakt","href":"https://samsa.ai/de/kontakt"}]},{"header":"Rechtliches","items":[{"label":"AGB","href":"https://samsa.ai/de/agb"},{"label":"Nutzungsrichtlinie","href":"https://samsa.ai/de/nutzungsrichtlinie"},{"label":"Datenschutz","href":"https://samsa.ai/de/datenschutz"},{"label":"Impressum","href":"https://samsa.ai/de/impressum"}]}]},"href":"de"},{"language":"fr","footer":{"socials":{"linkedin":"https://www.linkedin.com/company/samsa-ai","website":"https://samsa.ai"},"links":[{"header":"Informations","items":[{"label":"Accueil documentation","href":"/fr"},{"label":"Changelog","href":"/fr/changelog"},{"label":"Dashboard","href":"https://app.samsa.ai"},{"label":"Tarifs","href":"https://samsa.ai/fr/prix"},{"label":"Contact","href":"https://samsa.ai/fr/contact"}]},{"header":"Légal","items":[{"label":"Conditions générales","href":"https://samsa.ai/fr/conditions-generales"},{"label":"Politique d'utilisation acceptable","href":"https://samsa.ai/fr/politique-utilisation-acceptable"},{"label":"Politique de confidentialité","href":"https://samsa.ai/fr/politique-de-confidentialite"},{"label":"Mentions légales","href":"https://samsa.ai/fr/mentions-legales"}]}]},"href":"fr"},{"language":"it","footer":{"socials":{"linkedin":"https://www.linkedin.com/company/samsa-ai","website":"https://samsa.ai"},"links":[{"header":"Informazioni","items":[{"label":"Home documentazione","href":"/it"},{"label":"Changelog","href":"/it/changelog"},{"label":"Dashboard","href":"https://app.samsa.ai"},{"label":"Prezzi","href":"https://samsa.ai/it/prezzi"},{"label":"Contatti","href":"https://samsa.ai/it/contatto"}]},{"header":"Legale","items":[{"label":"Termini e condizioni","href":"https://samsa.ai/it/termini-e-condizioni"},{"label":"Politica di utilizzo accettabile","href":"https://samsa.ai/it/politica-utilizzo-accettabile"},{"label":"Informativa sulla privacy","href":"https://samsa.ai/it/informativa-sulla-privacy"},{"label":"Note legali","href":"https://samsa.ai/it/impronta"}]}]},"href":"it"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"samsa-6b52d36f","hasAudioNarration":false,"actualSubdomain":"samsa-6b52d36f","customDomains":["docs.samsa.ai"],"gitSource":{"type":"github","owner":"samsa-ai","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"agentFeedback":true,"thumbs":false},"entitlements":{},"buildId":"6ae19d13f8179dd80879abc1","clientVersion":"0.0.4205","searchFilterCounts":[{"language":"en","tag":"API reference","count":45},{"language":"de","tag":"API-Referenz","count":45},{"language":"fr","tag":"Référence API","count":45},{"language":"it","tag":"Riferimento API","count":45},{"language":"en","tag":"Endpoints","count":43},{"language":"de","tag":"Endpunkte","count":43},{"language":"fr","tag":"Points de terminaison","count":43},{"language":"it","tag":"Endpoint","count":43},{"language":"en","tag":"Image Operations","count":13},{"language":"de","tag":"Bildoperationen","count":13},{"language":"fr","tag":"Opérations d'images","count":13},{"language":"it","tag":"Operazioni sulle immagini","count":13},{"language":"en","tag":"Documentation","count":9},{"language":"de","tag":"Dokumentation","count":9},{"language":"fr","tag":"Documentation","count":9},{"language":"it","tag":"Documentazione","count":9},{"language":"en","tag":"Guides","count":7},{"language":"de","tag":"Leitfäden","count":7},{"language":"fr","tag":"Guides","count":7},{"language":"it","tag":"Guide","count":7},{"language":"en","tag":"Model Training","count":5},{"language":"en","tag":"Models","count":5},{"language":"de","tag":"Modelltraining","count":5},{"language":"de","tag":"Modelle","count":5},{"language":"fr","tag":"Entraînement de modèles","count":5},{"language":"fr","tag":"Modèles","count":5},{"language":"it","tag":"Addestramento di modelli","count":5},{"language":"it","tag":"Modelli","count":5},{"language":"en","tag":"Account \u0026 Usage","count":4},{"language":"en","tag":"Image Generation","count":4},{"language":"en","tag":"Video Generation","count":4},{"language":"de","tag":"Konto \u0026 Nutzung","count":4},{"language":"de","tag":"Bildgenerierung","count":4},{"language":"de","tag":"Videogenerierung","count":4},{"language":"fr","tag":"Compte \u0026 utilisation","count":4},{"language":"fr","tag":"Génération d'images","count":4},{"language":"fr","tag":"Génération de vidéos","count":4},{"language":"it","tag":"Account \u0026 utilizzo","count":4},{"language":"it","tag":"Generazione di immagini","count":4},{"language":"it","tag":"Generazione di video","count":4}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"#navigation-items>div:not(:first-child):has(>.sidebar-group-header){border-top:1px solid rgb(17 24 39 / 0.08);padding-top:1.25rem}:is(html.dark,.dark,[data-theme=\"dark\"]) #navigation-items>div:not(:first-child):has(>.sidebar-group-header){border-top-color:rgb(255 255 255 / 0.1)}img.nav-logo{height:25px;margin-bottom:3px}:root{--samsa-ink: #15123a;--samsa-paper: #f3f0ea;--samsa-night: #0e0c16;--samsa-signal: #ff4f1a;--samsa-signal-text: #c43d0b;--samsa-ring: #c43d0b}html.dark{--samsa-signal: #ff5a24;--samsa-signal-text: #ff8a5c;--samsa-ring: #ff5a24;--primary-dark: 243 240 234}:is(a,button,input,select,textarea,summary,[tabindex]):focus-visible{outline-style:solid!important;outline-width:2px!important;outline-color:var(--samsa-ring)!important}.prose a:not(.card,[data-client-link],[class*=\"samsa-hero__\"]):hover,.prose a:not(.card,[data-client-link],[class*=\"samsa-hero__\"]):hover code{color:var(--samsa-signal-text);border-bottom-color:var(--samsa-signal-text)}a:has(>.bg-primary-dark):hover>.bg-primary-dark,button:has(>.bg-primary-dark):hover>.bg-primary-dark{background-color:var(--samsa-signal);opacity:1!important}html.dark a:has(>.bg-primary-dark) :is(.text-white,[class*=\"text-white/\"]),html.dark button:has(>.bg-primary-dark) :is(.text-white,[class*=\"text-white/\"]){color:var(--samsa-night)}html.dark a:has(>.bg-primary-dark):hover :is(.text-white,[class*=\"text-white/\"]),html.dark button:has(>.bg-primary-dark):hover :is(.text-white,[class*=\"text-white/\"]){color:#fff}[data-component-part=\"card-icon\"] svg[class]{background-color:var(--samsa-signal-text)}[data-component-part=\"card-icon\"] svg:not([style*=\"mask\"]){background-color:transparent;color:var(--samsa-signal-text);fill:currentColor}.card:hover [data-component-part=\"card-title\"]{color:var(--samsa-signal-text)}:root{--world-grain: url(\"/images/worlds/grain-128.ca7f55b1c0.webp\");--world-grain-size: 128px;--world-dim: 34.5 32.5 41.5}@media (min-resolution: 1.25dppx){:root{--world-grain-size: 102.4px}}@media (min-resolution: 1.5dppx){:root{--world-grain-size: 85.333px}}@media (min-resolution: 1.75dppx){:root{--world-grain-size: 73.143px}}@media (min-resolution: 2dppx){:root{--world-grain-size: 64px}}@media (min-resolution: 2.25dppx){:root{--world-grain-size: 56.889px}}@media (min-resolution: 2.5dppx){:root{--world-grain-size: 51.2px}}@media (min-resolution: 2.625dppx){:root{--world-grain-size: 48.762px}}@media (min-resolution: 2.75dppx){:root{--world-grain-size: 46.545px}}@media (min-resolution: 3dppx){:root{--world-grain-size: 42.667px}}@media (min-resolution: 3.5dppx){:root{--world-grain-size: 36.571px}}@media (min-resolution: 4dppx){:root{--world-grain-size: 32px}}.samsa-hero,#footer{--world: url(\"/images/worlds/lucerne-night-1600.a0818645bc.webp\");--world-base: #383439;--world-vig: 44 49 53}@media (max-width: 767px){.samsa-hero,#footer{--world: url(\"/images/worlds/lucerne-night-800.774b073457.webp\")}}.samsa-hero,#footer{--vig: 0.25;--world-scrim: linear-gradient(transparent, transparent);position:relative;isolation:isolate;overflow:hidden;background-color:var(--world-base);-webkit-mask-image:linear-gradient(#000 0 0);mask-image:linear-gradient(#000 0 0)}.samsa-hero::before,#footer::before{--world-vignette: radial-gradient(\n farthest-corner ellipse at 50% 50%,\n rgb(var(--world-vig) / 0) 30%,\n rgb(var(--world-vig) / calc(var(--vig) * 0.0138)) 40%,\n rgb(var(--world-vig) / calc(var(--vig) * 0.0635)) 50%,\n rgb(var(--world-vig) / calc(var(--vig) * 0.155)) 60%,\n rgb(var(--world-vig) / calc(var(--vig) * 0.292)) 70%,\n rgb(var(--world-vig) / calc(var(--vig) * 0.477)) 80%,\n rgb(var(--world-vig) / calc(var(--vig) * 0.7124)) 90%,\n rgb(var(--world-vig) / var(--vig)) 100%\n );--world-shade-layer: linear-gradient(\n rgb(var(--world-dim) / var(--world-shade, 0)),\n rgb(var(--world-dim) / var(--world-shade, 0))\n );content:\"\";position:absolute;inset:0;z-index:-2;pointer-events:none;background-image:var(--world-shade-layer),\n var(--world-scrim),\n var(--world-vignette),\n var(--world);background-position:var(--world-x, 50%) var(--world-y, 50%);background-size:calc(100% / var(--world-zoom, 1)) calc(100% / var(--world-zoom, 1)),\n calc(100% / var(--world-zoom, 1)) calc(100% / var(--world-zoom, 1)),\n calc(100% / var(--world-zoom, 1)) calc(100% / var(--world-zoom, 1)),\n cover;background-repeat:no-repeat;transform-origin:var(--world-x, 50%) var(--world-y, 50%);scale:var(--world-zoom, 1)}.samsa-hero::after,#footer::after{content:\"\";position:absolute;inset:0;z-index:-1;pointer-events:none;border-radius:inherit;background:var(--world-grain) 0 0 / var(--world-grain-size) var(--world-grain-size);mix-blend-mode:difference}.samsa-hero{--world-x: 70%;--world-y: 40%;--world-zoom: 1.4;--world-shade: 0;--vig: 0.25;--world-scrim: radial-gradient(\n 72% 140% at 22% 50%,\n rgb(var(--world-dim) / 0.56),\n rgb(var(--world-dim) / 0.36) 60%,\n rgb(var(--world-dim) / 0)\n );margin:1.75rem 0 2.75rem;padding:2.25rem 2rem;border-radius:1rem;color:#f3f0ea}.samsa-hero__title{margin:0 0 0.55rem;max-width:22ch;font-size:1.8rem;font-weight:650;line-height:1.15;letter-spacing:-0.021em;color:#f3f0ea}.samsa-hero__lede{margin:0 0 1.35rem;max-width:46ch;font-size:0.95rem;line-height:1.6;color:#f3f0ea}.samsa-hero__actions{display:flex;flex-wrap:wrap;align-items:center;gap:0.75rem 1.25rem}.samsa-hero__cta,.samsa-hero__link{text-decoration:none;font-size:0.875rem;font-weight:600;border-radius:0.6rem}.samsa-hero__cta{display:inline-flex;align-items:center;padding:0.58rem 1.1rem;border:0;background:#f3f0ea;color:#0e0c16;transition:background-color 0.15s ease, color 0.15s ease}.samsa-hero__cta:hover{background:#ff5a24;color:#fff}.samsa-hero .samsa-hero__link{color:#f3f0ea;border-bottom:2px solid rgb(243 240 234 / 0.45);border-radius:0;padding-bottom:2px;transition:border-color 0.15s ease, box-shadow 0.15s ease}.samsa-hero .samsa-hero__link:hover{color:#f3f0ea;border-bottom-color:#ff5a24;box-shadow:0 1px 0 #ff5a24}.samsa-hero__cta:focus-visible,.samsa-hero__link:focus-visible{outline:2px solid #ff5a24!important;outline-offset:3px}@media (max-width: 640px){.samsa-hero{--world-x: 70%;--world-y: 40%;--world-zoom: 1.2;--world-scrim: radial-gradient(\n 150% 90% at 40% 35%,\n rgb(var(--world-dim) / 0.5),\n rgb(var(--world-dim) / 0.32) 60%,\n rgb(var(--world-dim) / 0.1)\n );padding:1.75rem 1.35rem}.samsa-hero__title{font-size:1.5rem}}#footer{--world-x: 60%;--world-y: 35%;--world-zoom: 1.7;--world-shade: 0.06;--vig: 0.35;--foot-glass: rgb(255 255 255 / 0.72);--foot-glass-solid: rgb(255 255 255 / 0.96);--foot-edge: rgb(21 18 58 / 0.08);--foot-rim: rgb(255 255 255 / 0.9);--foot-heading: #15123a;--foot-text: #3f3c56;--foot-quiet: #5e5a72;--foot-hover: #c43d0b;--foot-chip: rgb(21 18 58 / 0.08);margin:2.5rem 1rem 1rem;padding:2.5rem 1rem;border:0;border-radius:28px}html.dark #footer{--foot-glass: rgb(28 26 40 / 0.66);--foot-glass-solid: rgb(26 24 36 / 0.97);--foot-edge: rgb(0 0 0 / 0.4);--foot-rim: rgb(255 255 255 / 0.12);--foot-heading: #f3f0ea;--foot-text: #c2bdd1;--foot-quiet: #a7a2b8;--foot-hover: #ff8a5c;--foot-chip: rgb(255 255 255 / 0.12)}@media (min-width: 768px){#footer{margin:3rem 1.5rem 1.5rem;padding:4rem 2rem;border-radius:36px}}#footer>div{position:relative;padding:2.5rem 1.75rem 1.75rem;border-radius:24px;background:var(--foot-glass);box-shadow:0 0 0 1px var(--foot-edge),\n 0 30px 60px -28px rgb(21 18 58 / 0.32);-webkit-backdrop-filter:blur(32px) saturate(1.8) brightness(1.12);backdrop-filter:blur(32px) saturate(1.8) brightness(1.12)}@media (min-width: 768px){#footer>div{padding:3rem 3rem 2rem}}@supports not ((backdrop-filter: blur(1px)) or (-webkit-backdrop-filter: blur(1px))){#footer>div{background:var(--foot-glass-solid)}}#footer>div::before{content:\"\";position:absolute;inset:0;border-radius:inherit;padding:1px;background:linear-gradient(180deg, var(--foot-rim), transparent 40%);-webkit-mask:linear-gradient(#000 0 0) content-box, linear-gradient(#000 0 0);-webkit-mask-composite:xor;mask-composite:exclude;pointer-events:none}#footer p{color:var(--foot-heading)}#footer a{color:var(--foot-text)}#footer a:hover{color:var(--foot-hover)}#footer svg[style*=\"mask\"]{background-color:var(--foot-text)}#footer a:hover svg[style*=\"mask\"]{background-color:var(--foot-hover)}#footer a[href*=\"mintlify.com\"]{color:var(--foot-text)}#footer a[href*=\"mintlify.com\"]:hover{color:var(--foot-hover)}#footer [class*=\"h-px\"]{background-color:var(--foot-edge)}#footer button[data-testid^=\"mode-switch\"]{color:var(--foot-quiet);background-color:transparent}#footer button[data-testid^=\"mode-switch\"][aria-pressed=\"true\"]{color:var(--foot-heading);background-color:var(--foot-chip)}#footer button[data-testid^=\"mode-switch\"]:hover{color:var(--foot-hover)}@media (min-width: 1024px) and (prefers-reduced-motion: no-preference){.samsa-hero,#footer{--world-dim: 9 7 16;--world-vig: 18 23 27;--vig: 0.3}.samsa-hero{--vig: 0.45}.samsa-hero::before,#footer::before{position:fixed;inset:0;scale:none;background-color:var(--world-base);background-image:var(--world-grain), url(\"/images/worlds/lucerne-night-1600.a0818645bc.webp\");background-position:0 0, 50% 60%;background-size:var(--world-grain-size) var(--world-grain-size),\n calc(max(100vw, 177.78vh) * 1.15) auto;background-repeat:repeat, no-repeat;background-blend-mode:difference, normal}.samsa-hero::after,#footer::after{mix-blend-mode:normal;background:linear-gradient(\n rgb(var(--world-dim) / var(--world-shade, 0)),\n rgb(var(--world-dim) / var(--world-shade, 0))\n ),\n var(--world-scrim),\n radial-gradient(\n farthest-corner ellipse at 50% 50%,\n rgb(var(--world-vig) / 0) 30%,\n rgb(var(--world-vig) / calc(var(--vig) * 0.0138)) 40%,\n rgb(var(--world-vig) / calc(var(--vig) * 0.0635)) 50%,\n rgb(var(--world-vig) / calc(var(--vig) * 0.155)) 60%,\n rgb(var(--world-vig) / calc(var(--vig) * 0.292)) 70%,\n rgb(var(--world-vig) / calc(var(--vig) * 0.477)) 80%,\n rgb(var(--world-vig) / calc(var(--vig) * 0.7124)) 90%,\n rgb(var(--world-vig) / var(--vig)) 100%\n )}}#footer a.select-none{display:flex;flex-direction:column;align-items:flex-start;gap:14px}#footer a.select-none::after{content:\"The Brand System for AI Agents\";font-size:1rem;line-height:1.5;color:var(--foot-text);white-space:nowrap}@media (max-width: 767px){#footer div:has(>a.select-none){flex-wrap:wrap;row-gap:20px}#footer a.select-none{flex-basis:100%}#footer a.select-none+div{justify-content:flex-start}}@media (min-width: 768px) and (max-width: 1023px){#footer div:has(>div>a.select-none){flex-wrap:wrap}#footer div:has(>a.select-none){flex-basis:100%}}"}],"page":{"pagePath":"fr/api-reference/image-ops/get-background-removal","slug":"/fr/api-reference/image-ops/get-background-removal","pageMetadata":{"title":"Récupérer un job de suppression d'arrière-plan","description":"Interroge un job de suppression d'arrière-plan pour son statut et, une fois terminé, le PNG transparent.","openapi":"api-reference/openapi.json GET /images/background-removals/{background_removal_id}","href":"/fr/api-reference/image-ops/get-background-removal"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Interroge un job de suppression d’arrière-plan pour son statut et, une fois terminé, le PNG transparent.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,..._provideComponents(),...props.components},{CodeBlock,Heading,Tip}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Tip)_missingMdxReference(`Tip`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Récupère le statut d’un job de suppression d’arrière-plan. Tant qu’il est `,_jsx(_components.code,{children:`pending`}),`\nou `,_jsx(_components.code,{children:`processing`}),`, continue d’interroger ; une fois `,_jsx(_components.code,{children:`completed`}),`, la réponse porte un\nseul objet résultat `,_jsx(_components.code,{children:`image`}),` — un PNG transparent avec une presigned `,_jsx(_components.code,{children:`url`}),` valable\n`,_jsx(_components.strong,{children:`24 heures`}),`. Un job en hit de cache naît `,_jsx(_components.code,{children:`completed`}),` avec son résultat déjà\nattaché. Seuls les jobs créés par ton organisation sont visibles ; tout autre id\nrenvoie `,_jsx(_components.a,{href:`/fr/guides/errors#not_found`,children:_jsx(_components.code,{children:`404 not_found`})}),`. Requiert le scope\n`,_jsx(_components.code,{children:`images.transform`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`exemple--job-terminé`,children:`Exemple : job terminé`}),`\n`,_jsxs(_components.p,{children:[`L’`,_jsx(_components.code,{children:`image`}),` est un objet résultat de format dérivé ; pour la suppression\nd’arrière-plan, `,_jsx(_components.code,{children:`model`}),`, `,_jsx(_components.code,{children:`width`}),` et `,_jsx(_components.code,{children:`height`}),` sont toujours `,_jsx(_components.code,{children:`null`}),`. Cet exemple est un\nhit de cache, donc `,_jsx(_components.code,{children:`credits_used`}),` vaut `,_jsx(_components.code,{children:`0`}),` (un miss normal affiche `,_jsx(_components.code,{children:`1`}),`) :`]}),`\n`,_jsx(CodeBlock,{filename:`200 OK`,numberOfLines:`18`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`18`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"f7a8b9c0-1d2e-4f3a-4b5c-6d7e8f9a0b1c\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"completed\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"created_at\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-07-18T10:12:00Z\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"credits_used\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`0`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"image\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"3c4d5e6f-7a8b-4c9d-0e1f-2a3b4c5d6e7f\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"source_image_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"123e4567-e89b-12d3-a456-426614174000\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"format_type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"background_removal\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"mime_type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"image/png\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"url\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://cdn.samsa.ai/user-.../no-bg.png?X-Amz-Signature=...\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"width\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"height\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"resolution_class\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"model\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"error\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`Passe un `,_jsx(_components.code,{children:`webhook_url`}),` sur la\n`,_jsx(_components.a,{href:`/fr/api-reference/image-ops/remove-background`,children:`requête de suppression d’arrière-plan`}),`\nd’origine pour recevoir un callback signé au lieu d’interroger — sur un hit de\ncache, l’événement `,_jsx(_components.code,{children:`completed`}),` se déclenche immédiatement. Voir\n`,_jsx(_components.a,{href:`/fr/guides/webhooks`,children:`Webhooks`}),`.`]})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Récupérer un job de suppression d'arrière-plan","description":"Interroge un job de suppression d'arrière-plan pour son statut et, une fois terminé, le PNG transparent.","openapi":"api-reference/openapi.json GET /images/background-removals/{background_removal_id}","href":"/fr/api-reference/image-ops/get-background-removal"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Exemple : job terminé","slug":"exemple--job-terminé","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Images"],"summary":"Retrieve a background-removal job's status and result","description":"Interroge un job de suppression d'arrière-plan pour son statut et, une fois terminé, le PNG transparent.","operationId":"get_image_background_removal_images_background_removals__background_removal_id__get","parameters":["dabc1224-8d3f-468e-bad4-bf6915d66a58"],"responses":{"200":"df08627d-fd00-4348-99e1-bad86b870ac7","401":"32d42475-8c04-4b52-aa46-849bf05fde81","403":"d2f56ab2-992a-4296-917e-025d120c32ca","404":"d383ca01-7670-4d6e-a744-4d98c385ba9b","422":"849a4957-4bd7-46b1-b7dd-aee87943d0dc","429":"257f800d-4941-4c87-8356-6fd4c8115175","500":"f22865d5-fe61-4b5e-9735-b25f0fe46fb9"},"method":"get","type":"path","servers":["a67142cd-ab67-49c9-9651-75e0f34b1e93"],"security":["a11deb78-1585-485f-a0ea-777224f847bc"],"path":"/images/background-removals/{background_removal_id}","baseUrlOptions":["https://api.samsa.ai/public/v1"],"title":"Retrieve a background-removal job's status and result","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"dabc1224-8d3f-468e-bad4-bf6915d66a58":{"name":"background_removal_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Background Removal Id","isRequired":true,"uniqueKey":"","typeLabel":"string\u003cuuid>"}}},"responses":{"df08627d-fd00-4348-99e1-bad86b870ac7":{"description":"Successful Response","content":{"application/json":{"schema":{"properties":{"id":{"type":"string","format":"uuid","title":"Id","isRequired":true,"uniqueKey":"id","typeLabel":"string\u003cuuid>"},"status":{"type":"string","enum":["pending","processing","completed","failed","cancelled"],"title":"PublicImageStatus","description":"`pending`, `processing`, `completed`, `failed`, or `cancelled`.","examples":["completed"],"isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"When the job was submitted.","isRequired":true,"uniqueKey":"created_at","typeLabel":"string\u003cdate-time>"},"credits_used":{"oneOf":[{"type":"integer","title":"Credits Used","description":"Net credits charged for this job, after any refunds (0 for a cache hit).","example":1,"uniqueKey":"credits_used.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Credits Used","description":"Net credits charged for this job, after any refunds (0 for a cache hit).","example":1,"uniqueKey":"credits_used.oneOf.1","typeLabel":"null"}],"uniqueKey":"credits_used","typeLabel":"integer | null"},"image":{"oneOf":[{"type":"object","title":"PublicImageFormatResult","description":"The produced transparent PNG (presigned URL); null until `completed`.","required":["id","source_image_id","format_type","mime_type","url"],"properties":{"id":{"type":"string","format":"uuid","title":"Id","description":"Stable id of the produced format (not the job id).","isRequired":true,"uniqueKey":"image.oneOf.0.id","typeLabel":"string\u003cuuid>"},"source_image_id":{"type":"string","format":"uuid","title":"Source Image Id","description":"Id of the source image this result derives from.","isRequired":true,"uniqueKey":"image.oneOf.0.source_image_id","typeLabel":"string\u003cuuid>"},"format_type":{"type":"string","enum":["upscale","background_removal"],"title":"Format Type","description":"The derived-format kind.","isRequired":true,"uniqueKey":"image.oneOf.0.format_type","typeLabel":"enum\u003cstring>"},"mime_type":{"type":"string","title":"Mime Type","description":"MIME type of the produced file.","examples":["image/png"],"isRequired":true,"uniqueKey":"image.oneOf.0.mime_type","typeLabel":"string"},"url":{"type":"string","title":"Url","description":"Presigned, time-limited (24h) HTTPS URL of the produced file.","examples":["https://cdn.samsa.ai/user-.../abc.png?X-Amz-Signature=..."],"isRequired":true,"uniqueKey":"image.oneOf.0.url","typeLabel":"string"},"width":{"oneOf":[{"type":"integer","title":"Width","description":"Pixel width, when known.","uniqueKey":"image.oneOf.0.width.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Width","description":"Pixel width, when known.","uniqueKey":"image.oneOf.0.width.oneOf.1","typeLabel":"null"}],"uniqueKey":"image.oneOf.0.width","typeLabel":"integer | null"},"height":{"oneOf":[{"type":"integer","title":"Height","description":"Pixel height, when known.","uniqueKey":"image.oneOf.0.height.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Height","description":"Pixel height, when known.","uniqueKey":"image.oneOf.0.height.oneOf.1","typeLabel":"null"}],"uniqueKey":"image.oneOf.0.height","typeLabel":"integer | null"},"resolution_class":{"oneOf":[{"type":"string","title":"Resolution Class","description":"Resolution class of the produced file (e.g. `2K`), when known.","example":"2K","uniqueKey":"image.oneOf.0.resolution_class.oneOf.0","typeLabel":"string"},{"type":"null","title":"Resolution Class","description":"Resolution class of the produced file (e.g. `2K`), when known.","example":"2K","uniqueKey":"image.oneOf.0.resolution_class.oneOf.1","typeLabel":"null"}],"uniqueKey":"image.oneOf.0.resolution_class","typeLabel":"string | null"},"model":{"oneOf":[{"type":"string","title":"Model","description":"Model that produced the format (upscale only; null otherwise).","example":"crystal","uniqueKey":"image.oneOf.0.model.oneOf.0","typeLabel":"string"},{"type":"null","title":"Model","description":"Model that produced the format (upscale only; null otherwise).","example":"crystal","uniqueKey":"image.oneOf.0.model.oneOf.1","typeLabel":"null"}],"uniqueKey":"image.oneOf.0.model","typeLabel":"string | null"}},"uniqueKey":"image.oneOf.0","typeLabel":"PublicImageFormatResult · object"},{"type":"null","description":"The produced transparent PNG (presigned URL); null until `completed`.","uniqueKey":"image.oneOf.1","typeLabel":"null"}],"uniqueKey":"image","typeLabel":"PublicImageFormatResult · object | null"},"error":{"oneOf":[{"type":"string","title":"Error","description":"Failure detail when `status` is `failed`; otherwise null.","uniqueKey":"error.oneOf.0","typeLabel":"string"},{"type":"null","title":"Error","description":"Failure detail when `status` is `failed`; otherwise null.","uniqueKey":"error.oneOf.1","typeLabel":"null"}],"uniqueKey":"error","typeLabel":"string | null"}},"type":"object","required":["id","status","created_at"],"title":"PublicBackgroundRemovalDetail","description":"`GET /images/background-removals/{id}` body (SAM-820 / S8.8 — ADR §7.2).\n\nThe standard async-job envelope plus ONE nullable `image` result object (an\n`image_formats` derivative — a transparent PNG — built by the S8.2 egress\nbuilder; `model`/`width`/`height` are always null for background removal).\n`created_at` is the job's submit time from the credit ledger (the\n`image_generation_tasks` table has no `created_at` column). A cache-hit job is\nborn `completed` with a frozen result; a normal job progresses\npending → processing → completed/failed.","uniqueKey":"","typeLabel":"PublicBackgroundRemovalDetail · object"},"examples":{"Example":{"title":"Example","value":{"id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","status":"completed","created_at":"2023-11-07T05:31:56Z","credits_used":1,"image":{"id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","source_image_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","format_type":"upscale","mime_type":"image/png","url":"https://cdn.samsa.ai/user-.../abc.png?X-Amz-Signature=...","width":123,"height":123,"resolution_class":"2K","model":"crystal"},"error":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"32d42475-8c04-4b52-aa46-849bf05fde81":{"description":"Missing, invalid, expired, or revoked API key.","content":{"application/json":{"schema":{"properties":{"error":{"properties":{"type":{"type":"string","title":"Type","examples":["authentication_error"],"isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"code":{"type":"string","title":"Code","examples":["invalid_api_key"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","title":"Message","examples":["The provided API key is invalid, expired, or revoked."],"isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"type":"string","title":"Request Id","examples":["8f14e45fceea167a5a36dedd4bea2543"],"isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string"},"param":{"oneOf":[{"type":"string","title":"Param","description":"Present on validation errors — names the offending field.","example":"aspect_ratio","uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","title":"Param","description":"Present on validation errors — names the offending field.","example":"aspect_ratio","uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.param","typeLabel":"string | null"}},"type":"object","required":["type","code","message","request_id"],"title":"ErrorDetail","description":"The ``error`` object of the public envelope (ADR §5).","isRequired":true,"uniqueKey":"error","typeLabel":"ErrorDetail · object"}},"type":"object","required":["error"],"title":"ErrorEnvelope","description":"The complete public error body — an ``error`` object wrapper (ADR §5).","uniqueKey":"","typeLabel":"ErrorEnvelope · object"},"examples":{"Example":{"title":"Example","value":{"error":{"type":"authentication_error","code":"invalid_api_key","message":"The provided API key is invalid, expired, or revoked.","request_id":"8f14e45fceea167a5a36dedd4bea2543","param":"aspect_ratio"}}}},"exampleType":"generated"}},"exampleType":"generated"},"d2f56ab2-992a-4296-917e-025d120c32ca":{"description":"The API key lacks the required scope for this operation.","content":{"application/json":{"schema":{"properties":{"error":{"properties":{"type":{"type":"string","title":"Type","examples":["authentication_error"],"isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"code":{"type":"string","title":"Code","examples":["invalid_api_key"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","title":"Message","examples":["The provided API key is invalid, expired, or revoked."],"isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"type":"string","title":"Request Id","examples":["8f14e45fceea167a5a36dedd4bea2543"],"isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string"},"param":{"oneOf":[{"type":"string","title":"Param","description":"Present on validation errors — names the offending field.","example":"aspect_ratio","uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","title":"Param","description":"Present on validation errors — names the offending field.","example":"aspect_ratio","uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.param","typeLabel":"string | null"}},"type":"object","required":["type","code","message","request_id"],"title":"ErrorDetail","description":"The ``error`` object of the public envelope (ADR §5).","isRequired":true,"uniqueKey":"error","typeLabel":"ErrorDetail · object"}},"type":"object","required":["error"],"title":"ErrorEnvelope","description":"The complete public error body — an ``error`` object wrapper (ADR §5).","uniqueKey":"","typeLabel":"ErrorEnvelope · object"},"examples":{"Example":{"title":"Example","value":{"error":{"type":"authentication_error","code":"invalid_api_key","message":"The provided API key is invalid, expired, or revoked.","request_id":"8f14e45fceea167a5a36dedd4bea2543","param":"aspect_ratio"}}}},"exampleType":"generated"}},"exampleType":"generated"},"d383ca01-7670-4d6e-a744-4d98c385ba9b":{"description":"Generation, or a referenced model/palette, not found.","content":{"application/json":{"schema":{"properties":{"error":{"properties":{"type":{"type":"string","title":"Type","examples":["authentication_error"],"isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"code":{"type":"string","title":"Code","examples":["invalid_api_key"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","title":"Message","examples":["The provided API key is invalid, expired, or revoked."],"isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"type":"string","title":"Request Id","examples":["8f14e45fceea167a5a36dedd4bea2543"],"isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string"},"param":{"oneOf":[{"type":"string","title":"Param","description":"Present on validation errors — names the offending field.","example":"aspect_ratio","uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","title":"Param","description":"Present on validation errors — names the offending field.","example":"aspect_ratio","uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.param","typeLabel":"string | null"}},"type":"object","required":["type","code","message","request_id"],"title":"ErrorDetail","description":"The ``error`` object of the public envelope (ADR §5).","isRequired":true,"uniqueKey":"error","typeLabel":"ErrorDetail · object"}},"type":"object","required":["error"],"title":"ErrorEnvelope","description":"The complete public error body — an ``error`` object wrapper (ADR §5).","uniqueKey":"","typeLabel":"ErrorEnvelope · object"},"examples":{"Example":{"title":"Example","value":{"error":{"type":"authentication_error","code":"invalid_api_key","message":"The provided API key is invalid, expired, or revoked.","request_id":"8f14e45fceea167a5a36dedd4bea2543","param":"aspect_ratio"}}}},"exampleType":"generated"}},"exampleType":"generated"},"849a4957-4bd7-46b1-b7dd-aee87943d0dc":{"description":"Request validation failed (prompt, engine, resolution, ...).","content":{"application/json":{"schema":{"properties":{"error":{"properties":{"type":{"type":"string","title":"Type","examples":["authentication_error"],"isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"code":{"type":"string","title":"Code","examples":["invalid_api_key"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","title":"Message","examples":["The provided API key is invalid, expired, or revoked."],"isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"type":"string","title":"Request Id","examples":["8f14e45fceea167a5a36dedd4bea2543"],"isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string"},"param":{"oneOf":[{"type":"string","title":"Param","description":"Present on validation errors — names the offending field.","example":"aspect_ratio","uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","title":"Param","description":"Present on validation errors — names the offending field.","example":"aspect_ratio","uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.param","typeLabel":"string | null"}},"type":"object","required":["type","code","message","request_id"],"title":"ErrorDetail","description":"The ``error`` object of the public envelope (ADR §5).","isRequired":true,"uniqueKey":"error","typeLabel":"ErrorDetail · object"}},"type":"object","required":["error"],"title":"ErrorEnvelope","description":"The complete public error body — an ``error`` object wrapper (ADR §5).","uniqueKey":"","typeLabel":"ErrorEnvelope · object"},"examples":{"Example":{"title":"Example","value":{"error":{"type":"authentication_error","code":"invalid_api_key","message":"The provided API key is invalid, expired, or revoked.","request_id":"8f14e45fceea167a5a36dedd4bea2543","param":"aspect_ratio"}}}},"exampleType":"generated"}},"exampleType":"generated"},"257f800d-4941-4c87-8356-6fd4c8115175":{"description":"Per-key rate limit or per-org concurrency cap exceeded.","content":{"application/json":{"schema":{"properties":{"error":{"properties":{"type":{"type":"string","title":"Type","examples":["authentication_error"],"isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"code":{"type":"string","title":"Code","examples":["invalid_api_key"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","title":"Message","examples":["The provided API key is invalid, expired, or revoked."],"isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"type":"string","title":"Request Id","examples":["8f14e45fceea167a5a36dedd4bea2543"],"isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string"},"param":{"oneOf":[{"type":"string","title":"Param","description":"Present on validation errors — names the offending field.","example":"aspect_ratio","uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","title":"Param","description":"Present on validation errors — names the offending field.","example":"aspect_ratio","uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.param","typeLabel":"string | null"}},"type":"object","required":["type","code","message","request_id"],"title":"ErrorDetail","description":"The ``error`` object of the public envelope (ADR §5).","isRequired":true,"uniqueKey":"error","typeLabel":"ErrorDetail · object"}},"type":"object","required":["error"],"title":"ErrorEnvelope","description":"The complete public error body — an ``error`` object wrapper (ADR §5).","uniqueKey":"","typeLabel":"ErrorEnvelope · object"},"examples":{"Example":{"title":"Example","value":{"error":{"type":"authentication_error","code":"invalid_api_key","message":"The provided API key is invalid, expired, or revoked.","request_id":"8f14e45fceea167a5a36dedd4bea2543","param":"aspect_ratio"}}}},"exampleType":"generated"}},"exampleType":"generated"},"f22865d5-fe61-4b5e-9735-b25f0fe46fb9":{"description":"Internal server error.","content":{"application/json":{"schema":{"properties":{"error":{"properties":{"type":{"type":"string","title":"Type","examples":["authentication_error"],"isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"code":{"type":"string","title":"Code","examples":["invalid_api_key"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","title":"Message","examples":["The provided API key is invalid, expired, or revoked."],"isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"type":"string","title":"Request Id","examples":["8f14e45fceea167a5a36dedd4bea2543"],"isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string"},"param":{"oneOf":[{"type":"string","title":"Param","description":"Present on validation errors — names the offending field.","example":"aspect_ratio","uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","title":"Param","description":"Present on validation errors — names the offending field.","example":"aspect_ratio","uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.param","typeLabel":"string | null"}},"type":"object","required":["type","code","message","request_id"],"title":"ErrorDetail","description":"The ``error`` object of the public envelope (ADR §5).","isRequired":true,"uniqueKey":"error","typeLabel":"ErrorDetail · object"}},"type":"object","required":["error"],"title":"ErrorEnvelope","description":"The complete public error body — an ``error`` object wrapper (ADR §5).","uniqueKey":"","typeLabel":"ErrorEnvelope · object"},"examples":{"Example":{"title":"Example","value":{"error":{"type":"authentication_error","code":"invalid_api_key","message":"The provided API key is invalid, expired, or revoked.","request_id":"8f14e45fceea167a5a36dedd4bea2543","param":"aspect_ratio"}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"a11deb78-1585-485f-a0ea-777224f847bc":{"BearerAuth":{"type":"http","scheme":"bearer","description":"Organization API key (`Authorization: Bearer samsa_sk_...`) or OAuth 2.1 access token (`Authorization: Bearer samsa_at_...`).","scopes":[],"schemeName":"BearerAuth"}}},"servers":{"a67142cd-ab67-49c9-9651-75e0f34b1e93":{"url":"https://api.samsa.ai/public/v1"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"Organization API key (`Authorization: Bearer samsa_sk_...`) or OAuth 2.1 access token (`Authorization: Bearer samsa_at_...`).","scopes":[],"schemeName":"BearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Organization API key (`Authorization: Bearer samsa_sk_...`) or OAuth 2.1 access token (`Authorization: Bearer samsa_at_...`).","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"BearerAuth","name":"Authorization"}],"title":"BearerAuth"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"samsa-6b52d36f","siteName":"Samsa","title":"Récupérer un job de suppression d'arrière-plan - Samsa","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/api-reference/image-ops/get-background-removal","matchLevel":1},"de":{"href":"/de/api-reference/image-ops/get-background-removal","matchLevel":1},"fr":{"href":"/fr/api-reference/image-ops/get-background-removal","matchLevel":0},"it":{"href":"/it/api-reference/image-ops/get-background-removal","matchLevel":1}}},"lastModified":"2026-08-12T20:57:33.697Z","originalFileLocation":"fr/api-reference/image-ops/get-background-removal.mdx","locale":"fr"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Interroge un job de suppression d\u0026#x27;arrière-plan pour son statut et, une fois terminé, le PNG transparent.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Samsa\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/samsa-6b52d36f/d_WeLiSBvKQ9voQx/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/samsa-6b52d36f/d_WeLiSBvKQ9voQx/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/samsa-6b52d36f/d_WeLiSBvKQ9voQx/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/samsa-6b52d36f/d_WeLiSBvKQ9voQx/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/samsa-6b52d36f/d_WeLiSBvKQ9voQx/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/samsa-6b52d36f/d_WeLiSBvKQ9voQx/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/samsa-6b52d36f/d_WeLiSBvKQ9voQx/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/samsa-6b52d36f/d_WeLiSBvKQ9voQx/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/samsa-6b52d36f/d_WeLiSBvKQ9voQx/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Récupérer un job de suppression d\u0026#x27;arrière-plan - Samsa\">\u003cmeta data-mint-head property=\"og:description\" content=\"Interroge un job de suppression d\u0026#x27;arrière-plan pour son statut et, une fois terminé, le PNG transparent.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Samsa\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.samsa.ai/fr/api-reference/image-ops/get-background-removal\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://samsa-6b52d36f.mintlify.site/_mintlify/api/og/v2?division=Op%C3%A9rations+d%27images\u0026amp;title=R%C3%A9cup%C3%A9rer+un+job+de+suppression+d%27arri%C3%A8re-plan\u0026amp;description=Interroge+un+job+de+suppression+d%27arri%C3%A8re-plan+pour+son+statut+et%2C+une+fois+termin%C3%A9%2C+le+PNG+transparent.\u0026amp;theme=b3c7b7defba13e92508f1219\u0026amp;signature=9472fd33a3bb846f7e763a1ab204c0da9e477c456f8b01cfbd65828a2812b021\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Récupérer un job de suppression d\u0026#x27;arrière-plan - Samsa\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Interroge un job de suppression d\u0026#x27;arrière-plan pour son statut et, une fois terminé, le PNG transparent.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://samsa-6b52d36f.mintlify.site/_mintlify/api/og/v2?division=Op%C3%A9rations+d%27images\u0026amp;title=R%C3%A9cup%C3%A9rer+un+job+de+suppression+d%27arri%C3%A8re-plan\u0026amp;description=Interroge+un+job+de+suppression+d%27arri%C3%A8re-plan+pour+son+statut+et%2C+une+fois+termin%C3%A9%2C+le+PNG+transparent.\u0026amp;theme=b3c7b7defba13e92508f1219\u0026amp;signature=9472fd33a3bb846f7e763a1ab204c0da9e477c456f8b01cfbd65828a2812b021\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/samsa-6b52d36f/d_WeLiSBvKQ9voQx/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Samsa\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#15123A\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.samsa.ai/fr/api-reference/image-ops/get-background-removal\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/fr/api-reference/image-ops/get-background-removal.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"fr\" href=\"https://docs.samsa.ai/fr/api-reference/image-ops/get-background-removal\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docs.samsa.ai/api-reference/image-ops/get-background-removal\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"de\" href=\"https://docs.samsa.ai/de/api-reference/image-ops/get-background-removal\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"it\" href=\"https://docs.samsa.ai/it/api-reference/image-ops/get-background-removal\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docs.samsa.ai/api-reference/image-ops/get-background-removal\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://samsa.ai/#organization\",\"name\":\"Samsa\",\"legalName\":\"Samsa Labs AG\",\"url\":\"https://samsa.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://samsa.ai/wp-content/uploads/2026/01/samsa_logo.webp\"},\"sameAs\":[\"https://www.linkedin.com/company/samsa-ai/\"]},{\"@type\":\"WebSite\",\"@id\":\"https://docs.samsa.ai#website\",\"name\":\"Samsa\",\"url\":\"https://docs.samsa.ai\",\"publisher\":{\"@id\":\"https://samsa.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.samsa.ai/fr/api-reference/image-ops/get-background-removal#webpage\",\"url\":\"https://docs.samsa.ai/fr/api-reference/image-ops/get-background-removal\",\"name\":\"Récupérer un job de suppression d'arrière-plan\",\"description\":\"Interroge un job de suppression d'arrière-plan pour son statut et, une fois terminé, le PNG transparent.\",\"dateModified\":\"2026-08-12T20:57:33.697Z\",\"isPartOf\":{\"@id\":\"https://docs.samsa.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.samsa.ai/fr/api-reference/image-ops/get-background-removal#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.samsa.ai/fr/api-reference/image-ops/get-background-removal#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Points de terminaison\",\"item\":\"https://docs.samsa.ai/fr/api-reference/images/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Opérations d'images\",\"item\":\"https://docs.samsa.ai/fr/api-reference/image-ops/overview\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Récupérer un job de suppression d'arrière-plan\",\"item\":\"https://docs.samsa.ai/fr/api-reference/image-ops/get-background-removal\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.samsa.ai/fr/api-reference/image-ops/get-background-removal#apireference\",\"headline\":\"Récupérer un job de suppression d'arrière-plan\",\"name\":\"Récupérer un job de suppression d'arrière-plan\",\"description\":\"Interroge un job de suppression d'arrière-plan pour son statut et, une fois terminé, le PNG transparent.\",\"url\":\"https://docs.samsa.ai/fr/api-reference/image-ops/get-background-removal\",\"mainEntityOfPage\":{\"@id\":\"https://docs.samsa.ai/fr/api-reference/image-ops/get-background-removal#webpage\"},\"dateModified\":\"2026-08-12T20:57:33.697Z\",\"publisher\":{\"@id\":\"https://samsa.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.samsa.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Samsa\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Samsa\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/fr/api-reference/image-ops/get-background-removal.md","siteName":"Samsa","nav":{"global":null,"languages":[{"language":"en","default":true,"footer":{"socials":{"linkedin":"https://www.linkedin.com/company/samsa-ai","website":"https://samsa.ai"},"links":[{"header":"Information","items":[{"label":"Docs home","href":"/"},{"label":"Changelog","href":"/changelog"},{"label":"Dashboard","href":"https://app.samsa.ai"},{"label":"Pricing","href":"https://samsa.ai/pricing"},{"label":"Contact us","href":"https://samsa.ai/contact"}]},{"header":"Legal","items":[{"label":"Terms of Service","href":"https://samsa.ai/terms-of-service"},{"label":"Acceptable Use Policy","href":"https://samsa.ai/acceptable-use-policy"},{"label":"Privacy Policy","href":"https://samsa.ai/privacy-policy"},{"label":"Imprint","href":"https://samsa.ai/imprint"}]}]},"pages":[{"title":"en","href":"/api-reference/image-ops/get-background-removal"}]},{"language":"de","footer":{"socials":{"linkedin":"https://www.linkedin.com/company/samsa-ai","website":"https://samsa.ai"},"links":[{"header":"Informationen","items":[{"label":"Doku-Startseite","href":"/de"},{"label":"Changelog","href":"/de/changelog"},{"label":"Dashboard","href":"https://app.samsa.ai"},{"label":"Preise","href":"https://samsa.ai/de/preise"},{"label":"Kontakt","href":"https://samsa.ai/de/kontakt"}]},{"header":"Rechtliches","items":[{"label":"AGB","href":"https://samsa.ai/de/agb"},{"label":"Nutzungsrichtlinie","href":"https://samsa.ai/de/nutzungsrichtlinie"},{"label":"Datenschutz","href":"https://samsa.ai/de/datenschutz"},{"label":"Impressum","href":"https://samsa.ai/de/impressum"}]}]},"pages":[{"title":"de","href":"/de/api-reference/image-ops/get-background-removal"}]},{"language":"fr","footer":{"socials":{"linkedin":"https://www.linkedin.com/company/samsa-ai","website":"https://samsa.ai"},"links":[{"header":"Informations","items":[{"label":"Accueil documentation","href":"/fr"},{"label":"Changelog","href":"/fr/changelog"},{"label":"Dashboard","href":"https://app.samsa.ai"},{"label":"Tarifs","href":"https://samsa.ai/fr/prix"},{"label":"Contact","href":"https://samsa.ai/fr/contact"}]},{"header":"Légal","items":[{"label":"Conditions générales","href":"https://samsa.ai/fr/conditions-generales"},{"label":"Politique d'utilisation acceptable","href":"https://samsa.ai/fr/politique-utilisation-acceptable"},{"label":"Politique de confidentialité","href":"https://samsa.ai/fr/politique-de-confidentialite"},{"label":"Mentions légales","href":"https://samsa.ai/fr/mentions-legales"}]}]},"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/fr"}]},{"tab":"Référence API","groups":[{"group":"Vue d'ensemble","pages":[{"title":"API Samsa","href":"/fr/api"},{"title":"Référence API","href":"/fr/api-reference/introduction"}]},{"group":"Points de terminaison","pages":[{"group":"Génération d'images","pages":[{"title":"Génération d'images","sidebarTitle":"Aperçu","href":"/fr/api-reference/images/overview"},{"title":"Générer des images","openapi":"api-reference/openapi.json POST /images/generations","href":"/fr/api-reference/images/generate"},{"title":"Récupérer une génération d'image","openapi":"api-reference/openapi.json GET /images/generations/{generation_id}","href":"/fr/api-reference/images/get-generation"},{"title":"Lister les moteurs d'image","openapi":"api-reference/openapi.json GET /images/models","href":"/fr/api-reference/images/list-engines"}]},{"group":"Téléversement d'images","pages":[{"title":"Téléversement d'images","sidebarTitle":"Aperçu","href":"/fr/api-reference/uploads/overview"},{"title":"Préparer un upload d'image","openapi":"api-reference/openapi.json POST /images/uploads/prepare","href":"/fr/api-reference/uploads/prepare"},{"title":"Finaliser un upload d'image","openapi":"api-reference/openapi.json POST /images/uploads/{image_id}/complete","href":"/fr/api-reference/uploads/complete"}]},{"group":"Édition d'images","pages":[{"title":"Édition d'images","sidebarTitle":"Aperçu","href":"/fr/api-reference/edits/overview"},{"title":"Éditer une image","openapi":"api-reference/openapi.json POST /images/edits","href":"/fr/api-reference/edits/create"},{"title":"Récupérer une édition d'image","openapi":"api-reference/openapi.json GET /images/edits/{edit_id}","href":"/fr/api-reference/edits/get-edit"}]},{"group":"Opérations d'images","pages":[{"title":"Opérations d'images","sidebarTitle":"Aperçu","href":"/fr/api-reference/image-ops/overview"},{"title":"Transformer des images (img2img)","openapi":"api-reference/openapi.json POST /images/img2img","href":"/fr/api-reference/image-ops/img2img"},{"title":"Récupérer un job img2img","openapi":"api-reference/openapi.json GET /images/img2img/{img2img_id}","href":"/fr/api-reference/image-ops/get-img2img"},{"title":"Générer des variations","openapi":"api-reference/openapi.json POST /images/variations","href":"/fr/api-reference/image-ops/variations"},{"title":"Récupérer un job de variations","openapi":"api-reference/openapi.json GET /images/variations/{variation_id}","href":"/fr/api-reference/image-ops/get-variations"},{"title":"Agrandir une image","openapi":"api-reference/openapi.json POST /images/upscales","href":"/fr/api-reference/image-ops/upscale"},{"title":"Récupérer un job d'upscale","openapi":"api-reference/openapi.json GET /images/upscales/{upscale_id}","href":"/fr/api-reference/image-ops/get-upscale"},{"title":"Redimensionner une image","openapi":"api-reference/openapi.json POST /images/resizes","href":"/fr/api-reference/image-ops/resize"},{"title":"Récupérer un job de redimensionnement","openapi":"api-reference/openapi.json GET /images/resizes/{resize_id}","href":"/fr/api-reference/image-ops/get-resize"},{"title":"Supprimer un arrière-plan","description":"Soumets un job de suppression d'arrière-plan — une image source — et récupère un PNG transparent.","openapi":"api-reference/openapi.json POST /images/background-removals","href":"/fr/api-reference/image-ops/remove-background"},{"title":"Récupérer un job de suppression d'arrière-plan","openapi":"api-reference/openapi.json GET /images/background-removals/{background_removal_id}","href":"/fr/api-reference/image-ops/get-background-removal"},{"title":"Vectoriser une image","description":"Soumets un job de vectorisation — une image source vers SVG — et récupère un id de job.","openapi":"api-reference/openapi.json POST /images/vectorizations","href":"/fr/api-reference/image-ops/vectorize"},{"title":"Récupérer un job de vectorisation","openapi":"api-reference/openapi.json GET /images/vectorizations/{vectorization_id}","href":"/fr/api-reference/image-ops/get-vectorization"}]},{"group":"Génération de vidéos","pages":[{"title":"Génération de vidéos","sidebarTitle":"Aperçu","href":"/fr/api-reference/videos/overview"},{"title":"Générer une vidéo","openapi":"api-reference/openapi.json POST /videos/generations","href":"/fr/api-reference/videos/generate"},{"title":"Récupérer une génération de vidéo","openapi":"api-reference/openapi.json GET /videos/generations/{generation_id}","href":"/fr/api-reference/videos/get-generation"},{"title":"Lister les engines vidéo","openapi":"api-reference/openapi.json GET /videos/models","href":"/fr/api-reference/videos/list-engines"}]},{"group":"Amélioration de prompts","pages":[{"title":"Amélioration de prompts","sidebarTitle":"Aperçu","href":"/fr/api-reference/prompts/overview"},{"title":"Améliorer un prompt","openapi":"api-reference/openapi.json POST /prompts/improve","href":"/fr/api-reference/prompts/improve"}]},{"group":"Entraînement de modèles","pages":[{"title":"Entraînement de modèles","sidebarTitle":"Aperçu","href":"/fr/api-reference/model-training/overview"},{"title":"Créer un modèle","openapi":"api-reference/openapi.json POST /models","href":"/fr/api-reference/model-training/create"},{"title":"Préparer un upload de modèle","openapi":"api-reference/openapi.json POST /models/prepare","href":"/fr/api-reference/model-training/prepare"},{"title":"Finaliser un upload de modèle","openapi":"api-reference/openapi.json POST /models/{model_id}/complete","href":"/fr/api-reference/model-training/complete"},{"title":"Obtenir le statut d'un modèle","openapi":"api-reference/openapi.json GET /models/{model_id}/status","href":"/fr/api-reference/model-training/status"}]},{"group":"Modèles","pages":[{"title":"Modèles","sidebarTitle":"Aperçu","href":"/fr/api-reference/models/overview"},{"title":"Lister les modèles","openapi":"api-reference/openapi.json GET /models","href":"/fr/api-reference/models/list"},{"title":"Obtenir un modèle","openapi":"api-reference/openapi.json GET /models/{model_id}","href":"/fr/api-reference/models/get"},{"title":"Mettre à jour un modèle","openapi":"api-reference/openapi.json PATCH /models/{model_id}","href":"/fr/api-reference/models/update"},{"title":"Supprimer un modèle","openapi":"api-reference/openapi.json DELETE /models/{model_id}","href":"/fr/api-reference/models/delete"}]},{"group":"Compte \u0026 utilisation","pages":[{"title":"Compte \u0026 utilisation","sidebarTitle":"Aperçu","href":"/fr/api-reference/account/overview"},{"title":"Obtenir la clé courante (me)","openapi":"api-reference/openapi.json GET /me","href":"/fr/api-reference/account/me"},{"title":"Obtenir les credits","openapi":"api-reference/openapi.json GET /credits","href":"/fr/api-reference/account/credits"},{"title":"Obtenir l'utilisation","openapi":"api-reference/openapi.json GET /usage","href":"/fr/api-reference/account/usage"}]}]}]},{"tab":"MCP server","pages":[{"title":"MCP server","href":"/fr/mcp-server"}]},{"tab":"Vérification de contenu","pages":[{"title":"Vérification de contenu","href":"/fr/content-verification/overview"}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/fr/changelog"}]}]},{"language":"it","footer":{"socials":{"linkedin":"https://www.linkedin.com/company/samsa-ai","website":"https://samsa.ai"},"links":[{"header":"Informazioni","items":[{"label":"Home documentazione","href":"/it"},{"label":"Changelog","href":"/it/changelog"},{"label":"Dashboard","href":"https://app.samsa.ai"},{"label":"Prezzi","href":"https://samsa.ai/it/prezzi"},{"label":"Contatti","href":"https://samsa.ai/it/contatto"}]},{"header":"Legale","items":[{"label":"Termini e condizioni","href":"https://samsa.ai/it/termini-e-condizioni"},{"label":"Politica di utilizzo accettabile","href":"https://samsa.ai/it/politica-utilizzo-accettabile"},{"label":"Informativa sulla privacy","href":"https://samsa.ai/it/informativa-sulla-privacy"},{"label":"Note legali","href":"https://samsa.ai/it/impronta"}]}]},"pages":[{"title":"it","href":"/it/api-reference/image-ops/get-background-removal"}]}]},"basePath":"","title":"Récupérer un job de suppression d'arrière-plan - Samsa","deploymentId":"dpl_FZMKUpaaKiVETbfqhoUe4sPFDTmY","buildId":"dpl_FZMKUpaaKiVETbfqhoUe4sPFDTmY","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-B6WFFOBL.js","utils-BN5um1KA.js","cloneDeep-C3md22mN.js","_Uint8Array-DLlL8L26.js","isObject-FP1Yky1u.js","utils-BSmbkXJR.js","addUniqueKeysToSchema-2tqcVnUE.js","snippetPresets-CtWfvr2J.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-DkKHBy30.js","isEqual-O3q7y6pq.js","usePlaygroundInputsStore-Brc5H9UJ.js","shallow-C4L4xvbs.js","getApiPlaygroundDisplay-2bxyq_aI.js","CodeSnippet-BJu8ddd5.js","CodeSnippets-dazWmoqB.js","Page-CnLhKuUV.js","getPastedJson-Chy3Qa1S.js","icon-CyO7h3jh.js","MethodPill-Dle0_91v.js","DuplicateIcon-CVvWAf4a.js","createIcon-Di07A27B.js","DynamicMarkdown-C4w9kavL.js","SectionHeading-XiBebVYC.js","axios-vUo_bRtp.js","Markdown-DTeL0SpS.js","dist-OCScizqf.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","katex-YMM-FMeD.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js","AssistantPageLink-KcneGfMY.js"]}