Langsung ke konten utama
POST
/
v1
/
images
/
generations
curl --request POST \
  --url https://api.apimart.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "wan2.7-image-pro",
    "prompt": "A flower shop with exquisite windows, beautiful wooden door, flowers on display"
  }'

{
  "code": "success",
  "data": [
    {
      "task_id": "task_01HX...",
      "status": "processing"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.apimart.ai/llms.txt

Use this file to discover all available pages before exploring further.

curl --request POST \
  --url https://api.apimart.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "wan2.7-image-pro",
    "prompt": "A flower shop with exquisite windows, beautiful wooden door, flowers on display"
  }'

{
  "code": "success",
  "data": [
    {
      "task_id": "task_01HX...",
      "status": "processing"
    }
  ]
}

​
Otorisasi

​
Authorization
string
wajib
Semua permintaan memerlukan autentikasi Bearer Token.Kunjungi halaman Manajemen API Key untuk memperoleh API Key Anda, lalu tambahkan ke header permintaan:
Authorization: Bearer YOUR_API_KEY

​
Model yang Tersedia

ModelDeskripsiResolusi Maks (Text-to-Image)Resolusi Maks (Edit / Sekuensial)Harga
wan2.7-image-proEdisi profesional, detail lebih baik, mendukung 4K4K2K¥0.50 / gambar
wan2.7-imageEdisi standar, pembuatan lebih cepat2K2K¥0.20 / gambar
Penagihan didasarkan pada gambar yang berhasil dibuat × harga satuan. Input tidak ditagih. Resolusi dan rasio aspek tidak memengaruhi harga. Permintaan yang gagal tidak dikenakan biaya.

​
Body

​
model
string
wajib
Nama model pembuatan gambar.
  • wan2.7-image-pro — Edisi profesional, hingga 4K untuk text-to-image
  • wan2.7-image — Edisi standar, lebih cepat, hingga 2K
​
prompt
string
Deskripsi teks untuk pembuatan gambar, hingga 5000 karakter.
  • Text-to-image (tanpa image_urls): wajib
  • Pengeditan gambar (dengan image_urls): opsional tetapi direkomendasikan
Contoh: "Toko bunga dengan jendela indah, pintu kayu cantik, dan bunga yang dipajang"
​
image_urls
array<string>
Array URL gambar input untuk skenario pengeditan dan referensi multi-gambar.Menyediakan bidang ini akan mengalihkan permintaan ke mode pengeditan gambar.Format yang didukung: URL HTTP/HTTPS; data:image/...;base64,... Base64Batasan: Hingga 9 gambar; JPEG / PNG / WEBP / BMP; 240–8000 px, rasio aspek 1:8 ~ 8:1; ≤ 20MB per gambar
Rasio aspek output otomatis mengikuti gambar input terakhir. Mode pengeditan hanya mendukung hingga 2K — 4K tidak tersedia.
​
n
integer
default:"1"
Jumlah gambar yang akan dibuat.
  • Mode standar: 1–4 (default 1)
  • Mode sekuensial (enable_sequential: true): 1–12 (default 1)
Ditagih per gambar yang berhasil dibuat. Dikenakan biaya di muka berdasarkan n.
​
size
string
Resolusi output atau rasio aspek. Mendukung tiga format:① Kata kunci resolusi (direkomendasikan): 1K / 2K (default) / 4K (wan2.7-image-pro khusus text-to-image)② Rasio aspek: 1:1 / 16:9 / 9:16 / 4:3 / 3:4 / 3:2 / 2:3 (default ke tier 2K)③ Dimensi piksel: 1024x1024 atau 1024*1024
​
resolution
string
Kata kunci tier resolusi: 1K / 2K / 4K. Dapat digabungkan dengan size (rasio aspek).
ModelSkenarioTier yang DidukungRentang Piksel
wan2.7-image-proText-to-image (non-sekuensial)1K / 2K / 4K768×768 ~ 4096×4096
wan2.7-image-proPengeditan / sekuensial1K / 2K768×768 ~ 2048×2048
wan2.7-imageSemua skenario1K / 2K768×768 ~ 2048×2048
​
negative_prompt
string
Prompt negatif yang menjelaskan elemen yang perlu dihindari. Contoh: "buram, terdistorsi, kualitas rendah"
​
watermark
boolean
default:"false"
Apakah akan menambahkan watermark “AI Generated” di sudut kanan bawah.
​
seed
integer
Seed acak, range 0–2147483647. Seed yang sama dengan parameter identik menghasilkan hasil yang konsisten secara visual.
​
thinking_mode
boolean
default:"true"
Aktifkan mode penalaran yang ditingkatkan untuk memperbaiki kualitas gambar dengan konsekuensi waktu pembuatan lebih lama.
Hanya efektif saat mode sekuensial dinonaktifkan dan tidak ada input gambar yang diberikan.
​
enable_sequential
boolean
default:"false"
Aktifkan mode pembuatan gambar sekuensial — membuat beberapa gambar yang koheren secara tematik dalam satu permintaan. Ideal untuk storyboard dan seri.
  • Maksimum n is 12 when enabled
  • thinking_mode dan color_palette diabaikan dalam mode sekuensial
  • wan2.7-image-pro mendukung hingga 2K dalam mode sekuensial (4K tidak didukung)
​
bbox_list
array
Bounding box untuk pengeditan interaktif — menentukan wilayah persis yang akan diedit atau disisipkan konten.Structure: [[[x1, y1, x2, y2], ...], ...]
  • Panjang array luar harus sama dengan panjang image_urls
  • Berikan [] untuk gambar tanpa bounding box
  • Maksimum 2 box per gambar; koordinat adalah nilai piksel absolut, origin (0,0) berada di kiri atas
Contoh: [[], [[989, 515, 1138, 681]]]
​
color_palette
array<object>
Tema warna kustom. Hanya mode standar (bukan mode sekuensial).
  • 3–10 entri (8 direkomendasikan); setiap entri memerlukan hex dan ratio
  • Semua nilai ratio harus berjumlah tepat 100.00%
[
  { "hex": "#C2D1E6", "ratio": "23.51%" },
  { "hex": "#636574", "ratio": "76.49%" }
]

​
Respons

​
code
string
Status respons. Mengembalikan "success" saat berhasil.
​
data
array

​
Contoh

​
Teks-ke-Gambar (minimal)

{
  "model": "wan2.7-image-pro",
  "prompt": "A flower shop with exquisite windows, beautiful wooden door, flowers on display"
}

​
Teks-ke-Gambar (dengan resolusi)

{
  "model": "wan2.7-image-pro",
  "prompt": "Summer beach, blue sky and white clouds, 4K ultra HD",
  "size": "4K",
  "thinking_mode": true
}

​
Teks-ke-Gambar (palet warna kustom)

{
  "model": "wan2.7-image-pro",
  "prompt": "Minimalist modern living room",
  "size": "2K",
  "color_palette": [
    { "hex": "#C2D1E6", "ratio": "23.51%" },
    { "hex": "#CDD8E9", "ratio": "20.13%" },
    { "hex": "#B5C8DB", "ratio": "15.88%" },
    { "hex": "#C0B5B4", "ratio": "13.27%" },
    { "hex": "#DAE0EC", "ratio": "10.11%" },
    { "hex": "#636574", "ratio": "8.93%" },
    { "hex": "#CACAD2", "ratio": "5.55%" },
    { "hex": "#CBD4E4", "ratio": "2.62%" }
  ]
}

​
Sequential Pembuatan Gambar

{
  "model": "wan2.7-image-pro",
  "prompt": "Cinematic series: the same stray orange cat, consistent features. First: under cherry blossoms in spring. Second: old street shade in summer. Third: fallen leaves in autumn. Fourth: snow footprints in winter.",
  "enable_sequential": true,
  "n": 4,
  "size": "2K"
}

​
Pengeditan Satu Gambar

{
  "model": "wan2.7-image",
  "prompt": "Replace the background with a sunset scene, warm color tones",
  "image_urls": ["https://example.com/portrait.jpg"],
  "size": "2K"
}

​
Referensi Multi-Gambar / Fusi Elemen

{
  "model": "wan2.7-image-pro",
  "prompt": "Apply the graffiti from image 2 onto the car in image 1",
  "image_urls": [
    "https://example.com/car.webp",
    "https://example.com/paint.webp"
  ],
  "size": "2K"
}

​
Pengeditan Interaktif (Bounding Box)

bbox_list berkorespondensi 1-ke-1 dengan image_urls. Berikan [] untuk gambar tanpa pilihan. 
{
  "model": "wan2.7-image-pro",
  "prompt": "Place the alarm clock from image 1 into the selected area of image 2, blending naturally",
  "image_urls": [
    "https://example.com/clock.webp",
    "https://example.com/desk.webp"
  ],
  "bbox_list": [
    [],
    [[989, 515, 1138, 681]]
  ],
  "size": "2K"
}
Mengueri HasilPembuatan gambar bersifat asinkron. Polling endpoint Status Tugas menggunakan task_id hingga status == completed.