Generate Image

Generate production-ready images from text prompts. Every image is scored across 12 quality dimensions.

Request

curl -X POST https://api.princemarketing.ai/v1/generate/image \
  -H "Authorization: Bearer pk_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A minimalist product shot of wireless earbuds on white marble",
    "style": "photorealistic",
    "aspectRatio": "1:1",
    "qualityTier": "pro"
  }'

POST/v1/generate/image

Generate a quality-scored image from a text prompt.

prompt*

string

The image generation prompt. Be specific about subject, lighting, composition, and style.

style

stringdefault: photorealistic

Visual style preset.

aspectRatio

stringdefault: 1:1

Output aspect ratio. One of: 16:9, 9:16, 1:1, 4:3, 3:4.

qualityTier

stringdefault: pro

Minimum quality threshold. starter (7.0+), pro (8.0+), agency (8.5+).

Response

200 OK

{
  "type": "success",
  "data": {
    "imageUrl": "https://cdn.princemarketing.ai/gen/img_abc123.png",
    "refinedPrompt": "Wireless earbuds arranged on polished Carrara marble...",
    "score": {
      "aggregate": 8.7,
      "passed": true,
      "dimensions": [...],
      "feedback": "Strong product shot with clean composition."
    }
  },
  "meta": {
    "generationId": "gen_abc123",
    "creditsConsumed": 5,
    "duration_ms": 3420
  }
}

5 credits per image generation. The prompt is refined by Claude before generation for production-grade output.