API and MCP · Early access
The same engine that runs AIGNCY Studio, over a REST API and an MCP server. Generate with PRISM-1, pull templates and models, read your vault and credits, and batch clean files.
Preview: names and fields may change before general release.
What do I have to work with this week?
aigncy_get_credit_balance()aigncy_list_models()aigncy_list_vault(type: "image", limit: 4)You have 4,200 credits and one model, Celeste. Your last four shots:
https://api.gncy.ai/v1/generate"model": "celeste", "template": "golden-hour", "outputs": 4
gen_01J9Z4K7 · queued
4 outputs · 9:16 · ready
Two ways in
MCP
Connect Studio to Claude, Cursor or any MCP client. Your agent can check credits, find templates, read your models and vault, and, next, run generations with your say-so.
aigncy_get_credit_balanceaigncy_list_modelsaigncy_search_templatesaigncy_list_vaultaigncy_get_generation_statusREST
Plain HTTPS and JSON with a bearer key. Start a generation, poll its status, pull the outputs into your own app, tool or pipeline.
POST /generateGET /generations/{id}GET /templatesGET /modelsGET /vaultMCP
Early access members get an API key and the MCP endpoint.
Paste the config into Claude Desktop, Claude Code or Cursor.
"Find me three golden hour templates" or "what did I make this week?"
{
"mcpServers": {
"aigncy": {
"type": "http",
"url": "<your AIGNCY MCP endpoint>",
"headers": {
"Authorization": "Bearer <your API key>"
}
}
}
}claude mcp add --transport http aigncy "<your AIGNCY MCP endpoint>" \
--header "Authorization: Bearer <your API key>"{
"mcpServers": {
"aigncy": {
"url": "<your AIGNCY MCP endpoint>",
"headers": { "Authorization": "Bearer <your API key>" }
}
}
}Tools
aigncy_get_credit_balanceEarly accessaigncy_list_modelsEarly accessaigncy_search_templatesEarly accessaigncy_list_vaultEarly accessaigncy_get_generation_statusEarly accessaigncy_generateNextaigncy_save_to_vaultNextaigncy_clean_batchNextREST quickstart
curl https://api.gncy.ai/v1/generate \
-H "Authorization: Bearer $AIGNCY_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "celeste",
"template": "golden-hour",
"outputs": 4,
"format": "9:16"
}'const res = await fetch("https://api.gncy.ai/v1/generate", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.AIGNCY_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
model: "celeste",
template: "golden-hour",
outputs: 4,
}),
});
const { id } = await res.json();import os, requests
res = requests.post(
"https://api.gncy.ai/v1/generate",
headers={"Authorization": f"Bearer {os.environ['AIGNCY_API_KEY']}"},
json={"model": "celeste", "template": "golden-hour", "outputs": 4},
)
print(res.json()["id"]){
"id": "gen_01J9Z4K7",
"status": "queued",
"model": "celeste",
"template": "golden-hour",
"outputs": 4
}What you can build with
A model and a template in, finished photos and short clips out. No prompts.
aigncy_generateSearch the catalogue. Each template sets pose, outfit, setting, light and camera.
aigncy_search_templatesThe AI models on your account, ready to drop into any template.
aigncy_list_modelsEverything you have made, by type and date, with output URLs.
aigncy_list_vaultYour balance before you run, so agents can plan their work.
aigncy_get_credit_balanceClear the metadata from a folder of your own files in one call.
aigncy_clean_batchEarly access
Tell us what you want to build and which client you use. We will send a key and the endpoint.