Cara Menggunakan Seedgream 4.5 API

CometAPI
AnnaDec 9, 2025
Cara Menggunakan Seedgream 4.5 API

Seedream 4.5 adalah evolusi terbaru dari keluarga model teks-ke-gambar/pengeditan gambar Seedream (dikembangkan di bawah riset Byte/BytePlus). Model ini sedang diluncurkan di endpoint resmi BytePlus dan berbagai platform pihak ketiga — termasuk akses terintegrasi melalui gerbang multi-model seperti CometAPI — dan menghadirkan peningkatan pada konsistensi subjek, tipografi/perenderan teks, serta fidelitas pengeditan multi-gambar.

Artikel ini adalah panduan praktis profesional untuk menggunakan API Seedream 4.5. Anda akan mendapatkan langkah penyiapan, autentikasi dan pola permintaan, praktik terbaik untuk prompt dan parameter, alur kerja pengeditan & multi-gambar, penanganan error, pola deployment, serta pertimbangan legal/keamanan.

Apa itu Seedream 4.5?

Seedream 4.5 adalah iterasi terbaru dari keluarga Seedream — model generatif dan pengeditan gambar multimodal yang dirancang untuk pembuatan teks-ke-gambar fidelity tinggi dan pengeditan gambar kontekstual (image-to-image, multi-reference editing, inpainting/outpainting, tipografi dan penanganan teks padat). Dibanding rilis Seedream sebelumnya, 4.5 berfokus pada peningkatan konsistensi subjek di alur kerja multi-gambar, pelestarian detail referensi yang lebih ketat, fidelitas tipografi yang lebih tinggi (teks di dalam gambar), serta kualitas keluaran lebih baik hingga 4K/ultra-HD dalam pengaturan “high quality”. Peningkatan ini hadir sebagai bagian dari arsitektur berskala dan pembaruan penyetelan prompt/heuristik sisi mesin.

Mengapa ini penting: 4.5 sengaja dibangun untuk menangani tugas kreatif profesional — variasi produk dalam batch, pengeditan multi-gambar yang konsisten dengan merek, dan aset cetak beresolusi tinggi — sembari memungkinkan kontrol lebih halus dengan gambar referensi dan operasi pengeditan khusus.

Kemampuan inti

  • Pembuatan teks-ke-gambar (tunggal dan batch): hasilkan 1–15 gambar per panggilan API, dengan mode kualitas yang dapat dipilih (Basic vs High) yang menukar kecepatan dan resolusi.
  • Pengeditan gambar (i2i / inpainting / outpainting): gunakan satu atau lebih gambar referensi; mempertahankan detail dan hubungan spasial di antara beberapa referensi.
  • Pencampuran multi-referensi & penyalinan elemen: hingga ~10 gambar referensi dapat digunakan dalam satu pekerjaan untuk “transplantasi” elemen sambil menjaga pencahayaan/perspektif tetap koheren.
  • Perenderan tipografi/teks yang tinggi: penanganan lebih baik untuk gambar dengan teks atau papan nama (berguna untuk mockup, label produk, tangkapan layar UI).
  • Output streaming/progresif: beberapa endpoint deployment mendukung streaming hasil sehingga klien dapat menerima hasil parsial saat generasi berlangsung.

Bagaimana Cara Menggunakan API Seedream 4.5 melalui CometAPI?

Di bawah ini adalah panduan praktis yang bisa langsung disalin-tempel untuk menghasilkan gambar melalui CometAPI (sebuah agregator yang mengekspos model Seedream 4.5 sebagai parameter model). Gunakan CometAPI ketika Anda ingin satu API key untuk mengakses puluhan/ratusan model dan permukaan REST yang stabil serta mudah diintegrasikan. Dokumentasi CometAPI menampilkan alias model doubao-seedream-4-5-251128 dan endpoint pembuatan gambar standar.

Langkah tingkat tinggi

  1. Daftar CometAPI dan dapatkan API key.
  2. Gunakan endpoint pembuatan gambar (POST https://api.cometapi.com/v1/images/generations) dengan parameter model disetel ke pengenal Seedream 4.5 (contoh: doubao-seedream-4-5-251128).
  3. Sertakan prompt, gambar referensi opsional (URL atau unggahan multipart tergantung agregator), ukuran/kualitas output, dan parameter lainnya.
  4. Terima respons JSON yang berisi URL gambar yang dihasilkan (atau base64) dan metadata.

Jenis permintaan dan mode

Seedream 4.5 umumnya mendukung:

  • Teks → Gambar (prompt teks → gambar baru)
  • Gambar → Gambar (gambar referensi + prompt untuk transformasi bergaya)
  • Pengeditan Gambar / Inpainting (mask + instruksi edit untuk perubahan terarah)
    API yang dihosting mendukung mode tugas asinkron (ajukan job → polling dengan taskId) yang cocok untuk render lama dan alur kerja batch. Tautan yang dihasilkan sering kali berlaku terbatas (misalnya, berlaku 24 jam pada beberapa gateway) jadi rencanakan penyimpanan/ekspor.

Contoh curl (teks-ke-gambar, single prompt)

curl -X POST "https://api.cometapi.com/v1/images/generations" \
  -H "Authorization: Bearer COMETAPI_KEY_GOES_HERE" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedream-4-5-251128",
    "prompt": "A cinematic portrait of a cyberpunk fox in neon rain, 4k, detailed lighting, film grain",
    "n": 3,
    "width": 2048,
    "height": 2048,
    "quality": "high",     # or "basic"
    "seed": 12345,
    "style": "photorealistic"
  }'

