

Cara Membuat Gambar dengan Seedream 5.0 Pro
Panduan langkah demi langkah memanggil Seedream 5.0 Pro di APIMart: autentikasi, field permintaan, polling tugas, membaca hasil, dan menyimpan gambar sebelum tautan kedaluwarsa.
Seedream 5.0 Pro bisa langsung dipakai dengan satu permintaan POST, satu API key, dan satu langkah lanjutan: kirim tugas, terima task_id, lalu cek tugas sampai gambar selesai. Seedream 5.0 Pro bersifat asinkron, jadi respons pertama tidak pernah berisi gambar.
Versi singkatnya:
- Saya mengirim permintaan ke
https://api.apimart.ai/v1/images/generations - Saya menambahkan
Authorization: Bearer YOUR_API_KEY - Saya mengisi
modeldenganseedream-5-0-pro - Saya menyertakan
prompt, ditambahresolution(1K,1.5K, atau2K) dansize(autoatau rasio seperti16:9) - Untuk mengedit atau menggabungkan gambar, saya menambahkan hingga 10 gambar referensi di
image_urls - Saya melakukan polling
GET /v1/tasks/{task_id}setiap 5–10 detik sampai status menjadicompleted - Saya langsung mengunduh hasilnya, karena tautan gambar hanya berlaku 72 jam
Hal terpenting: ini model satu gambar. Setiap permintaan menghasilkan satu gambar, dan n lebih dari 1 akan ditolak. Anda bisa mencoba Seedream 5.0 Pro API di APIMart; daftar lengkap field ada di referensi API.

Poin Penting
- Seedream 5.0 Pro dipanggil dengan permintaan POST ke
https://api.apimart.ai/v1/images/generations, header Authorization: Bearer YOUR_API_KEY, dan model diisi seedream-5-0-pro. - Pilih tingkat output dengan resolution (1K, 1.5K, atau 2K) dan bentuknya dengan size: auto, salah satu dari sepuluh rasio, atau piksel persis. 1.5K berharga sama dengan 1K; 3K dan 4K mengembalikan 400.
- Setiap permintaan menghasilkan satu gambar. n lebih dari 1, pembuatan grup, streaming, dan pencarian web ditolak dengan 400, dan tidak ada tugas yang dibuat.
- Pengeditan gambar mengirim hingga 10 gambar referensi melalui image_urls, berupa URL publik atau Data URI Base64.
- Respons pertama hanya berisi task_id. Lakukan polling ke endpoint tugas setiap 5–10 detik, lalu simpan gambar dalam 72 jam.
Perbandingan cepat
| Item | Kegunaan bagi saya | Batas atau catatan utama |
|---|---|---|
| Teks ke gambar | Gambar baru hanya dari prompt | Tidak perlu gambar input |
| Edit satu referensi | Mengubah latar, pencahayaan, atau detail satu gambar | Satu item di image_urls |
| Edit multi-referensi | Menggabungkan orang, pakaian, atau adegan | Hingga 10 gambar referensi |
| Dekomposisi layer | Memecah poster menjadi layer yang bisa diedit | Tepat satu gambar input, hingga 16 layer PNG |
| Latar transparan | Mengedit layer sambil mempertahankan alpha | Satu gambar input beralpha, output_format: "png" |
Singkatnya: panduan ini menunjukkan cara menyiapkan autentikasi, menyusun body permintaan, melakukan polling tugas, dan menyimpan hasil tanpa kehilangan file.
1. Siapkan Akses API dan Autentikasi
1.1 Buat Akun APIMart dan API Key

Daftar di APIMart, buka halaman Manajemen API Key di dashboard, lalu buat key. Salin segera dan simpan di sisi server, di secret manager atau environment variable.
Jangan pernah menaruh key di kode frontend atau repositori publik. Siapa pun yang memilikinya bisa memakai saldo Anda. Di Node.js, baca dari process.env.APIMART_API_KEY; di shell, gunakan export APIMART_API_KEY="your-key-here".
1.2 Atur Base URL dan Header Autentikasi Bearer
Setiap permintaan dikirim ke base URL https://api.apimart.ai dengan dua header:
| Header | Nilai |
|---|---|
Authorization | Bearer YOUR_API_KEY |
Content-Type | application/json |
Pertahankan awalan Bearer dengan tepat satu spasi. Token yang hilang atau salah format mengembalikan 401. Jika cURL berhasil tetapi aplikasi Anda tidak, masalahnya biasanya ada pada cara aplikasi menyusun header.
2. Susun Permintaan Gambar Seedream 5.0 Pro

