AI Image Generation API

Base Information

BASE_URL_API: https://api.maelyn.eu/api
Path / Endpoint: /ai/generate/v1/image
Method: POST
Credit Usage: 10
VIP Usage: true

Authentication

Gunakan header berikut pada setiap request:

x-maelyn-auth: YOUR_API_KEY
Content-Type: application/json

Request Body

Endpoint ini digunakan untuk membuat gambar dari teks (text-to-image).

{
  "prompt": "beautiful fantasy girl, ultra detailed, cinematic lighting",
  "resolution": "Portrait",
  "style": "Fantasy"
}

Body Parameters

Name	Type	Required	Description
`prompt`	`string`	Yes	Deskripsi gambar yang ingin dibuat
`resolution`	`string`	No	Resolusi gambar (`Portrait`, `Square`, `Wide`) (default: `Portrait`)
`style`	`string`	No	Style gambar (default: `Realistic Portraits`)

Resolution Options

Portrait → vertical_3_4
Square   → square
Wide     → horizontal_16_9

Available Styles

Berikut beberapa style yang tersedia:

Realistic Portraits, Fantasy, Pixar Characters

Example Usage Minimum

{
  "prompt": "cyberpunk girl neon city"
}

Success Response

{
  "success": true,
  "image": "https://image-storage.maelyn.eu/xxxxx.jpg",
  "images": [
    "https://image-storage.maelyn.eu/xxxxx.jpg"
  ],
  "total": 1,
  "task_id": "abc123",
  "resolution": "Portrait",
  "aspect": "vertical_3_4",
  "style": "Fantasy"
}

Error Response

Invalid JSON

{
  "success": false,
  "error": "INVALID_JSON",
  "message": "Body request harus berupa JSON"
}

Missing Prompt

{
  "success": false,
  "error": "PROMPT_REQUIRED",
  "message": "Field prompt wajib diisi"
}

Invalid Resolution

{
  "success": false,
  "error": "INVALID_RESOLUTION",
  "message": "Resolution tidak valid. Gunakan: Square, Wide, Portrait"
}

Invalid Style

{
  "success": false,
  "error": "INVALID_STYLE",
  "message": "Style tidak valid"
}

Request Timeout

{
  "success": false,
  "error": "DAVINCI_GENERATE_FAILED",
  "message": "Generate image timeout"
}

Internal Server Error

{
  "success": false,
  "error": "INTERNAL_SERVER_ERROR",
  "message": "Terjadi kesalahan pada sistem"
}

Example Result (Preview)


Fantasy	Realistic Portraits	Pixar Characters

Playground

OCR Canvas