Build on top of PhotoGen. Access our programmatic REST API, integrate via the Model Context Protocol (MCP), or utilize OpenAPI 3.1 specifications to incorporate AI photography assets into your applications and agent workflows.
PhotoGen natively implements modern agentic web standards. You can negotiate markdown formats using standard HTTP headers or inspect machine-readable manifests:
Send Accept: text/markdown with any request to receive clean, parseable Markdown.
Inspect /llms.txt and /llms-full.txt for LLM system prompt context.
Handshake via /.well-known/mcp using JSON-RPC 2.0 or Streamable HTTP.
All PhotoGen REST endpoints return standard JSON responses with cache-control headers, ETags, and CORS enabled for browser & server-side access.
Retrieve paginated Lightroom and color grading preset packs with category filters, tags, and asset download URLs.
Query high-resolution photography captures, prompt parameters, lighting attributes, and Cloudinary CDN URLs.
Search and download responsive desktop (16:9, 21:9) and mobile (9:16) wallpaper assets.
Access technical articles on color theory, prompt engineering architectures, and photographic techniques.
Submit descriptive prompts to generate photographic assets with custom aspect ratios, style presets, and lighting models.
Execute MCP tools (tools/list, tools/call) via Streamable HTTP / JSON-RPC 2.0 for autonomous AI agents.
PhotoGen exposes native Model Context Protocol tools. AI assistants (such as Claude Desktop, ChatGPT, or autonomous agents) can connect to https://photogen2.vercel.app/api/mcp to discover and invoke tools:
Search PhotoGen's curated photographic gallery by keyword, mood, or camera style.
List available Lightroom presets, color profiles, and style attributes.
Get detailed curve parameters and installation metadata for a specific preset ID.
Find 4K desktop and mobile wallpapers matching resolution and aesthetic themes.
Query insights, tutorials, and color science guides from the PhotoGen journal.
Retrieve machine-readable API and tool schemas for PhotoGen platform services.
PhotoGen supports URL path versioning (/api/v1/*) and header-based negotiation via X-API-Version: 1.0.
Sunset and Deprecation HTTP headers.All API responses return standardized RFC rate-limiting headers so autonomous agents can self-throttle in real time:
RateLimit-Limit: 60RateLimit-Remaining: 59RateLimit-Reset: 60Retry-After: 60All error responses (4xx and 5xx) return machine-readable structured JSON (application/problem+json):