Generate Image

POST /api/v1/generate/

Create a new image generation task. Credits are deducted immediately when generation starts.

Authentication Required: This endpoint requires authentication via Token or API Key.

Request

Headers

Content-Type application/json
Authorization Token <your_token>

Body required

prompt required
string

Description of the image you want to generate. Max 1000 characters.

Example: "A beautiful sunset over the mountains"
size optional
string

Image size. Default is 1:1.

Possible values: [1:1, 3:2, 2:3]
Example: "1:1"
quality optional
string

All images are generated in top quality by default.

Note: Quality parameter is ignored - all images are high quality
Example: "hd" (or omit entirely)
style optional
string

Image style. Default is natural.

Possible values: [natural, vivid]
Example: "natural"

Example Request

{
  "prompt": "A beautiful sunset over the mountains",
  "size": "1:1",
  "style": "natural"
}

Responses

201 Request successful

Generation started successfully

{
  "success": true,
  "data": {
    "generation_id": "uuid-here",
    "status": "processing",
    "estimated_time": "15-30 seconds",
    "credits_used": 24,
    "credits_remaining": 76,
    "message": "Generation started successfully"
  }
}
402 Payment Required

Insufficient credits to complete the request

{
  "success": false,
  "error": "Insufficient credits. Need 24, have 10",
  "credits_needed": 24,
  "credits_balance": 10
}
400 Bad Request

Invalid request parameters

{
  "success": false,
  "error": "Prompt is required",
  "details": {
    "prompt": "This field is required"
  }
}

Credit Costs

Credit costs are based on image size (all images are high quality):

Size Credits
1:1 24
3:2 24
2:3 24

Important Notes

  • • Credits are deducted immediately when generation starts
  • • Credits are refunded if generation fails
  • • Generated images are stored for 30 days
  • • Maximum prompt length is 1000 characters
  • • Use the generation ID to check status and retrieve results