Developer documentation

Build with PixelGenie.

Create images through REST. Plan, generate, and publish video series through REST or MCP.

Open API reference Set up MCP

Interactive API reference

Inspect every public route, request, response, and required scope.

OpenAPI YAML

Import the unified image and video contract into your preferred API tool.

MCP setup

Connect an MCP client and expose only the tools allowed by your key.

REST API

One API for images and videos.

Use one API key and one base URL. Each route checks its required scope.

Authentication

Create a key in Profile. Send it as a Bearer token.

Manage API keys

Scopes

Image routes use images:read and images:write. Video routes use series and video scopes.

Production base URL

https://api.pixelgenieai.com/api/v1

Mutating API requests require an Idempotency-Key. This key prevents duplicate jobs during retries.

MCP setup guide

Connect your AI client.

PixelGenie uses a stateless Streamable HTTP endpoint. The MCP server currently provides video and series tools.

1
Create a key
Open Profile and create an API key. Save the key when PixelGenie shows it.
2
Select access
Enable MCP access. Enable video and series automation for all current MCP tools.
3
Add the server
Add the endpoint and Authorization header to your MCP client.

MCP server values

{
  "pixelgenie": {
    "type": "streamable-http",
    "url": "https://api.pixelgenieai.com/api/v1/mcp",
    "headers": {
      "Authorization": "Bearer pg_live_REDACTED"
    }
  }
}

Add these values through your client's remote MCP server settings.

Test the connection

curl --request POST "https://api.pixelgenieai.com/api/v1/mcp" \
  --header "Authorization: Bearer $PIXELGENIE_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "initialize",
    "params": {
      "protocolVersion": "2025-03-26",
      "capabilities": {},
      "clientInfo": {"name": "setup-check", "version": "1.0.0"}
    }
  }'

Available MCP tools

Every tool also requires mcp:use.

Tool	Required scope	Purpose
plan_series	series:write	Create an editable AI series plan.
create_series	series:write	Create a series from an approved plan.
list_series	series:read	List saved series.
get_series	series:read	Read episodes, projects, and scenes.
generate_episode	video:write	Generate and assemble one episode.
regenerate_scene	video:write	Generate one scene again.
get_generation_status	video:read	Read episode and scene status.
share_series	series:write	Create a public share link.
get_series_download	series:read	Get the authenticated download URL.

Keep API keys outside source control. Create separate keys for development and production.