⚙️ API

API Documentation

Integrate PromptShot AI into your own applications. Simple REST API with multipart form data.

Getting Started

The PromptShot AI API is available on the Pro and Business plans.

Base URL

https://promptshotai.com

Authentication (coming soon)

Authorization: Bearer YOUR_API_KEY

All endpoints accept multipart/form-data for file uploads or application/json for text-only endpoints.

POST/api/image-to-prompt

Generate an AI prompt from an uploaded image.

Parameters

Name	Type	Required	Description
`image`	File	Required	Image file (JPEG, PNG, WebP — max 10MB)
`style`	string	Optional	"detailed" \| "creative" \| "technical" \| "cinematic" (default: detailed)
`lang`	string	Optional	ISO language code (default: en)

Response

{
  "prompt": "A stunning sunset over rolling mountains...",
  "tags": ["landscape", "golden hour", "cinematic", "mountains"]
}

POST/api/tools/describe

Generate alt-text, SEO description, or social caption from an image.

Parameters

Name	Type	Required	Description
`image`	File	Required	Image file (JPEG, PNG, WebP — max 10MB)
`purpose`	string	Optional	"general" \| "accessibility" \| "seo" \| "social" (default: general)
`lang`	string	Optional	ISO language code (default: en)

Response

{
  "description": "A detailed description of the image...",
  "altText": "Short one-sentence alt text",
  "keywords": ["keyword1", "keyword2"]
}

POST/api/tools/enhance-prompt

Generate optimized prompts from structured text parameters.

Parameters

Name	Type	Required	Description
`subject`	string	Required	Main subject or scene description
`style`	string	Optional	Art style (e.g. "Cinematic", "Anime")
`mood`	string	Optional	Mood or atmosphere
`platform`	string	Optional	"Midjourney" \| "DALL-E 3" \| "Stable Diffusion"

Response

{
  "prompts": [
    { "label": "Simple", "prompt": "..." },
    { "label": "Detailed", "prompt": "..." },
    { "label": "Ultra", "prompt": "..." }
  ],
  "tips": ["tip1", "tip2"]
}

Rate Limits

Plan	Requests / Month	Max File Size
Free	100	5MB
Pro	10,000	10MB
Business	Unlimited	20MB

Need API Access?

Upgrade to Pro or Business to get your API key.

🚀 Upgrade Plan ✉️ Contact for Enterprise