Catatan

  • Ganti COMETAPI_KEY_GOES_HERE dengan CometAPI key Anda.
  • Parameter n menghasilkan beberapa variasi dalam satu panggilan (menghemat overhead).
  • quality: "high" umumnya memetakan ke resolusi lebih tinggi/biaya komputasi lebih besar (sering mendukung 4K).

Contoh Python requests (teks-ke-gambar + menyimpan hasil)

import requests, base64, os

API_URL = "https://api.cometapi.com/v1/images/generations"
API_KEY = os.environ.get("COMETAPI_KEY")  # set env var for safety

payload = {
  "model": "doubao-seedream-4-5-251128",
  "prompt": "Studio shot of a ceramic mug on a wooden table, warm natural light, ultra-detailed, 2k",
  "n": 2,
  "width": 1024,
  "height": 1024,
  "quality": "basic"
}

resp = requests.post(API_URL, json=payload, headers={
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json"
})
resp.raise_for_status()
data = resp.json()

# Example: each item has 'b64_json' or 'url' depending on provider
for i, item in enumerate(data.get("data", [])):
    img_b64 = item.get("b64_json")
    if img_b64:
        img_bytes = base64.b64decode(img_b64)
        with open(f"seedream_result_{i}.png", "wb") as f:
            f.write(img_bytes)
    else:
        print("Image URL:", item.get("url"))

Mengapa pola ini? Agregator umumnya mengembalikan payload base64 atau URL yang di-host; kode di atas menangani keduanya. Endpoint biasanya mengembalikan task_id. Lakukan polling ke endpoint GET /tasks/{task_id} hingga status succeeded lalu unduh hasil. Banyak penyedia menyertakan SDK dengan helper bawaan untuk pola ini.

Bagaimana cara mengoptimalkan kualitas gambar dan menjaga teks tetap terbaca?

  1. Gunakan gambar referensi untuk konteks dan pencocokan warna yang konsisten.
  2. Sebutkan tipografi secara eksplisit dalam prompt (jenis font, bobot, perataan) dan pertimbangkan menambahkan teks persis sebagai overlay pada langkah kedua untuk memastikan keterbacaan.
  3. Jalankan proses dua langkah: (a) hasilkan komposisi dasar; (b) render ulang atau edit pada pass kedua yang berfokus pada close-up atau area label dengan resolusi lebih tinggi.

Bagaimana sebaiknya menulis prompt untuk Seedream 4.5?

Prinsip prompt engineering

  • Jelas dan eksplisit: sebutkan subjek, aksi, gaya, lensa/kamera, waktu, dan palet warna yang diinginkan.
  • Gunakan jangkar identitas: Jika Anda membutuhkan wajah/prop yang sama di banyak gambar, sertakan deskriptor persisten (misalnya, “wanita yang sama dengan rambut pendek bergelombang, jaket hijau, bekas luka di alis kiri”) dan sediakan 1–3 gambar referensi. Fusi multi-referensi Seedream 4.5 meningkat, namun jangkar tetap membantu.
  • Prompt negatif: sebutkan secara eksplisit hal yang ingin dihindari (mis., “tanpa teks”, “tanpa watermark”, “tanpa anggota tubuh ekstra”).
  • Hibrida pendek + panjang: berikan instruksi kanonik yang pendek lalu perpanjang dengan beberapa baris detail dan batasan.

Template prompt contoh

Hero shot produk (fotoreal): "A clean product hero shot of a matte black wireless speaker placed on a white tabletop, softbox lighting, 50mm, shallow depth of field, studio background, photoreal, no text"

Ilustrasi fantasi (bergaya): "Epic fantasy landscape, towering glass castle on a cliff, golden hour, volumetric fog, painterly, highly detailed, concept art"

Edit gambar (hapus objek): "Remove the person on the left and extend the background to fill the space, keep lighting consistent, no artifacts"

Mockup dengan tipografi berat: "Mobile app landing screen mockup on an iPhone 14, with the text 'Launch Now' in Gotham Bold, make the button green and keep shadows soft"

Potret karakter: "Heroic portrait of a female warrior, cinematic rim lighting, 85mm portrait lens, ultra-detailed skin texture, natural freckles, leather armor, neutral background, photorealistic."

Prompt multi-gambar dan referensi

