⚙️ API

Documentazione API

Integra PromptShot AI nelle tue applicazioni. API REST semplice con dati di form multipart.

Introduzione

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.

Parametri

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

Risposta

{
  "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.

Parametri

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

Risposta

{
  "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.

Parametri

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

Risposta

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

Limiti di Utilizzo

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