MAI Image 2.7 API
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
- Gambar sumber dari berkas atau URL
- Instruksi edit dalam prompt
- Konfigurasi Form dan JSON
Tentukan bagian yang ingin diubah dan detail yang perlu dipertahankan.
Pilih gambar dan jelaskan perubahannya.
Siapkan edit terarah dengan MAI Image 2.7 API
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.
Contoh MAI Image 2.7 API: pengeditan gambar
Gunakan contoh ini untuk menyusun permintaan pengeditan dengan gambar sumber dan instruksi, lalu periksa tugas untuk mengambil hasilnya.
- 1
Autentikasi permintaan MAI Image 2.7 API
Simpan API key APIMart Anda dalam environment variable APIMART_API_KEY. Kirim sebagai Authorization: Bearer <key> saat mengirim pengeditan maupun memeriksa tugas.
- 2
Kirim tugas pengeditan gambar
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.
- 3
Ambil gambar hasil edit
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 MAI Image 2.7 API
| 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. |
