{
"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"
}
}
{
"error": {
"type": "authentication_error",
"code": "invalid_api_key",
"message": "The provided API key is invalid, expired, or revoked.",
"request_id": "8f14e45fceea167a5a36dedd4bea2543",
"param": "aspect_ratio"
}
}
Gibt zurück, was das aufrufende Credential — dieser API-Key oder diese
OAuth-Verbindung — gerade ausgeben kann, zusammen mit den organisationsweiten Summen,
aus denen sich das ergibt. Erfordert den usage.read Scope. Für Preisdetails siehe
Preise.
Die Antwort enthält zwei Arten von Zahlen. available und spendable_plan_credits
beantworten „was kann dieses Credential ausgeben“; plan_credits und topup_credits
sind organisationsweite Stände.
Feld
Was es ist
available
Credits, die dieses Credential gerade jetzt ausgeben kann — spendable_plan_credits + topup_credits. Das ist die Zahl, mit der du die estimated_credits eines Jobs vergleichst.
spendable_plan_credits
Der Plan-Pool-Anteil von available: plan_credits, begrenzt durch scope.remaining. Gleich plan_credits, wenn dieses Credential nicht begrenzt ist.
plan_credits
Der verbleibende monatliche Plan-Pool der Organisation — nicht zwingend vollständig durch dieses Credential ausgebbar. 0, wenn der Pool erschöpft ist oder das Abo gekündigt und über sein Periodenende hinaus ist (Top-ups bleiben ausgebbar).
topup_credits
Verbleibende Credits aus gültigen, nicht abgelaufenen Top-up-Käufen. Top-ups sind von Team-Budgets ausgenommen und daher immer voll ausgebbar.
period
Die aktuelle Abrechnungsperiode der Organisation. Der Budget-Verbrauch der Teams setzt sich mit ihr zurück.
scope
Das Budget-Regime, unter dem dieses Credential ausgibt — siehe unten.
Drei Beziehungen gelten immer:
available == spendable_plan_credits + topup_credits
spendable_plan_credits <= plan_credits
für eine Organisation ohne aktive Teams gilt spendable_plan_credits == plan_credits
Wenn deine Organisation keine Teams hat, ändert sich für dich nichts.scope.type
ist org, spendable_plan_credits entspricht plan_credits, und available ist
weiterhin der Plan-Pool plus Top-ups.
Eine Organisation kann Teile ihres monatlichen Plan-Pools als Budgets pro Team
reservieren, und jeder API-Key kann einem Team zugewiesen werden. Ein Credential gibt
dann aus genau einem Bucket aus, und nur der Spielraum dieses Buckets steht ihm zur
Verfügung — deshalb kann available niedriger sein als die organisationsweiten
plan_credits.
scope.type
Bedeutung
Fehlercode bei Unterdeckung
org
Die Organisation hat keine aktiven Teams (der Normalfall), oder sie ist eine vom Team-Budgeting ausgenommene System-Organisation. Dieses Credential ist nicht begrenzt, deshalb sind budget, used und remaining alle null.
Die Organisation hat mindestens ein aktives Team, und dieses Credential ist keinem Team mit Budget zugewiesen — es hat kein Team, oder sein Team hat kein eigenes Budget. budget ist die monatliche Plan-Zuteilung minus aller aktiven Team-Budgets, nach unten auf 0 begrenzt.
scope.team nennt das Team, dem das Credential zugewiesen ist, oder ist null, wenn es
keinem zugewiesen ist. scope.remaining ist budget - used, nach unten auf 0 begrenzt.Ein team-gebundener Key, bei dem das Budget die begrenzende Größe ist:
Die Organisation hat noch 8031 Plan-Credits, aber vom Marketing-Budget sind 1200
übrig — dieser Key kann also nur 1200 davon ausgeben, plus die 250 von Budgets
ausgenommenen Top-up-Credits, insgesamt 1450.
available ist die Vorhersage. Ein Job, dessen estimated_credits höchstens
available betragen, wird nicht mit einem Credit-402 abgelehnt, und umgekehrt bedeutet
so ein 402, dass die Schätzung available überschritten hat — bei beidem die Zahl
des Credentials, nicht die der Organisation. Eine Ausnahme: ein operativer Fehler in
der Abbuchung selbst (etwa eine gestörte Saldo-Abfrage) wird unabhängig vom Regime als
generisches insufficient_credits gemeldet,
ohne etwas über available zu beweisen — ein schlichtes insufficient_credits, wo du
einen team-spezifischen Code erwartet hättest, kann also vorübergehend sein; versuche es
erneut, bevor du es als erschöpften Stand behandelst.
Die Vorhersage gilt nur, solange sich der Credit- und Budget-Zustand zwischen dem Lesen
und dem Absenden nicht ändert. Ein anderes Credential derselben Organisation, das ausgibt,
ein ablaufendes Top-up-Lot, eine Abo-Änderung, ein geändertes Team-Budget oder ein Key,
der einem anderen Team zugewiesen wird, können available verschieben — und sogar
scope.type und damit den Fehlercode ändern — ohne dass du selbst etwas ausgegeben
hast.
subscription_inactive ist ein separates
402 und hat mit diesem Vergleich nichts zu tun.
Wenn ein Absenden abgelehnt wird, erklärt scope es:
scope.type nennt das Budget-Regime, und das wählt den Fehlercode aus (abgesehen
vom operativen Fallback oben) — siehe die Tabelle oben. Es sagt dir nicht, welcher
Stand erschöpft war: ein Key im
team-Regime erhält insufficient_team_credits auch dann, wenn der Plan-Pool der
Organisation und nicht das Team-Budget aufgebraucht war.
Um unter einem begrenzten Regime (team oder unallocated) die tatsächliche Ursache zu
finden, vergleiche plan_credits mit scope.remaining — der kleinere Wert begrenzt
spendable_plan_credits. Unter org ist scope.remainingnull und plan_credits
ist die einzige mögliche Ursache.
remaining: 0 bedeutet, dass dieser Bucket für die aktuelle period vollständig
ausgegeben ist. Es ist keine Voraussetzung für den Fehler: ein Bucket mit
remaining: 100 und ohne Top-ups lehnt einen Job für 200 weiterhin ab.
Ein Key ohne Team in einer Organisation, deren Plan-Pool vollständig an Teams zugewiesen
ist, meldet also available: 0 mit scope.type: "unallocated" und remaining: 0 — jedes
Absenden, das Credits kostet, wird mit insufficient_unallocated_credits abgelehnt, bis ein Budget gesenkt
wird, der Key einem Team mit Spielraum zugewiesen wird oder Top-ups gekauft werden. Siehe
Fehler für den Umgang mit jedem Code.
Organization API key (Authorization: Bearer samsa_sk_...) or OAuth 2.1 access token (Authorization: Bearer samsa_at_...).
Antwort
Successful Response
GET /credits body — what the CALLING credential can spend (ADR §10, SAM-1029).
Two kinds of number:
available / spendable_plan_credits answer "what can THIS API key or
OAuth connection spend right now" — capped by its team budget bucket
(scope), so a job estimated at or below available is not rejected
with insufficient_team_credits / insufficient_unallocated_credits.
plan_credits / topup_credits are the ORGANIZATION-wide balances.
All amounts are balances (not allocations), and
available == spendable_plan_credits + topup_credits always holds, as does
spendable_plan_credits <= plan_credits (they are equal whenever no team
budget applies).
Total credits the calling credential can spend right now — the sum of spendable_plan_credits and topup_credits. Capped by the credential's team budget bucket (see scope), so it can be lower than the organization-wide plan_credits.
Plan-pool credits the calling credential can spend right now: plan_credits capped by scope.remaining. Equal to plan_credits when no team budget applies.
The ORGANIZATION's remaining monthly subscription-pool credits — not necessarily all spendable by this credential (see spendable_plan_credits). 0 when the plan pool is exhausted or the subscription is canceled and past its period end (top-up credits stay spendable).
Remaining credits from valid (non-expired) top-up purchases. Top-ups are exempt from team budgets, so they are always fully spendable by any credential of the organization.
The credit bucket the calling credential spends from (SAM-1029).
Organizations can reserve parts of their monthly plan pool for teams. A
credential (API key or OAuth connection) spends from exactly ONE bucket, and
only that bucket's headroom is available to it — which is why available
can be lower than the organization-wide plan_credits. The shortfall rule
is cost > available (spendable_plan_credits + topup_credits): a submit
is refused with an insufficient-credit 402 when the deduction,
re-evaluating the same numbers at execution time, finds the estimated cost
above available — insufficient_credits under the uncapped org regime,
insufficient_team_credits under team, and
insufficient_unallocated_credits under unallocated (operational
failures inside the deduction fall back to the generic
insufficient_credits, whatever the regime). This response is a
point-in-time snapshot, not a reservation: concurrent spends, top-up lots
expiring, a canceled subscription's period ending, or a degraded balance
lookup can make the deduction-time numbers differ from the ones reported
here, and other checks can reject a request regardless of credits.
type names the budget regime and selects which of those codes a balance
shortfall raises — it does not say which balance ran out: under a capped
regime the smaller of plan_credits and remaining limits
spendable_plan_credits.
remaining: 0 means this bucket has no plan-pool headroom left for the
current period (spent down, or never allocated any); it is NOT a
precondition of the error — a bucket with remaining: 100 and no top-ups
still refuses a job costing 200.
Show child attributes
{"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":""},"chroma":{"collectionId":"261105e6-9f7b-458a-8ad6-ddeee178a591","liveDeploymentHistoryId":"6ada3247fd1ebb929e8defb9","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ada3247fd1ebb929e8defb9"},"feedback":{"agentFeedback":true,"thumbs":false},"entitlements":{},"buildId":"6ada3247fd1ebb929e8defb9","clientVersion":"0.0.3964","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},"hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","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":"editor-v7-file-tree","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":"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":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","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":"per-site-search-delta","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":"editor-private-page-search","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":"editor-nav-generations","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":"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":"byok-sep-25","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":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","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}],"isAtlas":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/.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/.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;--world-grain:url(\"/images/worlds/grain-128.ca7f55b1c0.webp\");--world-grain-size:128px;--world-dim:34.5 32.5 41.5}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)}@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}}#footer,.samsa-hero{--world:image-set(\n url(\"/images/worlds/orchid-jungle-1600.c6a419e4ef.avif\") type(\"image/avif\"),\n url(\"/images/worlds/orchid-jungle-1600.7e5329f561.webp\") type(\"image/webp\")\n );--world-webp:url(\"/images/worlds/orchid-jungle-1600.7e5329f561.webp\");--world-base:#41403b;--world-vig:47 43 68}@media (max-width:767px){#footer,.samsa-hero{--world:image-set(\n url(\"/images/worlds/orchid-jungle-800.f9ec57f3b4.avif\") type(\"image/avif\"),\n url(\"/images/worlds/orchid-jungle-800.55128c3346.webp\") type(\"image/webp\")\n );--world-webp:url(\"/images/worlds/orchid-jungle-800.55128c3346.webp\")}}.samsa-hero{--world-x:30%;--world-y:60%;--world-zoom:1.3;--world-shade:0;--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}#footer,.samsa-hero{--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)}#footer::before,.samsa-hero::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),var(--world-scrim),var(--world-vignette),var(--world-webp);background-position:var(--world-x, 50%) var(--world-y, 50%);background-size:calc(100%/var(--world-zoom, 1)) calc(100%/var(--world-zoom, 1)),calc(100%/var(--world-zoom, 1)) calc(100%/var(--world-zoom, 1)),calc(100%/var(--world-zoom, 1)) calc(100%/var(--world-zoom, 1)),cover;background-repeat:no-repeat;transform-origin:var(--world-x, 50%) var(--world-y, 50%);scale:var(--world-zoom, 1)}@supports (background-image:image-set(url(data:,x) type(\"image/avif\"))){#footer::before,.samsa-hero::before{background-image:var(--world-shade-layer),var(--world-scrim),var(--world-vignette),var(--world)}}#footer::after,.samsa-hero::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__title{margin:0 0 .55rem;max-width:22ch;font-size:1.8rem;font-weight:650;line-height:1.15;letter-spacing:-.021em;color:#f3f0ea}.samsa-hero__lede{margin:0 0 1.35rem;max-width:46ch;font-size:.95rem;line-height:1.6;color:#f3f0ea}.samsa-hero__actions{display:flex;flex-wrap:wrap;align-items:center;gap:.75rem 1.25rem}.samsa-hero__cta,.samsa-hero__link{text-decoration:none;font-size:.875rem;font-weight:600;border-radius:.6rem}.samsa-hero__cta{display:inline-flex;align-items:center;padding:.58rem 1.1rem;border:0;background:#f3f0ea;color:#0e0c16;transition:background-color .15s ease,color .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/.45);border-radius:0;padding-bottom:2px;transition:border-color .15s ease,box-shadow .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:40%;--world-y:55%;--world-zoom:1.15;--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:35%;--world-y:55%;--world-zoom:1.5;--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),0 30px 60px -28px rgb(21 18 58/.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:hover,#footer a[href*=\"mintlify.com\"]: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,#footer a[href*=\"mintlify.com\"]{color:var(--foot-text)}#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)}"}],"page":{"pagePath":"de/api-reference/account/credits","slug":"/de/api-reference/account/credits","pageMetadata":{"title":"Credits abrufen","description":"Lies den Credit-Stand, den dieser API-Key ausgeben kann.","openapi":"api-reference/openapi.json GET /credits","href":"/de/api-reference/account/credits"},"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: \"Lies den Credit-Stand, den dieser API-Key ausgeben kann.\"\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`,em:`em`,li:`li`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Note,Table,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Gibt zurück, was das `,_jsx(_components.strong,{children:`aufrufende Credential`}),` — dieser API-Key oder diese\nOAuth-Verbindung — gerade ausgeben kann, zusammen mit den organisationsweiten Summen,\naus denen sich das ergibt. Erfordert den `,_jsx(_components.code,{children:`usage.read`}),` Scope. Für Preisdetails siehe\n`,_jsx(_components.a,{href:`/de/guides/pricing`,children:`Preise`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`credential-verfügbar-vs-organisationsweit`,children:`Credential-verfügbar vs. organisationsweit`}),`\n`,_jsxs(_components.p,{children:[`Die Antwort enthält zwei Arten von Zahlen. `,_jsx(_components.code,{children:`available`}),` und `,_jsx(_components.code,{children:`spendable_plan_credits`}),`\nbeantworten „was kann `,_jsx(_components.em,{children:`dieses`}),` Credential ausgeben“; `,_jsx(_components.code,{children:`plan_credits`}),` und `,_jsx(_components.code,{children:`topup_credits`}),`\nsind organisationsweite Stände.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Feld`}),_jsx(_components.th,{children:`Was es ist`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`available`})}),_jsxs(_components.td,{children:[`Credits, die dieses Credential `,_jsx(_components.strong,{children:`gerade jetzt`}),` ausgeben kann — `,_jsx(_components.code,{children:`spendable_plan_credits + topup_credits`}),`. Das ist die Zahl, mit der du die `,_jsx(_components.code,{children:`estimated_credits`}),` eines Jobs vergleichst.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`spendable_plan_credits`})}),_jsxs(_components.td,{children:[`Der Plan-Pool-Anteil von `,_jsx(_components.code,{children:`available`}),`: `,_jsx(_components.code,{children:`plan_credits`}),`, begrenzt durch `,_jsx(_components.code,{children:`scope.remaining`}),`. Gleich `,_jsx(_components.code,{children:`plan_credits`}),`, wenn dieses Credential nicht begrenzt ist.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`plan_credits`})}),_jsxs(_components.td,{children:[`Der verbleibende monatliche Plan-Pool der `,_jsx(_components.strong,{children:`Organisation`}),` — nicht zwingend vollständig durch dieses Credential ausgebbar. `,_jsx(_components.code,{children:`0`}),`, wenn der Pool erschöpft ist oder das Abo gekündigt und über sein Periodenende hinaus ist (Top-ups bleiben ausgebbar).`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`topup_credits`})}),_jsx(_components.td,{children:`Verbleibende Credits aus gültigen, nicht abgelaufenen Top-up-Käufen. Top-ups sind von Team-Budgets ausgenommen und daher immer voll ausgebbar.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`period`})}),_jsx(_components.td,{children:`Die aktuelle Abrechnungsperiode der Organisation. Der Budget-Verbrauch der Teams setzt sich mit ihr zurück.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`scope`})}),_jsx(_components.td,{children:`Das Budget-Regime, unter dem dieses Credential ausgibt — siehe unten.`})]})]})]}),`\n`,_jsx(_components.p,{children:`Drei Beziehungen gelten immer:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:_jsx(_components.code,{children:`available == spendable_plan_credits + topup_credits`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.code,{children:`spendable_plan_credits \u003c= plan_credits`})}),`\n`,_jsxs(_components.li,{children:[`für eine Organisation ohne aktive Teams gilt `,_jsx(_components.code,{children:`spendable_plan_credits == plan_credits`})]}),`\n`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Wenn deine Organisation keine Teams hat, ändert sich für dich nichts.`}),` `,_jsx(_components.code,{children:`scope.type`}),`\nist `,_jsx(_components.code,{children:`org`}),`, `,_jsx(_components.code,{children:`spendable_plan_credits`}),` entspricht `,_jsx(_components.code,{children:`plan_credits`}),`, und `,_jsx(_components.code,{children:`available`}),` ist\nweiterhin der Plan-Pool plus Top-ups.`]})}),`\n`,_jsxs(Heading,{level:`2`,id:`das-budget-regime-scope`,children:[`Das Budget-Regime (`,_jsx(_components.code,{children:`scope`}),`)`]}),`\n`,_jsxs(_components.p,{children:[`Eine Organisation kann Teile ihres monatlichen Plan-Pools als `,_jsx(_components.strong,{children:`Budgets`}),` pro Team\nreservieren, und jeder API-Key kann einem Team zugewiesen werden. Ein Credential gibt\ndann aus genau einem Bucket aus, und nur der Spielraum dieses Buckets steht ihm zur\nVerfügung — deshalb kann `,_jsx(_components.code,{children:`available`}),` niedriger sein als die organisationsweiten\n`,_jsx(_components.code,{children:`plan_credits`}),`.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:_jsx(_components.code,{children:`scope.type`})}),_jsx(_components.th,{children:`Bedeutung`}),_jsx(_components.th,{children:`Fehlercode bei Unterdeckung`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`org`})}),_jsxs(_components.td,{children:[`Die Organisation hat keine aktiven Teams (der Normalfall), oder sie ist eine vom Team-Budgeting ausgenommene System-Organisation. Dieses Credential ist nicht begrenzt, deshalb sind `,_jsx(_components.code,{children:`budget`}),`, `,_jsx(_components.code,{children:`used`}),` und `,_jsx(_components.code,{children:`remaining`}),` alle `,_jsx(_components.code,{children:`null`}),`.`]}),_jsx(_components.td,{children:_jsx(_components.a,{href:`/de/guides/errors#insufficient_credits`,children:_jsx(_components.code,{children:`insufficient_credits`})})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`team`})}),_jsx(_components.td,{children:`Das Credential ist einem aktiven Team zugewiesen, das ein eigenes Monatsbudget hat.`}),_jsx(_components.td,{children:_jsx(_components.a,{href:`/de/guides/errors#insufficient_team_credits`,children:_jsx(_components.code,{children:`insufficient_team_credits`})})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`unallocated`})}),_jsxs(_components.td,{children:[`Die Organisation hat mindestens ein aktives Team, und dieses Credential ist `,_jsx(_components.strong,{children:`keinem`}),` Team mit Budget zugewiesen — es hat kein Team, oder sein Team hat kein eigenes Budget. `,_jsx(_components.code,{children:`budget`}),` ist die monatliche Plan-Zuteilung minus aller aktiven Team-Budgets, nach unten auf `,_jsx(_components.code,{children:`0`}),` begrenzt.`]}),_jsx(_components.td,{children:_jsx(_components.a,{href:`/de/guides/errors#insufficient_unallocated_credits`,children:_jsx(_components.code,{children:`insufficient_unallocated_credits`})})})]})]})]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`scope.team`}),` nennt das Team, dem das Credential zugewiesen ist, oder ist `,_jsx(_components.code,{children:`null`}),`, wenn es\nkeinem zugewiesen ist. `,_jsx(_components.code,{children:`scope.remaining`}),` ist `,_jsx(_components.code,{children:`budget - used`}),`, nach unten auf `,_jsx(_components.code,{children:`0`}),` begrenzt.`]}),`\n`,_jsx(_components.p,{children:`Ein team-gebundener Key, bei dem das Budget die begrenzende Größe ist:`}),`\n`,_jsx(CodeBlock,{filename:`Response`,numberOfLines:`20`,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:`20`,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:` \"available\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1450`}),_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:` \"spendable_plan_credits\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1200`}),_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:` \"plan_credits\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`8031`}),_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:` \"topup_credits\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`250`}),_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:` \"period\"`}),_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:` \"start\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-07-01T00:00:00+00:00\"`}),_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:` \"end\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-08-01T00:00:00+00:00\"`})]}),`\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:` \"scope\"`}),_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:` \"type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"team\"`}),_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:` \"team\"`}),_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:`\"7f3c1e28-9b4d-4a61-8e52-0c7d6b5a4f39\"`}),_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:` \"name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Marketing\"`})]}),`\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:` \"budget\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`10000`}),_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:` \"used\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`8800`}),_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:` \"remaining\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1200`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`Die Organisation hat noch `,_jsx(_components.code,{children:`8031`}),` Plan-Credits, aber vom Marketing-Budget sind `,_jsx(_components.code,{children:`1200`}),`\nübrig — dieser Key kann also nur `,_jsx(_components.code,{children:`1200`}),` davon ausgeben, plus die `,_jsx(_components.code,{children:`250`}),` von Budgets\nausgenommenen Top-up-Credits, insgesamt `,_jsx(_components.code,{children:`1450`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`ein-402-vorhersagen-und-diagnostizieren`,children:`Ein 402 vorhersagen und diagnostizieren`}),`\n`,_jsxs(_components.p,{children:[_jsxs(_components.strong,{children:[_jsx(_components.code,{children:`available`}),` ist die Vorhersage.`]}),` Ein Job, dessen `,_jsx(_components.code,{children:`estimated_credits`}),` höchstens\n`,_jsx(_components.code,{children:`available`}),` betragen, wird nicht mit einem Credit-`,_jsx(_components.code,{children:`402`}),` abgelehnt, und umgekehrt bedeutet\nso ein `,_jsx(_components.code,{children:`402`}),`, dass die Schätzung `,_jsx(_components.code,{children:`available`}),` überschritten hat — bei `,_jsx(_components.strong,{children:`beidem`}),` die Zahl\ndes Credentials, nicht die der Organisation. Eine Ausnahme: ein `,_jsx(_components.strong,{children:`operativer Fehler in\nder Abbuchung selbst`}),` (etwa eine gestörte Saldo-Abfrage) wird unabhängig vom Regime als\ngenerisches `,_jsx(_components.a,{href:`/de/guides/errors#insufficient_credits`,children:_jsx(_components.code,{children:`insufficient_credits`})}),` gemeldet,\nohne etwas über `,_jsx(_components.code,{children:`available`}),` zu beweisen — ein schlichtes `,_jsx(_components.code,{children:`insufficient_credits`}),`, wo du\neinen team-spezifischen Code erwartet hättest, kann also vorübergehend sein; versuche es\nerneut, bevor du es als erschöpften Stand behandelst.`]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`Die Vorhersage gilt nur, solange sich der Credit- und Budget-Zustand zwischen dem Lesen\nund dem Absenden nicht ändert. Ein anderes Credential derselben Organisation, das ausgibt,\nein ablaufendes Top-up-Lot, eine Abo-Änderung, ein geändertes Team-Budget oder ein Key,\nder einem anderen Team zugewiesen wird, können `,_jsx(_components.code,{children:`available`}),` verschieben — und sogar\n`,_jsx(_components.code,{children:`scope.type`}),` und damit den Fehlercode ändern — ohne dass du selbst etwas ausgegeben\nhast.\n`,_jsx(_components.a,{href:`/de/guides/errors#subscription_inactive`,children:_jsx(_components.code,{children:`subscription_inactive`})}),` ist ein separates\n`,_jsx(_components.code,{children:`402`}),` und hat mit diesem Vergleich nichts zu tun.`]})}),`\n`,_jsxs(_components.p,{children:[`Wenn ein Absenden abgelehnt wird, erklärt `,_jsx(_components.code,{children:`scope`}),` es:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsxs(_components.strong,{children:[_jsx(_components.code,{children:`scope.type`}),` nennt das Budget-Regime, und das wählt den Fehlercode aus`]}),` (abgesehen\nvom operativen Fallback oben) — siehe die Tabelle oben. Es sagt dir `,_jsx(_components.strong,{children:`nicht`}),`, welcher\nStand erschöpft war: ein Key im\n`,_jsx(_components.code,{children:`team`}),`-Regime erhält `,_jsx(_components.code,{children:`insufficient_team_credits`}),` auch dann, wenn der Plan-Pool der\nOrganisation und nicht das Team-Budget aufgebraucht war.`]}),`\n`,_jsxs(_components.li,{children:[`Um unter einem begrenzten Regime (`,_jsx(_components.code,{children:`team`}),` oder `,_jsx(_components.code,{children:`unallocated`}),`) die tatsächliche Ursache zu\nfinden, vergleiche `,_jsx(_components.code,{children:`plan_credits`}),` mit `,_jsx(_components.code,{children:`scope.remaining`}),` — der kleinere Wert begrenzt\n`,_jsx(_components.code,{children:`spendable_plan_credits`}),`. Unter `,_jsx(_components.code,{children:`org`}),` ist `,_jsx(_components.code,{children:`scope.remaining`}),` `,_jsx(_components.code,{children:`null`}),` und `,_jsx(_components.code,{children:`plan_credits`}),`\nist die einzige mögliche Ursache.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`remaining: 0`}),` bedeutet, dass dieser Bucket für die aktuelle `,_jsx(_components.code,{children:`period`}),` vollständig\nausgegeben ist. Es ist `,_jsx(_components.strong,{children:`keine`}),` Voraussetzung für den Fehler: ein Bucket mit\n`,_jsx(_components.code,{children:`remaining: 100`}),` und ohne Top-ups lehnt einen Job für `,_jsx(_components.code,{children:`200`}),` weiterhin ab.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`Ein Key ohne Team in einer Organisation, deren Plan-Pool vollständig an Teams zugewiesen\nist, meldet also `,_jsx(_components.code,{children:`available: 0`}),` mit `,_jsx(_components.code,{children:`scope.type: \"unallocated\"`}),` und `,_jsx(_components.code,{children:`remaining: 0`}),` — jedes\nAbsenden, das Credits kostet, wird mit `,_jsx(_components.code,{children:`insufficient_unallocated_credits`}),` abgelehnt, bis ein Budget gesenkt\nwird, der Key einem Team mit Spielraum zugewiesen wird oder Top-ups gekauft werden. Siehe\n`,_jsx(_components.a,{href:`/de/guides/errors#insufficient_team_credits`,children:`Fehler`}),` für den Umgang mit jedem Code.`]})]})}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":"Credits abrufen","description":"Lies den Credit-Stand, den dieser API-Key ausgeben kann.","openapi":"api-reference/openapi.json GET /credits","href":"/de/api-reference/account/credits"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Credential-verfügbar vs. organisationsweit","slug":"credential-verfügbar-vs-organisationsweit","depth":2,"children":[]},{"title":"Das Budget-Regime (scope)","slug":"das-budget-regime-scope","depth":2,"children":[]},{"title":"Ein 402 vorhersagen und diagnostizieren","slug":"ein-402-vorhersagen-und-diagnostizieren","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Usage"],"summary":"Read the credit balance this API key can spend","description":"Lies den Credit-Stand, den dieser API-Key ausgeben kann.","operationId":"read_credits_credits_get","responses":{"200":"56f0e1bb-5d46-42ba-b3a3-6ef5ad94088c","401":"799f0221-d074-4fa8-9dd3-f857c21d7a5e","402":"dc4638d0-1838-4b67-801b-7416361f2b39","403":"6c6ee31f-94f4-4e87-a159-803f0fae2742","404":"135dca67-9dcc-4a90-9d0a-b8c357ab4a51","422":"9ebf64c3-1496-4647-bd58-a92f50e1c49c","429":"944beaff-1625-4922-a656-e07c8bc9f9e3","500":"61e36723-b8a8-4438-b107-26243e830733"},"method":"get","type":"path","servers":["a08679d8-4c66-4164-bad0-0564dfe6f3df"],"security":["8098c6f5-b81c-4b34-bd5b-3b5f75d9bd79"],"path":"/credits","baseUrlOptions":["https://api.samsa.ai/public/v1"],"title":"Read the credit balance this API key can spend","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"responses":{"56f0e1bb-5d46-42ba-b3a3-6ef5ad94088c":{"description":"Successful Response","content":{"application/json":{"schema":{"properties":{"available":{"type":"integer","title":"Available","description":"Total credits the calling credential can spend right now — the sum of `spendable_plan_credits` and `topup_credits`. Capped by the credential's team budget bucket (see `scope`), so it can be lower than the organization-wide `plan_credits`.","examples":[1450],"isRequired":true,"uniqueKey":"available","typeLabel":"integer"},"spendable_plan_credits":{"type":"integer","title":"Spendable Plan Credits","description":"Plan-pool credits the calling credential can spend right now: `plan_credits` capped by `scope.remaining`. Equal to `plan_credits` when no team budget applies.","examples":[1200],"isRequired":true,"uniqueKey":"spendable_plan_credits","typeLabel":"integer"},"plan_credits":{"type":"integer","title":"Plan Credits","description":"The ORGANIZATION's remaining monthly subscription-pool credits — not necessarily all spendable by this credential (see `spendable_plan_credits`). 0 when the plan pool is exhausted or the subscription is canceled and past its period end (top-up credits stay spendable).","examples":[1200],"isRequired":true,"uniqueKey":"plan_credits","typeLabel":"integer"},"topup_credits":{"type":"integer","title":"Topup Credits","description":"Remaining credits from valid (non-expired) top-up purchases. Top-ups are exempt from team budgets, so they are always fully spendable by any credential of the organization.","examples":[250],"isRequired":true,"uniqueKey":"topup_credits","typeLabel":"integer"},"period":{"properties":{"start":{"type":"string","format":"date-time","title":"Start","examples":["2026-07-01T00:00:00+00:00"],"isRequired":true,"uniqueKey":"period.start","typeLabel":"string\u003cdate-time>"},"end":{"type":"string","format":"date-time","title":"End","examples":["2026-08-01T00:00:00+00:00"],"isRequired":true,"uniqueKey":"period.end","typeLabel":"string\u003cdate-time>"}},"type":"object","required":["start","end"],"title":"BillingPeriod","description":"The org subscription's current billing-period bounds (ISO-8601).","isRequired":true,"uniqueKey":"period","typeLabel":"BillingPeriod · object"},"scope":{"properties":{"type":{"type":"string","enum":["org","team","unallocated"],"title":"PublicCreditsScopeType","description":"`org` — the organization has no ACTIVE teams (the common case; soft-deleted teams do not count), or it is a system organization exempt from team budgeting; either way the whole plan pool is available and `budget`/`used`/`remaining` are `null` because no cap exists. `team` — the credential is bound to an active team with its own monthly budget. `unallocated` — the credential spends the part of the plan pool that is NOT reserved for any team (credentials with no team, or bound to a team without a budget).","examples":["unallocated"],"isRequired":true,"uniqueKey":"scope.type","typeLabel":"enum\u003cstring>"},"team":{"oneOf":[{"type":"object","title":"PublicCreditsTeamRef","description":"The team the credential is bound to, or `null` when it is bound to none. Present on `type=unallocated` too when the bound team has no budget of its own.","required":["id","name"],"properties":{"id":{"type":"string","format":"uuid","title":"Id","isRequired":true,"uniqueKey":"scope.team.oneOf.0.id","typeLabel":"string\u003cuuid>"},"name":{"type":"string","title":"Name","examples":["Marketing"],"isRequired":true,"uniqueKey":"scope.team.oneOf.0.name","typeLabel":"string"}},"uniqueKey":"scope.team.oneOf.0","typeLabel":"PublicCreditsTeamRef · object"},{"type":"null","description":"The team the credential is bound to, or `null` when it is bound to none. Present on `type=unallocated` too when the bound team has no budget of its own.","uniqueKey":"scope.team.oneOf.1","typeLabel":"null"}],"uniqueKey":"scope.team","typeLabel":"PublicCreditsTeamRef · object | null"},"budget":{"oneOf":[{"type":"integer","title":"Budget","description":"Credits allocated to this bucket for the current billing period. `null` for `type=org` (no cap). For `unallocated` this is the monthly plan allocation minus the sum of all active team budgets, floored at 0 (`max(0, …)` — team allocations can exceed the plan pool).","example":2000,"uniqueKey":"scope.budget.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Budget","description":"Credits allocated to this bucket for the current billing period. `null` for `type=org` (no cap). For `unallocated` this is the monthly plan allocation minus the sum of all active team budgets, floored at 0 (`max(0, …)` — team allocations can exceed the plan pool).","example":2000,"uniqueKey":"scope.budget.oneOf.1","typeLabel":"null"}],"uniqueKey":"scope.budget","typeLabel":"integer | null"},"used":{"oneOf":[{"type":"integer","title":"Used","description":"Credits already spent from this bucket in the current billing period, net of refunds. `null` for `type=org`.","example":500,"uniqueKey":"scope.used.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Used","description":"Credits already spent from this bucket in the current billing period, net of refunds. `null` for `type=org`.","example":500,"uniqueKey":"scope.used.oneOf.1","typeLabel":"null"}],"uniqueKey":"scope.used","typeLabel":"integer | null"},"remaining":{"oneOf":[{"type":"integer","title":"Remaining","description":"Headroom left in this bucket (`budget - used`, floored at 0) — the ceiling this credential's plan-pool spend is capped at. `null` for `type=org` (no cap).","example":1500,"uniqueKey":"scope.remaining.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Remaining","description":"Headroom left in this bucket (`budget - used`, floored at 0) — the ceiling this credential's plan-pool spend is capped at. `null` for `type=org` (no cap).","example":1500,"uniqueKey":"scope.remaining.oneOf.1","typeLabel":"null"}],"uniqueKey":"scope.remaining","typeLabel":"integer | null"}},"type":"object","required":["type"],"title":"PublicCreditsScope","description":"The credit bucket the calling credential spends from (SAM-1029).\n\nOrganizations can reserve parts of their monthly plan pool for teams. A\ncredential (API key or OAuth connection) spends from exactly ONE bucket, and\nonly that bucket's headroom is available to it — which is why `available`\ncan be lower than the organization-wide `plan_credits`. The shortfall rule\nis `cost > available` (`spendable_plan_credits + topup_credits`): a submit\nis refused with an insufficient-credit 402 when the deduction,\nre-evaluating the same numbers at execution time, finds the estimated cost\nabove `available` — `insufficient_credits` under the uncapped `org` regime,\n`insufficient_team_credits` under `team`, and\n`insufficient_unallocated_credits` under `unallocated` (operational\nfailures inside the deduction fall back to the generic\n`insufficient_credits`, whatever the regime). This response is a\npoint-in-time snapshot, not a reservation: concurrent spends, top-up lots\nexpiring, a canceled subscription's period ending, or a degraded balance\nlookup can make the deduction-time numbers differ from the ones reported\nhere, and other checks can reject a request regardless of credits.\n`type` names the budget regime and selects which of those codes a balance\nshortfall raises — it does not say which balance ran out: under a capped\nregime the smaller of `plan_credits` and `remaining` limits\n`spendable_plan_credits`.\n`remaining: 0` means this bucket has no plan-pool headroom left for the\ncurrent period (spent down, or never allocated any); it is NOT a\nprecondition of the error — a bucket with `remaining: 100` and no top-ups\nstill refuses a job costing 200.","isRequired":true,"uniqueKey":"scope","typeLabel":"PublicCreditsScope · object"}},"type":"object","required":["available","spendable_plan_credits","plan_credits","topup_credits","period","scope"],"title":"PublicCreditsResponse","description":"``GET /credits`` body — what the CALLING credential can spend (ADR §10, SAM-1029).\n\nTwo kinds of number:\n\n* ``available`` / ``spendable_plan_credits`` answer \"what can THIS API key or\n OAuth connection spend right now\" — capped by its team budget bucket\n (``scope``), so a job estimated at or below ``available`` is not rejected\n with ``insufficient_team_credits`` / ``insufficient_unallocated_credits``.\n* ``plan_credits`` / ``topup_credits`` are the ORGANIZATION-wide balances.\n\nAll amounts are balances (not allocations), and\n``available == spendable_plan_credits + topup_credits`` always holds, as does\n``spendable_plan_credits \u003c= plan_credits`` (they are equal whenever no team\nbudget applies).","uniqueKey":"","typeLabel":"PublicCreditsResponse · object"},"examples":{"Example":{"title":"Example","value":{"available":1450,"spendable_plan_credits":1200,"plan_credits":1200,"topup_credits":250,"period":{"start":"2026-07-01T00:00:00+00:00","end":"2026-08-01T00:00:00+00:00"},"scope":{"type":"unallocated","team":{"id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","name":"Marketing"},"budget":2000,"used":500,"remaining":1500}}}},"exampleType":"generated"}},"exampleType":"generated"},"799f0221-d074-4fa8-9dd3-f857c21d7a5e":{"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"},"dc4638d0-1838-4b67-801b-7416361f2b39":{"description":"Insufficient credits or inactive subscription.","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"},"6c6ee31f-94f4-4e87-a159-803f0fae2742":{"description":"The API key lacks the required scope.","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"},"135dca67-9dcc-4a90-9d0a-b8c357ab4a51":{"description":"Resource 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"},"9ebf64c3-1496-4647-bd58-a92f50e1c49c":{"description":"Request validation failed.","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"},"944beaff-1625-4922-a656-e07c8bc9f9e3":{"description":"Rate limit 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"},"61e36723-b8a8-4438-b107-26243e830733":{"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":{"8098c6f5-b81c-4b34-bd5b-3b5f75d9bd79":{"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":{"a08679d8-4c66-4164-bad0-0564dfe6f3df":{"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":"Credits abrufen - Samsa","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/api-reference/account/credits","matchLevel":1},"de":{"href":"/de/api-reference/account/credits","matchLevel":0},"fr":{"href":"/fr/api-reference/account/credits","matchLevel":1},"it":{"href":"/it/api-reference/account/credits","matchLevel":1}}},"lastModified":"2026-08-12T20:57:33.776Z","originalFileLocation":"de/api-reference/account/credits.mdx","locale":"de"},"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=\"Lies den Credit-Stand, den dieser API-Key ausgeben kann.\">\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=\"Credits abrufen - Samsa\">\u003cmeta data-mint-head property=\"og:description\" content=\"Lies den Credit-Stand, den dieser API-Key ausgeben kann.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Samsa\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.samsa.ai/de/api-reference/account/credits\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://samsa-6b52d36f.mintlify.app/_mintlify/api/og/v2?division=Konto+%26+Nutzung\u0026amp;title=Credits+abrufen\u0026amp;description=Lies+den+Credit-Stand%2C+den+dieser+API-Key+ausgeben+kann.\u0026amp;theme=bea4a9a10b0b9a420fea38c2\u0026amp;signature=c9ce5fd6c52b7a7241b387ee1684a246b82c2a275a81c0d3173a777d53f4c5a9\">\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=\"Credits abrufen - Samsa\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Lies den Credit-Stand, den dieser API-Key ausgeben kann.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://samsa-6b52d36f.mintlify.app/_mintlify/api/og/v2?division=Konto+%26+Nutzung\u0026amp;title=Credits+abrufen\u0026amp;description=Lies+den+Credit-Stand%2C+den+dieser+API-Key+ausgeben+kann.\u0026amp;theme=bea4a9a10b0b9a420fea38c2\u0026amp;signature=c9ce5fd6c52b7a7241b387ee1684a246b82c2a275a81c0d3173a777d53f4c5a9\">\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/de/api-reference/account/credits\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/de/api-reference/account/credits.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"de\" href=\"https://docs.samsa.ai/de/api-reference/account/credits\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docs.samsa.ai/api-reference/account/credits\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"fr\" href=\"https://docs.samsa.ai/fr/api-reference/account/credits\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"it\" href=\"https://docs.samsa.ai/it/api-reference/account/credits\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docs.samsa.ai/api-reference/account/credits\">\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/de/api-reference/account/credits#webpage\",\"url\":\"https://docs.samsa.ai/de/api-reference/account/credits\",\"name\":\"Credits abrufen\",\"description\":\"Lies den Credit-Stand, den dieser API-Key ausgeben kann.\",\"dateModified\":\"2026-08-12T20:57:33.776Z\",\"isPartOf\":{\"@id\":\"https://docs.samsa.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.samsa.ai/de/api-reference/account/credits#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.samsa.ai/de/api-reference/account/credits#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Endpunkte\",\"item\":\"https://docs.samsa.ai/de/api-reference/images/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Konto \u0026 Nutzung\",\"item\":\"https://docs.samsa.ai/de/api-reference/account/overview\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Credits abrufen\",\"item\":\"https://docs.samsa.ai/de/api-reference/account/credits\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.samsa.ai/de/api-reference/account/credits#apireference\",\"headline\":\"Credits abrufen\",\"name\":\"Credits abrufen\",\"description\":\"Lies den Credit-Stand, den dieser API-Key ausgeben kann.\",\"url\":\"https://docs.samsa.ai/de/api-reference/account/credits\",\"mainEntityOfPage\":{\"@id\":\"https://docs.samsa.ai/de/api-reference/account/credits#webpage\"},\"dateModified\":\"2026-08-12T20:57:33.776Z\",\"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\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","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/account/credits"}]},{"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"}]}]},"tabs":[{"tab":"Dokumentation","pages":[{"title":"Dokumentation","href":"/de"}]},{"tab":"API-Referenz","groups":[{"group":"Übersicht","pages":[{"title":"Samsa API","href":"/de/api"},{"title":"API-Referenz","href":"/de/api-reference/introduction"}]},{"group":"Endpunkte","pages":[{"group":"Bildgenerierung","pages":[{"title":"Bildgenerierung","sidebarTitle":"Übersicht","href":"/de/api-reference/images/overview"},{"title":"Bilder generieren","openapi":"api-reference/openapi.json POST /images/generations","href":"/de/api-reference/images/generate"},{"title":"Eine Bildgenerierung abrufen","openapi":"api-reference/openapi.json GET /images/generations/{generation_id}","href":"/de/api-reference/images/get-generation"},{"title":"Bild-Engines auflisten","openapi":"api-reference/openapi.json GET /images/models","href":"/de/api-reference/images/list-engines"}]},{"group":"Bild-Uploads","pages":[{"title":"Bild-Uploads","sidebarTitle":"Übersicht","href":"/de/api-reference/uploads/overview"},{"title":"Einen Bild-Upload vorbereiten","openapi":"api-reference/openapi.json POST /images/uploads/prepare","href":"/de/api-reference/uploads/prepare"},{"title":"Einen Bild-Upload abschließen","openapi":"api-reference/openapi.json POST /images/uploads/{image_id}/complete","href":"/de/api-reference/uploads/complete"}]},{"group":"Bildbearbeitung","pages":[{"title":"Bildbearbeitung","sidebarTitle":"Übersicht","href":"/de/api-reference/edits/overview"},{"title":"Ein Bild bearbeiten","openapi":"api-reference/openapi.json POST /images/edits","href":"/de/api-reference/edits/create"},{"title":"Eine Bildbearbeitung abrufen","openapi":"api-reference/openapi.json GET /images/edits/{edit_id}","href":"/de/api-reference/edits/get-edit"}]},{"group":"Bildoperationen","pages":[{"title":"Bildoperationen","sidebarTitle":"Übersicht","href":"/de/api-reference/image-ops/overview"},{"title":"Bilder transformieren (img2img)","openapi":"api-reference/openapi.json POST /images/img2img","href":"/de/api-reference/image-ops/img2img"},{"title":"Einen img2img-Job abrufen","openapi":"api-reference/openapi.json GET /images/img2img/{img2img_id}","href":"/de/api-reference/image-ops/get-img2img"},{"title":"Variationen generieren","openapi":"api-reference/openapi.json POST /images/variations","href":"/de/api-reference/image-ops/variations"},{"title":"Einen Variations-Job abrufen","openapi":"api-reference/openapi.json GET /images/variations/{variation_id}","href":"/de/api-reference/image-ops/get-variations"},{"title":"Ein Bild hochskalieren","openapi":"api-reference/openapi.json POST /images/upscales","href":"/de/api-reference/image-ops/upscale"},{"title":"Einen Upscale-Job abrufen","openapi":"api-reference/openapi.json GET /images/upscales/{upscale_id}","href":"/de/api-reference/image-ops/get-upscale"},{"title":"Ein Bild resizen","openapi":"api-reference/openapi.json POST /images/resizes","href":"/de/api-reference/image-ops/resize"},{"title":"Einen Resize-Job abrufen","openapi":"api-reference/openapi.json GET /images/resizes/{resize_id}","href":"/de/api-reference/image-ops/get-resize"},{"title":"Einen Hintergrund entfernen","openapi":"api-reference/openapi.json POST /images/background-removals","href":"/de/api-reference/image-ops/remove-background"},{"title":"Einen Hintergrundentfernungs-Job abrufen","openapi":"api-reference/openapi.json GET /images/background-removals/{background_removal_id}","href":"/de/api-reference/image-ops/get-background-removal"},{"title":"Ein Bild vektorisieren","openapi":"api-reference/openapi.json POST /images/vectorizations","href":"/de/api-reference/image-ops/vectorize"},{"title":"Einen Vektorisierungs-Job abrufen","openapi":"api-reference/openapi.json GET /images/vectorizations/{vectorization_id}","href":"/de/api-reference/image-ops/get-vectorization"}]},{"group":"Videogenerierung","pages":[{"title":"Videogenerierung","sidebarTitle":"Übersicht","href":"/de/api-reference/videos/overview"},{"title":"Ein Video generieren","openapi":"api-reference/openapi.json POST /videos/generations","href":"/de/api-reference/videos/generate"},{"title":"Eine Videogenerierung abrufen","openapi":"api-reference/openapi.json GET /videos/generations/{generation_id}","href":"/de/api-reference/videos/get-generation"},{"title":"Video-Engines auflisten","openapi":"api-reference/openapi.json GET /videos/models","href":"/de/api-reference/videos/list-engines"}]},{"group":"Prompt-Verbesserung","pages":[{"title":"Prompt-Verbesserung","sidebarTitle":"Übersicht","href":"/de/api-reference/prompts/overview"},{"title":"Einen Prompt verbessern","openapi":"api-reference/openapi.json POST /prompts/improve","href":"/de/api-reference/prompts/improve"}]},{"group":"Modelltraining","pages":[{"title":"Modelltraining","sidebarTitle":"Übersicht","href":"/de/api-reference/model-training/overview"},{"title":"Ein Modell erstellen","openapi":"api-reference/openapi.json POST /models","href":"/de/api-reference/model-training/create"},{"title":"Einen Modell-Upload vorbereiten","openapi":"api-reference/openapi.json POST /models/prepare","href":"/de/api-reference/model-training/prepare"},{"title":"Einen Modell-Upload abschließen","openapi":"api-reference/openapi.json POST /models/{model_id}/complete","href":"/de/api-reference/model-training/complete"},{"title":"Modellstatus abrufen","openapi":"api-reference/openapi.json GET /models/{model_id}/status","href":"/de/api-reference/model-training/status"}]},{"group":"Modelle","pages":[{"title":"Modelle","sidebarTitle":"Übersicht","href":"/de/api-reference/models/overview"},{"title":"Modelle auflisten","openapi":"api-reference/openapi.json GET /models","href":"/de/api-reference/models/list"},{"title":"Ein Modell abrufen","openapi":"api-reference/openapi.json GET /models/{model_id}","href":"/de/api-reference/models/get"},{"title":"Ein Modell aktualisieren","openapi":"api-reference/openapi.json PATCH /models/{model_id}","href":"/de/api-reference/models/update"},{"title":"Ein Modell löschen","openapi":"api-reference/openapi.json DELETE /models/{model_id}","href":"/de/api-reference/models/delete"}]},{"group":"Konto \u0026 Nutzung","pages":[{"title":"Konto \u0026 Nutzung","sidebarTitle":"Übersicht","href":"/de/api-reference/account/overview"},{"title":"Aktuellen Key abrufen (me)","description":"Introspiziere den authentifizierten Key, seine Organisation und die verfügbaren Credits.","openapi":"api-reference/openapi.json GET /me","href":"/de/api-reference/account/me"},{"title":"Credits abrufen","openapi":"api-reference/openapi.json GET /credits","href":"/de/api-reference/account/credits"},{"title":"Nutzung abrufen","description":"Lies die API-Nutzung der Organisation, gruppiert nach Aktion oder Tag.","openapi":"api-reference/openapi.json GET /usage","href":"/de/api-reference/account/usage"}]}]}]},{"tab":"MCP server","pages":[{"title":"MCP server","href":"/de/mcp-server"}]},{"tab":"Inhaltsverifizierung","pages":[{"title":"Inhaltsverifizierung","href":"/de/content-verification/overview"}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/de/changelog"}]}]},{"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"}]}]},"pages":[{"title":"fr","href":"/fr/api-reference/account/credits"}]},{"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/account/credits"}]}]},"title":"Credits abrufen - Samsa","buildId":"dpl_HcHmUS6i3UwswnTHJUEdcTtwfdTQ","deploymentId":"dpl_HcHmUS6i3UwswnTHJUEdcTtwfdTQ","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-BRm_l__d.js","utils-f1l1Oc-G.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-BlhqDhJO.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-DHCB7rsC.js","snippetPresets-CYXLx6Hv.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-B78P2dEq.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-C4YLPVAh.js","shallow-vlLnTDkQ.js","getApiPlaygroundDisplay-D_98hhvf.js","CodeSnippet-DtnZHGqq.js","CodeSnippets-CLFb8KJt.js","Page-kQh739Uz.js","getPastedJson-Cq-zlbnU.js","icon-sN3t983t.js","MethodPill-P_YQ2s09.js","DuplicateIcon-BVzyNsGJ.js","createIcon-B3jqgqC6.js","DynamicMarkdown-Crwq6WG_.js","SectionHeading-C7pGS2Bb.js","axios-vUo_bRtp.js","Markdown-BuPH8yuW.js","clsx-CCOYKgaU.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-BnkC_6oA.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BM4S31-f.js"]}