2.1 Field Inti: Model, Prompt, Resolution, dan Size
Permintaan teks ke gambar memerlukan model dan prompt. Dua field lain mengatur output:
model:seedream-5-0-pro(seedream-5.0-projuga diterima).prompt: deskripsi bahasa alami. Selain Mandarin dan Inggris, model ini dapat merender teks secara native dalam bahasa Indonesia, Jepang, Korea, Spanyol, Portugis, Prancis, Jerman, Rusia, Vietnam, dan bahasa lainnya. Usahakan sekitar 600 kata bahasa Inggris; prompt yang terlalu panjang bisa kehilangan detail.resolution:1K(default),1.5K, atau2K. 1.5K berharga sama dengan 1K, jadi biasanya pilihan yang lebih baik.size:auto(default), salah satu dari sepuluh rasio (1:1,4:3,3:4,16:9,9:16,3:2,2:3,2:1,1:2,21:9), atau piksel persis seperti2048x1024. Piksel persis harus berjumlah antara 921.600 dan 4.624.220, dengan rasio antara 1:16 dan 16:1.
Contohnya, resolution: "1.5K" dengan size: "16:9" menghasilkan gambar 2048×1152.
2.2 Field Opsional
| Parameter Opsional | Tipe | Kapan Dipakai |
|---|---|---|
image_urls | Array | Edit dan komposisi multi-referensi; hingga 10 URL publik atau Data URI Base64 |
output_format | String | jpeg (default) atau png |
background | String | transparent untuk mempertahankan alpha saat mengedit satu gambar yang sudah punya kanal alpha (wajib png) |
layer_decomposition | Boolean | Memecah satu gambar menjadi gambar dasar dan hingga 16 layer PNG transparan |
optimize_prompt_options | Object | Optimasi prompt; hanya {"mode": "standard"} yang didukung |
watermark | Boolean | Menambahkan tanda “AI generated” di kanan bawah |
nsfw_check | Boolean | Memoderasi prompt dan gambar input sebelum tugas dikirim |
Setiap gambar referensi boleh berformat jpeg, png, webp, bmp, tiff, gif, heic, atau heif, maksimal 30 MB dan 36 juta piksel. Gambar referensi pertama gratis; setiap gambar tambahan dikenai biaya tetap.
Untuk menentukan lokasi edit dengan tepat, tulis koordinat di prompt: <point>x y</point> untuk satu titik atau <bbox>x1 y1 x2 y2</bbox> untuk satu area.
2.3 Field yang Ditolak Model Ini
Seedream 5.0 Pro adalah model satu gambar. Permintaan berikut mengembalikan 400, tidak membuat tugas, dan tidak ditagih:
nlebih dari 1, atausequential_image_generation(gunakan Seedream 5.0 Lite untuk gambar grup)streamatautools(streaming dan pencarian web tidak didukung)- lebih dari 10 item di
image_urls - tingkat yang tidak didukung seperti
3Katau4K, atau rasio di luar daftar di atas
2.4 Contoh Panggilan dengan cURL dan JavaScript
Berikut permintaan cURL minimal untuk satu gambar 16:9 di tingkat 1.5K:
curl --request POST \
--url https://api.apimart.ai/v1/images/generations \
--header "Authorization: Bearer $APIMART_API_KEY" \
--header "Content-Type: application/json" \
--data '{
"model": "seedream-5-0-pro",
"prompt": "A sunlit mountain trail in autumn, photorealistic, wide angle",
"resolution": "1.5K",
"size": "16:9"
}'
Responsnya hanya mengonfirmasi tugas:
{
"code": 200,
"data": [{ "status": "submitted", "task_id": "task_01K8SGYNNNVBQTXNR4MM964S7K" }]
}
Dan ini edit multi-referensi di Node.js dengan fetch:
const response = await fetch("https://api.apimart.ai/v1/images/generations", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.APIMART_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
model: "seedream-5-0-pro",
prompt: "Replace the outfit in image 1 with the outfit in image 2",
image_urls: ["https://example.com/person.jpg", "https://example.com/dress.jpg"],
resolution: "2K",
size: "auto",
}),
});
const { data } = await response.json();
const taskId = data[0].task_id;
Jalankan panggilan ini di server, jangan di kode sisi klien.
3. Polling Tugas dan Simpan Gambar
3.1 Cek Status Tugas
Kirim GET https://api.apimart.ai/v1/tasks/{task_id} dengan header Authorization yang sama. Seedream 5.0 Pro mengutamakan kualitas, jadi satu tugas bisa memakan waktu beberapa menit. Lakukan polling setiap 5–10 detik dan atur timeout klien sekitar 5 menit.
Hentikan polling saat status menjadi completed atau failed. Tugas yang gagal dikembalikan dananya sepenuhnya.
3.2 Baca Hasilnya
Tugas yang selesai terlihat seperti ini:
{
"code": 200,
"data": {
"id": "task_01JFXYZ123456789ABCDEF",
"status": "completed",
"progress": 100,
"result": {
"images": [
{
"url": ["https://cdn.example.com/images/image_task_xxx_0.png"],
"expires_at": 1784696685
}
]
}
}
}
Baca gambar dari data.result.images[0].url[0]. Respons juga memuat cost tugas. Tautan berlaku 72 jam (expires_at adalah timestamp Unix), jadi unduh file dan pindahkan ke penyimpanan Anda sendiri, bukan hanya menyimpan URL-nya.
3.3 Contoh Lengkap dengan Python
import os
import time
import requests
BASE_URL = "https://api.apimart.ai"
headers = {
"Authorization": f"Bearer {os.environ['APIMART_API_KEY']}",
"Content-Type": "application/json",
}
created = requests.post(
f"{BASE_URL}/v1/images/generations",
headers=headers,
json={
"model": "seedream-5-0-pro",
"prompt": "A product poster with the headline SUMMER SALE in bold letters",
"resolution": "1.5K",
"size": "3:4",
"output_format": "png",
},
timeout=30,
)
created.raise_for_status()
task_id = created.json()["data"][0]["task_id"]
while True:
task = requests.get(f"{BASE_URL}/v1/tasks/{task_id}", headers=headers, timeout=30).json()["data"]
if task["status"] == "completed":
image_url = task["result"]["images"][0]["url"][0]
break
if task["status"] == "failed":
raise RuntimeError(task.get("error", {}).get("message", task["status"]))
time.sleep(5)
with open("seedream-5-0-pro.png", "wb") as f:
f.write(requests.get(image_url, timeout=60).content)
4. Tiga Alur Kerja Gambar yang Umum
-
Poster dan grafis dengan teks. Tulis teks yang diinginkan dalam tanda kutip di prompt, jelaskan tata letaknya (misalnya “poster vertikal, judul di atas”), lalu gunakan
resolution: "1.5K"dengan rasio tetap seperti3:4. Beralih ke2Khanya untuk aset final, karena tingkat 2K lebih mahal. -
Edit multi-referensi. Masukkan gambar orang, produk, atau adegan ke
image_urlsdan sebut menurut urutannya di prompt (“gambar 1”, “gambar 2”). Dengansize: "auto", rasio output mengikuti referensi. Tambahkan koordinat<bbox>untuk menentukan dengan tepat letak suatu elemen. -
Dekomposisi layer dan edit transparan. Kirim satu PNG atau JPEG dengan
layer_decomposition: trueuntuk mendapatkan gambar dasar plus hingga 16 layer PNG transparan beserta data posisi dan urutan tumpukan. Untuk mengedit satu layer, kirim kembali layer tersebut denganbackground: "transparent"danoutput_format: "png". Tugas layer ditagih per gambar output setelah praotorisasi, dan kelebihannya dikembalikan.
5. Checklist Akhir untuk Integrasi Seedream 5.0 Pro yang Andal
Autentikasi dan keamanan key. Simpan key di environment variable atau secret manager, dan panggil API hanya dari backend.
Validasi parameter sebelum dikirim. Gunakan seedream-5-0-pro, hilangkan n (atau isi 1), batasi image_urls maksimal 10, dan gunakan hanya 1K, 1.5K, atau 2K dengan size yang didukung.
Rancang untuk alur asinkron. Lakukan polling setiap 5–10 detik, atur timeout klien sekitar 5 menit, dan tangani tugas berstatus failed.
Perlakukan pengiriman sebagai urusan penyimpanan. Unduh setiap gambar begitu tugas berhasil; tautan kedaluwarsa setelah 72 jam.
Cek biaya sebelum menambah skala. Output ditagih per gambar menurut tingkat piksel (1K dan 1.5K berbagi harga yang lebih rendah, 2K lebih mahal), dan setiap gambar referensi setelah yang pertama dikenai biaya tambahan. Lihat tabel harga terkini sebelum menjalankan batch besar.
Pertanyaan Umum
Bagaimana cara mengecek tugas gambar setelah mendapat task_id?
Kirim GET https://api.apimart.ai/v1/tasks/{task_id} dengan header Authorization: Bearer Anda.
Lakukan polling setiap 5–10 detik sampai status menjadi completed, lalu baca gambar dari data.result.images[0].url[0]. Jika statusnya failed, periksa field error; tugas yang gagal dikembalikan dananya.
Bisakah saya mendapat beberapa gambar atau output Base64 dalam satu permintaan?
Tidak. Seedream 5.0 Pro mengembalikan satu gambar per permintaan, dan n lebih dari 1 ditolak dengan 400. Untuk beberapa variasi, kirim beberapa permintaan, atau gunakan Seedream 5.0 Lite untuk pembuatan grup.
Hasilnya selalu berupa URL; pilih jpeg atau png dengan output_format. Base64 didukung untuk gambar input di image_urls, bukan untuk output.
Apa cara terbaik agar gambar yang dihasilkan tidak hilang?
Tautan gambar berlaku 72 jam, dan expires_at pada hasil menunjukkan waktu tepatnya.
Unduh setiap gambar ke penyimpanan Anda sendiri begitu tugas mencapai completed, dan catat sendiri task_id-nya. Jangan perlakukan URL yang dikembalikan sebagai penyimpanan permanen.
Tentang Tim APIMart
Tim APIMart menulis panduan model, perbandingan, dan analisis harga untuk developer yang membangun produk dengan AI. APIMart menyediakan satu API untuk model chat, gambar, dan video dari berbagai penyedia, sehingga Anda bisa membandingkan model yang dibahas di sini sebelum rilis.
Pilih model yang Anda inginkan di marketplace model
Coba model chat, gambar, dan video di marketplace model APIMart, lalu rasakan kemampuan model dengan cepat melalui satu API terpadu.
