# SDKs overview

> Open-source TypeScript and Python clients for the REST API, generated from its OpenAPI document. Which to pick, how to install, and what a key can do.

Kind: guide · ~2 min · Verified v0.237.0 · Next: [TypeScript SDK](https://pr-2197-stg.superartifacts.app/docs/sdks/typescript.md)

The SDKs are thin clients for the [REST API](https://pr-2197-stg.superartifacts.app/docs/reference/api.md), for developers writing their
own code. Both are generated from the API's OpenAPI document, so they cover every endpoint, and
both are open source under the MIT licence.

Solo and higher include REST API and SDK access. The paid-plan gate is currently in shadow mode: it records unpaid calls without refusing them. MCP and skills stay free.

## Which one to use

| You are | Use |
| --- | --- |
| Working through an agent such as Claude or Cursor | [MCP tools](https://pr-2197-stg.superartifacts.app/docs/reference/mcp.md), at `superartifacts.app/mcp` |
| Writing TypeScript or JavaScript on a server | [The TypeScript SDK](https://pr-2197-stg.superartifacts.app/docs/sdks/typescript.md) |
| Writing Python | [The Python SDK](https://pr-2197-stg.superartifacts.app/docs/sdks/python.md) |
| Writing any other language, or generating your own client | The [REST API](https://pr-2197-stg.superartifacts.app/docs/reference/api.md) |

Super Artifacts runs no model and takes no prompt to generate from. You bring the inference: make
the page with your own model, write it to a file, and publish the file; we host it.

The versioned operations have generated SDK methods; credential permissions still apply. Use [MCP for stored-secret approval](https://pr-2197-stg.superartifacts.app/docs/secrets.md). An SDK adds typed calls,
errors you can catch, idempotency keys for retried POSTs, iterators over paged reads, and the
round trip for uploading files.

## Install

```bash
npm install @superartifacts/sdk
```

```bash
pip install superartifacts
```

The TypeScript SDK has no runtime dependencies. Node 20.3+. It uses only the standard `fetch`, so other runtimes that provide it may work; only Node is tested. The Python SDK needs
Python 3.10 or newer.

## The key

Create a key in [Settings → API keys](https://superartifacts.app/settings/api-keys) and put it in
the `SUPERARTIFACTS_API_KEY` environment variable, which both SDKs read. A key can **read**, or
**read and write**; a read key that calls a write gets a `scope_required` error.

## Server side only

The API refuses any request carrying an `Origin` header, which browser cross-origin calls add, and a key on a
page is a leaked key. Call the SDKs from a server, a script or a scheduled job.

## Source and packages

- [GitHub: Superbelt/sdk](https://github.com/Superbelt/sdk)
- [npm: @superartifacts/sdk](https://www.npmjs.com/package/@superartifacts/sdk)
- [PyPI: superartifacts](https://pypi.org/project/superartifacts/)
