Rencanakan edit dengan model gambar Microsoft MAI Image 2.7. Di Playground MAI Image API, padukan gambar sumber dengan instruksi tentang adegan, cahaya, teks, dan detail yang ingin dipertahankan.
Konfigurasi MAI Image 2.7 API
Tentukan bagian yang ingin diubah dan detail yang perlu dipertahankan.
Pilih gambar dan jelaskan perubahannya.
Mulai dari gambar dan tujuan edit yang jelas. Gunakan ruang kerja untuk memisahkan perubahan yang diminta dari komposisi, bahan, dan detail yang perlu tetap sama.
Gunakan contoh ini untuk menyusun permintaan pengeditan dengan gambar sumber dan instruksi, lalu periksa tugas untuk mengambil hasilnya.
Simpan API key APIMart Anda dalam environment variable APIMART_API_KEY. Kirim sebagai Authorization: Bearer <key> saat mengirim pengeditan maupun memeriksa tugas.
Kirim POST /v1/images/generations dengan model bernilai mai-image-2.7, instruksi pengeditan pada prompt, dan satu URL HTTP atau HTTPS gambar sumber pada image_urls. Ambil ID tugas dari data[0].task_id dalam respons.
Periksa tugas melalui GET /v1/tasks/{task_id}. Jika statusnya completed, ambil URL gambar dari data.result.images[0].url[0]. Jika statusnya failed, lihat penyebabnya di data.error.message.
Lihat dokumentasi APIMart untuk autentikasi dan penggunaan umum API APIMart.
curl -X POST https://api.apimart.ai/v1/images/generations \
-H "Authorization: Bearer $APIMART_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "mai-image-2.7",
"prompt": "Letakkan produk dari gambar ini di atas meja dapur marmer dengan cahaya pagi yang lembut, tanpa mengubah bentuk dan label produk.",
"image_urls": [
"https://example.com/source-image.jpg"
]
}'import os
import time
import requests
API_BASE = "https://api.apimart.ai"
headers = {"Authorization": f"Bearer {os.environ['APIMART_API_KEY']}"}
# 1. Submit the generation task
payload = {
"model": "mai-image-2.7",
"prompt": "Letakkan produk dari gambar ini di atas meja dapur marmer dengan cahaya pagi yang lembut, tanpa mengubah bentuk dan label produk.",
"image_urls": [
"https://example.com/source-image.jpg"
]
}
resp = requests.post(f"{API_BASE}/v1/images/generations", headers=headers, json=payload, timeout=60)
resp.raise_for_status()
task_id = resp.json()["data"][0]["task_id"]
# 2. Poll the task until it finishes
for _ in range(200):
task_resp = requests.get(f"{API_BASE}/v1/tasks/{task_id}", headers=headers, timeout=30)
task_resp.raise_for_status()
task = task_resp.json()["data"]
if task["status"] == "completed":
print(task["result"]["images"][0]["url"][0])
break
if task["status"] == "failed":
raise RuntimeError(task.get("error", {}).get("message", "generation failed"))
time.sleep(3)
else:
raise TimeoutError(f"task {task_id} did not finish in time; continue GET polling with this task ID")TASK_ID="task_xxx" # replace with the task_id returned by the POST request
curl "https://api.apimart.ai/v1/tasks/$TASK_ID" \
-H "Authorization: Bearer $APIMART_API_KEY"| Parameter | Tipe | Wajib | Default | Deskripsi |
|---|---|---|---|---|
model | string | Ya | Default: mai-image-2.7 | Nilai model yang digunakan dalam contoh di halaman ini: mai-image-2.7. |
prompt | string | Ya | Default: — | Jelaskan perubahan yang diinginkan dan elemen gambar sumber yang perlu dipertahankan. |
image_urls | array | Ya | Default: — | Array yang berisi tepat satu URL HTTP atau HTTPS untuk gambar sumber yang akan diedit. |
Susun perubahan visual pada bagian penting gambar.
Siapkan instruksi konkret untuk aset visual yang sudah ada.
Tinjau gambar dan instruksi bersama dalam tiga langkah.
Pilih gambar asli dari berkas lokal atau URL gambar HTTP/HTTPS.
Jelaskan perubahan utama, lalu daftar objek, teks, tekstur, atau area yang perlu tetap sama.
Periksa sumber dan prompt di Form atau JSON. Hapus arahan yang bertentangan sebelum memperjelas konsep.
Gambar sumber, prompt edit, dan konfigurasi ruang kerja.
MAI Image 2.7 adalah model edit gambar Microsoft. Ruang MAI Image API menata gambar sumber dan instruksi untuk perubahan adegan, gaya, cahaya, teks, dan restorasi.
Pilih gambar sumber dan jelaskan perubahan yang diinginkan dalam prompt mai-image-api. Beri instruksi eksplisit tentang detail penting yang harus tetap sama.
Ruang MAI Image API memilih satu gambar sumber dari berkas lokal atau tautan. Ganti gambar yang aktif untuk menyiapkan edit pada gambar lain.
Nyatakan perubahan utama terlebih dahulu dalam prompt API, lalu jelaskan latar, cahaya, dan batasannya. Utamakan instruksi spesifik daripada beberapa tujuan yang bertentangan.
Sebutkan bentuk produk, ciri wajah, bahan, tulisan, atau area yang perlu dipertahankan dalam prompt API. Ini merupakan arahan edit, bukan jaminan pelestarian yang persis.
Jelaskan lingkungan baru dalam konsep MAI Image API serta posisi dan ukuran subjek. Tambahkan bayangan kontak dan perspektif untuk memperjelas hubungan yang diinginkan.
Untuk MAI Image API, jelaskan arah, kelembutan, warna, dan suasana cahaya. Sebutkan bayangan serta pantulan yang berubah dan bagian yang harus tetap konsisten.
Jelaskan medium, warna, dan tekstur dalam prompt MAI Image API. Tentukan subjek, pose, dan komposisi yang dipertahankan, bukan sekadar memberi label gaya yang samar.
Tulis teks pengganti persis dalam tanda kutip pada prompt API. Tentukan posisi dan permukaannya; ejaan, penyelarasan, dan keterbacaan tetap perlu diperiksa.
Beri tahu Microsoft MAI Image API goresan, warna pudar, atau artefak yang perlu diperbaiki. Tegaskan ciri wajah, tekstur, bahan, dan bagian adegan asli yang harus tetap utuh.
Gunakan posisi relatif yang jelas dalam prompt MAI Image API: kiri, di belakang, bersentuhan, atau bertumpuk. Sertakan skala, perspektif, dan objek sekitar sebagai acuan.
Ruang MAI Image API memungkinkan pemilihan gambar lokal atau URL gambar HTTP/HTTPS. Gunakan alamat menuju aset gambar, bukan halaman web.
Form dan JSON menggambarkan draf MAI Image API yang sama. JSON valid memperbarui formulir; edit tidak valid menampilkan pesan sambil mempertahankan teks dan draf formulir sebelumnya. Nilai mai-image-2.7 adalah ID konfigurasi halaman ini.
Reset menghapus gambar sumber dan prompt edit aktif di ruang MAI Image API serta memulihkan konfigurasi awal. Salin terlebih dahulu instruksi yang ingin dipertahankan.
Nama pada judul di halaman ini adalah variasi penulisan, bukan pengenal untuk permintaan API. MAI Image 27, MAIImage 2.7, dan MAI-Image2.7 merupakan ejaan pencarian, bukan model lain atau ID API. Di sini, mai-image-2.7 adalah ID konfigurasi halaman; cocokkan pengenal permintaan dengan dokumentasi API terkait.
Masuk ke APIMart dan buka pengelolaan key melalui API Keys di bagian atas halaman ini. Anda dapat membuat dan mengelola API key APIMart di sana. Lihat dokumentasi API terkait untuk persyaratan autentikasi dan pengenal permintaan.
Jelajahi lebih banyak model dalam kategori yang sama.

MiniMax H3 Image
Built for image quality and prompt adherence. It handles text-to-image, reference-based generation and image editing. MiniMax says it can generate a 4K (4096 × 4096) image in under 10 seconds and work with up to 16 reference images. In Chinese launch coverage, MiniMax puts its speed at about 1.5 to 2 times that of mainstream tools.

MiniMax H3 Image Highspeed
Built for speed. The same coverage puts it at about 3 to 4 times faster than mainstream tools, which suits batch jobs or anything that needs fast turnaround.

Seedream 5.5
Seedream 5.5 brings your imagination to life through expressive visuals. From dreamy illustrations to cinematic scenes and product concepts, explore color, texture, and light to shape images that tell your story.

GPT Image 2.6 Sunburst
GPT Image 2.6 Sunburst brings a fresh burst of creativity to your ideas. From vibrant illustrations to atmospheric scenes and striking product concepts, explore rich colors, expressive lighting, and thoughtful compositions that make your vision shine.