Saat menggunakan pengeditan multi-gambar, tentukan gambar referensi mana yang memetakan ke bagian mana dari prompt. Seedream 4.5 lebih baik dalam mengidentifikasi subjek utama di antara banyak referensi — namun menjadi eksplisit (misalnya, “gunakan image_1 untuk wajah, image_2 untuk tekstur pakaian”) menghasilkan hasil lebih baik.

Pemilihan output & pascaproduksi

  • Hasilkan N varian dan jalankan filter objektif: skor kemiripan wajah, perbandingan histogram warna, OCR tipografi untuk memeriksa akurasi teks.
  • Otomatiskan ambang QC untuk mengarahkan output di bawah ambang ke retouch manual.
  • Alihkan tipografi final ke alat tata letak jika Anda membutuhkan teks dengan presisi piksel — gunakan model untuk latar belakang dan imagery, lalu komposisikan teks presisi di tahap akhir. Ini mengurangi ketergantungan pada fidelitas teks model untuk aset pemasaran.

Bagaimana melakukan pengeditan gambar, inpainting, dan komposisi multi-gambar?

Alur kerja pengeditan gambar

  1. Unggah gambar referensi ke penyedia atau kirim secara inline bersama permintaan.
  2. Sediakan mask (gambar biner) untuk inpainting atau anotasi bounding untuk edit terarah.
  3. Kirim prompt edit yang memperjelas area mana yang diubah dan mana yang dipertahankan.

Banyak API mendukung mode edit gambar tunggal dan komposisi multi-gambar; 4.5 secara eksplisit dituning untuk menjaga identitas subjek dan meningkatkan konsistensi multi-gambar.

Contoh: Payload inpainting (pseudocode JSON)

{
  "model": "seedream-4.5",
  "mode": "image_edit",
  "image_url": "https://.../original.png",
  "mask_url": "https://.../mask.png",
  "prompt": "Replace background with a sunset beach — keep subject untouched, maintain original lighting on subject",
  "guidance": 9,
  "steps": 40
}

Tips untuk konsistensi pengeditan multi-gambar

  • Gunakan seed yang sama untuk render terkait agar menjaga konsistensi antar frame.
  • Pertahankan deskriptor kamera konsisten dalam prompt (mis., “85mm portrait, softbox, 3/4”) untuk menjaga konsistensi sudut pandang.
  • Saat mengedit wajah, mintalah klausul pelestarian granular (“pertahankan struktur wajah, ubah warna rambut saja”) untuk mengurangi drift identitas.

Apa praktik terbaik saat menggunakan Seedream 4.5

Bagaimana cara men-troubleshoot masalah umum?

Berikut langkah pemecahan masalah praktis ketika hasil tidak sesuai:

Wajah buram / detail salah

Tingkatkan kekhususan prompt untuk detail wajah (usia, ekspresi, pencahayaan), sediakan gambar referensi berkualitas lebih tinggi, atau coba instruksi eksplisit “preserve face” dan turunkan strength edit untuk mempertahankan lebih banyak bagian asli. Seedream 4.5 meningkatkan realisme wajah, namun kualitas input tetap berpengaruh.

Teks tidak terbaca atau acak-acakan

Sediakan teks vektor atau raster sebagai overlay terpisah jika Anda memerlukan tipografi presisi piksel; jika tidak, gunakan pengaturan resolusi lebih tinggi dan instruksi gaya eksplisit “render legible text: yes”. 4.5 meningkatkan penanganan teks padat dibanding versi sebelumnya, tetapi kesempurnaan tipografis mungkin tetap membutuhkan komposisi di tahap akhir.

Pencahayaan atau komposisi batch tidak konsisten

Gunakan prompt bertemplat dengan penyebutan pencahayaan/kamera yang tetap, atau hasilkan dalam satu panggilan batch untuk meningkatkan konsistensi. BytePlus dan CometAPI menyediakan pola inferensi batch untuk alasan tersebut.

Catatan akhir dan langkah berikutnya

Seedream 4.5 adalah model gambar yang matang dan berorientasi produksi dengan peningkatan eksplisit yang ditujukan untuk alur kerja kreatif nyata: konsistensi lebih baik, peningkatan rendering teks dan wajah, serta dukungan multi-referensi. Gunakan CometAPI atau agregator serupa ketika Anda menginginkan eksperimen cepat dan fleksibilitas multi-model.

Developer dapat mengakses Seedream 4.5 melalui CometAPI, versi model terbaru selalu diperbarui sesuai situs resmi. Untuk memulai, jelajahi kapabilitas model di Playground dan lihat panduan API untuk instruksi terperinci. Sebelum mengakses, pastikan Anda telah login ke CometAPI dan memperoleh API key. CometAPI menawarkan harga yang jauh lebih rendah daripada harga resmi untuk membantu integrasi Anda.

Siap Memulai?→ Uji coba gratis Seedream 4.5 !

Jika Anda ingin mengetahui lebih banyak tips, panduan, dan berita AI, ikuti kami di VK, X dan Discord!

Baca Selengkapnya

500+ Model dalam Satu API

Diskon hingga 20%