api & mcp

Use promptarium from Claude, Cursor or your own code. Searching the prompt library is free. Generating uses your credits, at the same prices as the studio.

get your API key

Connect an AI app (MCP)

The server address is https://promptarium.app/mcp. Add it to any app that takes MCP servers over HTTP, with your key in the Authorization header. Without a key the library tools still work.

Claude Code

claude mcp add --transport http promptarium https://promptarium.app/mcp --header "Authorization: Bearer YOUR_KEY"

Cursor and other apps

{
  "mcpServers": {
    "promptarium": {
      "url": "https://promptarium.app/mcp",
      "headers": { "Authorization": "Bearer YOUR_KEY" }
    }
  }
}

Then ask for what you want, for example: "find the most viewed Seedance UGC prompts and make the best one into a 5 second video".

tool	what it does	key
`search_prompts`	Search the prompt library by words, model and type. Sort by relevance, views or newest.	no
`get_prompt`	The full text of one prompt, with its result, creator and source post.	no
`list_models`	Every image and video model, its options and its price in credits.	no
`estimate_cost`	What a generation would cost with exact settings. Makes nothing.	no
`get_plans`	Plans and top-ups, with the links to buy them.	no
`generate_image`	Makes 1 to 4 images and waits for them.	yes
`generate_video`	Starts a video and returns its id.	yes
`get_generation`	Status of a generation and the link to its file. Can wait for it.	yes
`list_generations`	The account's latest images and videos.	yes
`get_balance`	Credits left and the current plan.	yes

REST API

Base address: https://promptarium.app/api/v1. Send your key as Authorization: Bearer YOUR_KEY. Answers are JSON. An error has an error message and a matching status code.

Search the prompt library

curl "https://promptarium.app/api/v1/prompts?q=ugc+skincare&type=video&limit=5"

Make an image

curl https://promptarium.app/api/v1/images \
  -H "Authorization: Bearer YOUR_KEY" -H "Content-Type: application/json" \
  -d '{"prompt": "a red fox in fresh snow, golden hour", "model": "Nano Banana 2", "aspect_ratio": "16:9", "wait": 45}'

Fields: prompt, model, aspect_ratio, resolution, quality, count (1 to 4), reference_images (https links, or ids of images you made here), max_credits, wait (seconds, up to 55).

Make a video

curl https://promptarium.app/api/v1/videos \
  -H "Authorization: Bearer YOUR_KEY" -H "Content-Type: application/json" \
  -d '{"prompt": "handheld selfie vlog on a rainy street, she laughs", "model": "Seedance 2.5", "duration": 5, "max_credits": 200}'

curl "https://promptarium.app/api/v1/generations/GENERATION_ID?wait=50" -H "Authorization: Bearer YOUR_KEY"

Fields: prompt, model, duration, aspect_ratio, resolution, audio, first_frame, last_frame, max_credits. Videos take 1 to 10 minutes, so ask for the generation until its status is done and it has a url.

All endpoints

endpoint	what it does	key
`GET /prompts`	Search the library. `q`, `model`, `type`, `sort`, `limit`, `offset`.	no
`GET /prompts/{id}`	One prompt in full. The id looks like `seedance-2/0001`.	no
`GET /libraries`	How many prompts each model's library holds.	no
`GET /models`	Every model with its options and price. `type=image` or `type=video`.	no
`POST /estimate`	The price of a generation with exact settings.	no
`GET /plans`	Plans and top-ups.	no
`GET /balance`	Credits and plan.	yes
`POST /images`	Make 1 to 4 images.	yes
`POST /videos`	Start a video.	yes
`GET /generations`	Your latest generations.	yes
`GET /generations/{id}`	One generation. `wait=50` waits up to 50 seconds for it.	yes

Prices and limits

The same credits and the same prices as the studio. GET /models lists every price and POST /estimate prices exact settings. Plans are on the pricing page.
Send max_credits and nothing is made if it would cost more.
A generation that fails gives its credits back on its own.
Up to 8 generations running at once per account, and 120 requests a minute per key.
The studio's rules apply: every prompt and reference image is checked before it reaches a model. See acceptable use.

Keys

Make and delete keys from the account menu in the studio, under "API & MCP". Up to 5 at a time.
A key is shown once. We only keep a scrambled copy, so we can't show it again.
A key can spend your credits and read your library. It can't buy anything or change your account.
Delete a key and it stops working at once.

The library's prompts

Every library prompt comes with its creator and a link to the original post. If you show a prompt somewhere else, keep the credit and link to its promptarium page.