Generate a social media image from a description

Generates a square or vertical image suitable for social media. Costs 10 credits per successful generation. Failed calls do not deduct credits.

POST/v1/ai/image

Authorization

accessKey

x-access-key<token>

In: header

application/json

TypeScript Definitions

Use the request body type in TypeScript.

description*string

Length3 <= length <= 1500

aspectRatio?||

referenceImageUrl?string

Optional reference image URL. Gemini uses it as visual context (style, subject) for the generated output.

Formaturi

curl -X POST "https://api.postpeer.dev/v1/ai/image" \  -H "Content-Type: application/json" \  -d '{    "description": "string"  }'

{
  "success": true,
  "url": "http://example.com",
  "mimeType": "string",
  "creditsCharged": 0
}

{
  "success": true,
  "message": "string"
}

{
  "success": true,
  "message": "string"
}

{
  "success": true,
  "message": "string"
}