Skip to main content

Your first image in five steps

Create an organization API key, submit a generation, and poll it to a finished asset — with copy-paste curl, Python, and TypeScript.

Three ways in

REST API

Generate, edit, transform, and train over plain HTTP.

MCP server

Drive the same tools from Claude, ChatGPT, Cursor, or n8n — one URL, nothing to install.

Content verification

Check whether an image or video was made with Samsa. Free, no key needed.

What you can build

Image generation

Prompt to image, composed with your organization’s trained models and color palettes.

Magic Edit

Edit an existing image from a prompt, with or without a mask.

Image operations

img2img, variations, resize, upscale, background removal, and vectorization.

Video generation

Video from a start frame, from text, or from text styled with your models.

Model training

Train style, object, person, and setting models from a handful of images.

Account & usage

Check a key, the credit balance it can spend, and your organization’s usage.

Before you build

Authentication

Organization keys, scopes, and the Bearer header every request needs.

Pricing

What each action costs in credits, and what happens when the pool runs out.

Rate limits

Per-key request rate, per-organization concurrency, and how to back off.

Errors

The error envelope, every code you can receive, and how to handle it.

Image inputs

How to supply source images — by image_id, https URL, or base64.

Changelog

New endpoints and MCP tools, newest first.
Every generation endpoint is asynchronous: a POST returns 202 Accepted with a job id, you poll the matching GET — or supply a webhook_url — and a completed job carries presigned URLs to the finished assets.