⚙️ واجهة برمجة التطبيقات

توثيق واجهة برمجة التطبيقات

قم بدمج PromptShot AI في تطبيقاتك الخاصة. واجهة برمجة تطبيقات REST بسيطة مع بيانات نموذج متعددة الأجزاء.

البدء

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.

المعاملات

Name	Type	Required	Description
`image`	File	مطلوب	Image file (JPEG, PNG, WebP — max 10MB)
`style`	string	اختياري	"detailed" \| "creative" \| "technical" \| "cinematic" (default: detailed)
`lang`	string	اختياري	ISO language code (default: en)

الاستجابة

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

المعاملات

Name	Type	Required	Description
`image`	File	مطلوب	Image file (JPEG, PNG, WebP — max 10MB)
`purpose`	string	اختياري	"general" \| "accessibility" \| "seo" \| "social" (default: general)
`lang`	string	اختياري	ISO language code (default: en)

الاستجابة

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

المعاملات

Name	Type	Required	Description
`subject`	string	مطلوب	Main subject or scene description
`style`	string	اختياري	Art style (e.g. "Cinematic", "Anime")
`mood`	string	اختياري	Mood or atmosphere
`platform`	string	اختياري	"Midjourney" \| "DALL-E 3" \| "Stable Diffusion"

الاستجابة

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

حدود المعدل

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