Character AI Generate Image API

Dokumentasi resmi Character AI Generate Image API dari Maelyn API untuk membuat gambar AI dari prompt teks

Base Information

  • BASE_URL_API: https://api.maelyn.eu
  • Path / Endpoint: /ai/character/generate/image
  • Full URL: https://api.maelyn.eu/ai/character/generate/image
  • Method: POST
  • Credit Usage: 10

Authentication

Gunakan header berikut pada setiap request:

maelyn_auth: YOUR_API_KEY
Content-Type: application/json

Request Body

Endpoint ini digunakan untuk menghasilkan gambar dari prompt teks menggunakan Character AI Image Generation.

{
  "prompt": "anime girl with blue hair in cyberpunk city"
}

Body Parameters

NameTypeRequiredDescription
promptstringYes*Prompt utama untuk generate gambar
querystringYes*Alternatif dari prompt

Salah satu dari prompt atau query wajib diisi.

Example Usage

{
  "prompt": "anime girl with blue hair in cyberpunk city"
}

Success Response

{
  "success": true,
  "images": [
    "https://image-storage.maelyn.eu/m/example-image-1",
    "https://image-storage.maelyn.eu/m/example-image-2",
    "https://image-storage.maelyn.eu/m/example-image-3",
    "https://image-storage.maelyn.eu/m/example-image-4"
  ],
  "total": 4
}

Error Response

Invalid JSON

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

Prompt Required

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

No Image Generated

{
  "success": false,
  "error": "NO_IMAGE_GENERATED",
  "message": "Server AI tidak mengembalikan gambar"
}

Upstream API Error

{
  "success": false,
  "error": "UPSTREAM_API_ERROR",
  "message": "Gagal mengambil hasil generate image"
}

Request Timeout

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

Fetch Failed

{
  "success": false,
  "error": "FETCH_FAILED",
  "message": "Terjadi gangguan saat menghubungi server AI"
}

Internal Server Error

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

Playground