# Memes.ai Developer API

> Public REST API for creating and managing branded creative.

## Contract

- Base URL: `https://api.memes.media/v1`
- OpenAPI: `3.1.0`
- Implemented operations: 64
- Authentication: `Authorization: Bearer sk_live_<48 lowercase hex>` or `sk_test_<48 lowercase hex>`
- Test keys use a deterministic provider-free simulator with per-key one-hour state, fixture assets, no credits/quota, no provider calls, no outbound webhook delivery, and no canonical workspace access. Unsupported simulator mutations fail closed with `501 test_mode_not_supported`.
- Retry safety: every POST requires a caller-generated `Idempotency-Key: <opaque value>`. Live requests use body-fingerprinted admission and changed-body reuse returns `409 idempotency_conflict`; webhook creation uses a stable external id and safely recovers its signing secret on same-key retries.
- Abuse controls: weighted key, workspace, and IP fixed-window limits plus expensive-operation concurrency caps return `RateLimit-*` headers and stable `429 rate_limited` or `concurrency_limited` errors.
- Resource caps: public API creation is rejected once a workspace has 50 total Brand Kits; webhook endpoints are capped at 25 per workspace and disabled endpoints count.
- Webhook reads are side-effect free. Creation requires a public HTTPS destination and never accepts a wildcard event.

## Canonical resources

- [OpenAPI contract](https://studio.memes.media/developers/openapi.yaml): Authoritative operations, parameters, schemas, and responses.
- [API guide and generated endpoint index](https://studio.memes.media/developers/api-reference.md): Authentication, request lifecycle, examples, errors, and all implemented operations.
- [Full guide for LLMs](https://studio.memes.media/developers/llms-full.txt): Deterministic copy of the API guide.
- [Recipes](https://studio.memes.media/developers/recipes.md): Use-case cookbook.

- [Studio MCP connector](https://studio.memes.media/developers/mcp.md): Connect compatible AI apps to Studio using OAuth.
- [Studio agent skills](https://studio.memes.media/developers/skills.md): Install guided workflows for the Studio MCP connector.

## Implemented resource groups

- Social Publishing
- Generations
- Images
- Memes
- Videos
- Carousels
- Storyboards
- Brand Kits
- Prompt Enhancement
- Webhooks
- Account