⚙️ API

Documentação da API

Integre o PromptShot AI aos seus próprios aplicativos. API REST simples com dados de formulário multipart.

Primeiros Passos

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.

Parâmetros

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

Resposta

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

Parâmetros

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

Resposta

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

Parâmetros

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

Resposta

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

Limites de Taxa

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