# Samsa API

> Developer documentation for the Samsa public API — image generation with trained models, Magic Edit, video generation, model training, and the MCP server.

## Docs

- [Get credits](https://docs.samsa.ai/api-reference/account/credits.md): Read the organization's remaining credit balance.
- [Get current key (me)](https://docs.samsa.ai/api-reference/account/me.md): Introspect the authenticated key, its organization, and available credits.
- [Account & Usage](https://docs.samsa.ai/api-reference/account/overview.md): Introspect the authenticated key, read the credit balance, and review API usage.
- [Get usage](https://docs.samsa.ai/api-reference/account/usage.md): Read the organization's API usage, grouped by action or day.
- [Edit an image (Magic Edit)](https://docs.samsa.ai/api-reference/edits/create.md): Submit a Magic Edit job — a source image plus a prompt, optionally masked and styled.
- [Get an image edit](https://docs.samsa.ai/api-reference/edits/get-edit.md): Poll a Magic Edit job for status and, once completed, the edited images.
- [Image Editing (Magic Edit)](https://docs.samsa.ai/api-reference/edits/overview.md): Edit an existing image with a prompt — with or without a mask — reusing your trained models.
- [Generate images](https://docs.samsa.ai/api-reference/images/generate.md): Submit an image-generation job — prompt plus optional trained models — and get a job id back.
- [Get an image generation](https://docs.samsa.ai/api-reference/images/get-generation.md): Poll an image-generation job for status and, once completed, the produced images.
- [Image Generation](https://docs.samsa.ai/api-reference/images/overview.md): Generate images from a prompt, optionally composing your organization's trained models.
- [API reference](https://docs.samsa.ai/api-reference/introduction.md): The Samsa public REST API — base URL, authentication, and conventions.
- [Complete a model upload](https://docs.samsa.ai/api-reference/model-training/complete.md): Finalize a prepared model after uploading its images to the presigned URLs.
- [Create a model](https://docs.samsa.ai/api-reference/model-training/create.md): Create a model from 1–10 reference images supplied as URLs or inline base64.
- [Model Training](https://docs.samsa.ai/api-reference/model-training/overview.md): Create custom models — style, object, person, or setting — from reference images.
- [Prepare a model upload](https://docs.samsa.ai/api-reference/model-training/prepare.md): Request presigned PUT URLs for a new model's reference images (two-step upload).
- [Get model status](https://docs.samsa.ai/api-reference/model-training/status.md): Poll a model's creation lifecycle status.
- [Delete a model](https://docs.samsa.ai/api-reference/models/delete.md): Soft-delete one of your organization's models.
- [Get a model](https://docs.samsa.ai/api-reference/models/get.md): Retrieve full detail for one of your organization's models.
- [List models](https://docs.samsa.ai/api-reference/models/list.md): List your organization's models, newest first, with category/status filters and paging.
- [Models](https://docs.samsa.ai/api-reference/models/overview.md): List, retrieve, update, and delete your organization's models.
- [Update a model](https://docs.samsa.ai/api-reference/models/update.md): Update the editable fields (name, default prompt) of one of your models.
- [Generate a video](https://docs.samsa.ai/api-reference/videos/generate.md): Submit a video job in image-to-video, text-to-video, or text-to-video-styled mode.
- [Get a video generation](https://docs.samsa.ai/api-reference/videos/get-generation.md): Poll a video-generation job for status and, once completed, the produced video.
- [List video engines](https://docs.samsa.ai/api-reference/videos/list-engines.md): The public video engine catalog — modes, durations, resolutions, and pricing per engine.
- [Video Generation](https://docs.samsa.ai/api-reference/videos/overview.md): Produce video from a start frame, from text, or from text styled with your trained models.
- [Local development](https://docs.samsa.ai/development.md): Preview and contribute to the Samsa API documentation locally with the Mintlify CLI.
- [Authentication](https://docs.samsa.ai/guides/authentication.md): Organization API keys, scopes, and the Bearer header every Samsa API request needs.
- [Errors](https://docs.samsa.ai/guides/errors.md): The Samsa API error envelope, every error code, and how to handle each one.
- [Pricing](https://docs.samsa.ai/guides/pricing.md): How API actions draw credits from your organization's pool, with cost tables for images, edits, models, and video.
- [Rate limits](https://docs.samsa.ai/guides/rate-limits.md): Per-key request limits, per-organization concurrency caps, the headers to watch, and how to back off.
- [Webhooks](https://docs.samsa.ai/guides/webhooks.md): Receive a signed callback when a job finishes, verify the signature, and handle retries.
- [Samsa API](https://docs.samsa.ai/index.md): Generate images, edit them, produce video, and train custom models — programmatically, from your organization's Samsa account.
- [MCP server](https://docs.samsa.ai/mcp.md): Connect Samsa to Claude, ChatGPT, and any MCP client — generate images with your trained models, Magic Edit, video, and credit checks as tools, over OAuth or an API key.
- [Quickstart](https://docs.samsa.ai/quickstart.md): Create an API key and generate your first image with a trained style model in five steps.

## OpenAPI Specs

- [openapi](https://docs.samsa.ai/api-reference/openapi.json)