Imagine Style Transfer API

Dokumentasi resmi Imagine Style Transfer API dari Maelyn API untuk mengubah gaya gambar menggunakan AI (anime, ghibli, cyberpunk, dll)

Base Information

  • BASE_URL_API: https://api.maelyn.eu/api
  • Path / Endpoint: /ai/image-to-image
  • Method: POST
  • Credit Usage: 10

Authentication

Gunakan header berikut pada setiap request:

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

Request Body

Endpoint ini digunakan untuk mengubah gaya (style) gambar menggunakan AI.

{
  "image_url": "https://example.com/image.jpg",
  "style": "ghibli",
  "prompt": "beautiful lighting",
  "negative_prompt": "low quality",
  "strength": 0.7,
  "steps": 50,
  "guidance": 7.5,
  "seed": 0,
  "scheduler": "euler",
  "output_format": "jpg"
}

Body Parameters

NameTypeRequiredDescription
image_urlstringYesURL gambar yang ingin diubah
stylestringNoStyle gambar (default: ghibli)
promptstringNoTambahan prompt custom
negative_promptstringNoPrompt negatif
strengthnumberNoTingkat perubahan (0 - 1, default: 0.7)
stepsnumberNoJumlah langkah render (1 - 100, default: 50)
guidancenumberNoGuidance scale (1 - 20, default: 7.5)
seednumberNoSeed random
schedulerstringNoScheduler (default: euler)
output_formatstringNoFormat output (jpg, png, webp)

Available Styles

Berikut beberapa style yang tersedia:

ghibli, anime, manga, cyberpunk, fantasy, watercolor, oil_painting,
pixel_art, sketch, comic, noir, cinematic, realistic, portrait,
chibi, kawaii, line_art, ink, pastel, neon, vaporwave, steampunk,
gothic, dark_fantasy, fantasy_portrait, mecha, sci_fi, clay,
3d_cartoon, low_poly, origami, ukiyo_e, renaissance, baroque,
impressionist, surreal, minimal, fashion, poster, game_art

Example Usage Minimum

{
  "image_url": "https://example.com/image.jpg",
  "style": "anime"
}

Success Response

{
  "success": true,
  "result": {
    "url": "https://cdn.maelyn.eu/styled-123456.jpg",
    "size": "512 KB",
    "sizeInBytes": 524288,
    "style": "anime",
    "model": "animagine-xl-v-3-1",
    "output_format": "jpeg",
    "strength": 0.7,
    "steps": 50,
    "guidance": 7.5,
    "scheduler": "euler"
  },
  "available_styles": ["ghibli", "anime", "..."]
}

Error Response

Invalid JSON

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

Missing Image URL

{
  "success": false,
  "error": "IMAGE_URL_REQUIRED",
  "message": "Field image_url wajib diisi"
}

Invalid Style

{
  "success": false,
  "error": "INVALID_STYLE",
  "message": "Style tidak tersedia",
  "available_styles": ["ghibli", "anime", "..."]
}

Image Fetch Failed

{
  "success": false,
  "error": "IMAGE_FETCH_FAILED",
  "message": "Gagal mengambil gambar dari URL"
}

Invalid Image Type

{
  "success": false,
  "error": "INVALID_IMAGE_TYPE",
  "message": "URL yang diberikan bukan file gambar"
}

Request Timeout

{
  "success": false,
  "error": "REQUEST_TIMEOUT",
  "message": "Server style image terlalu lama merespon"
}

Internal Server Error

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

Example Result (Preview)

AnimeMangaChibi
GhibliKawaiiCinematic

Playground