Felo API PlatformFelo API Platform
Kembali ke model

Ideogram 4.5 Replace Background API

Model pengeditan gambar dari Ideogram 4.5 yang menghapus dan mengganti latar belakang sambil mempertahankan subjek utama dan detail piksel asli.

Ideogram 4.5 Replace Background adalah bagian dari keluarga Ideogram 4.5 yang berfokus pada kemampuan pengeditan presisi. Model ini dirancang untuk menghapus dan mengganti latar belakang gambar sambil mempertahankan subjek utama foreground secara akurat. Output yang dihasilkan siap produksi dengan struktur bersih dan detail tajam, serta mendukung generasi resolusi native 2K.

Salah satu keunggulan utamanya adalah kemampuan mempertahankan piksel yang tidak diedit tanpa pergeseran piksel atau perubahan warna. Model menyalin piksel yang tidak disentuh dari gambar sumber dan mempertahankan ukuran aslinya. Dalam satu permintaan, model dapat menerima hingga lima gambar sumber untuk diedit, dan mendukung mask opsional untuk membatasi pengeditan pada area tertentu: piksel hitam diedit, piksel putih dipertahankan.

Model ini cocok untuk berbagai tugas seperti membuat potongan produk bersih untuk daftar toko online, mengganti latar belakang sambil mempertahankan produk secara tepat untuk kampanye pemasaran, menukar latar belakang untuk menampilkan pengaturan ruangan berbeda dalam desain interior, serta alur kerja restorasi foto dengan pengeditan berurutan. Ideogram 4.5 Replace Background mewarisi kemampuan rendering teks yang kuat dari keluarga Ideogram dan terintegrasi ke dalam alur kerja pengeditan yang komprehensif. Model tersedia melalui platform dan API Ideogram, serta melalui mitra peluncuran Picsart, Runway, Pika, dan Leonardo AI. Rilis berbobot terbuka telah diumumkan akan segera hadir.

Diperbarui:

ID MODEL

ideogram-4-5/replace-background
Konteks
2.048K
Masukan
text / image
Keluaran
image

Sorotan

  • Pengeditan latar belakang presisi
  • Resolusi native 2K
  • Mempertahankan piksel asli
  • Dukungan hingga lima gambar sumber
  • Mask opsional untuk area terbatas
  • Rendering teks dari keluarga Ideogram

Penyedia

1 penyedia

Bandingkan harga API antarpenyedia. Pilih penyedia untuk melihat semua biaya dan ketentuan.

Penyedia · Detail harga
Ketersediaan
$0.176

Mulai cepat

Kirim tugas gambar, periksa status, lalu simpan gambar. Contoh menggunakan curl dan pustaka standar Python 3.

POST https://openapi.felo.ai/api/v1/images/generations

1Siapkan kunci API

Buat kunci dari akun Felo API Platform Anda dan tetapkan sebagai variabel lingkungan.

export FELO_API_KEY="YOUR_API_KEY"

2Kirim permintaan pertama

Nilai opsional berbeda per model dan tidak ditetapkan di sini. Periksa di Playground. Kolom sejajar dengan model dan prompt, tanpa pembungkus input.

curl --fail-with-body --max-time 60 "https://openapi.felo.ai/api/v1/images/generations" \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -o created.json \
  -d '{
  "prompt": "A studio product photo of a ceramic coffee cup on warm linen, soft morning light",
  "model": "ideogram-4-5/replace-background"
}'

3Polling tugas

Pengiriman mengembalikan task_id. Periksa setiap 3 detik saat queued atau running; berhenti saat succeeded, failed, atau interrupted. Tunggu maksimal 30 menit. Simpan created.json untuk melanjutkan pemeriksaan tanpa mengirim ulang.

python3 - <<'PY'
import json, os, time
from pathlib import Path
from urllib.parse import quote
from urllib.request import Request, urlopen

task = json.loads(Path("created.json").read_text())
task_id = task["task_id"]
url = "https://openapi.felo.ai/api/v1/images/generations/" + quote(task_id, safe="")
headers = {"Authorization": "Bearer " + os.environ["FELO_API_KEY"]}
deadline = time.monotonic() + 1800

while task["status"] in ("queued", "running"):
    if time.monotonic() >= deadline:
        raise TimeoutError(f"Keep task_id={task_id} to resume polling")
    time.sleep(3)
    with urlopen(Request(url, headers=headers), timeout=60) as response:
        task = json.load(response)
    if task.get("task_id") != task_id or task.get("kind") != "image":
        raise ValueError("Unexpected task response")
    print(task["status"])

if task["status"] != "succeeded":
    raise RuntimeError(task.get("error") or task["status"])
if not task.get("outputs"):
    raise ValueError("Task succeeded without image outputs")
Path("task.json").write_text(json.dumps(task))
print("Saved task.json")
PY

4Unduh output

Setelah berhasil, simpan outputs dari task.json. Mendukung URL HTTPS, objek URL, dan b64_json. Segera unduh URL bertanda tangan; unduhan gambar tidak memerlukan kunci API.

python3 - <<'PY'
import base64, json
from pathlib import Path
from urllib.request import urlopen

task = json.loads(Path("task.json").read_text())
if task.get("status") != "succeeded" or not task.get("outputs"):
    raise ValueError("No completed image outputs")
extensions = {"image/png": ".png", "image/jpeg": ".jpg", "image/webp": ".webp", "image/gif": ".gif", "image/avif": ".avif"}

for index, output in enumerate(task["outputs"], 1):
    item = output if isinstance(output, dict) else {}
    url = output if isinstance(output, str) else item.get("url") or item.get("unsigned_url")
    mime = item.get("media_type") or "image/png"
    if url and url.startswith("https://"):
        with urlopen(url, timeout=60) as response:
            data = response.read()
            mime = response.headers.get_content_type()
    elif url and url.startswith("data:image/") and ";base64," in url:
        header, encoded = url.split(",", 1)
        mime = header[5:].split(";", 1)[0]
        data = base64.b64decode(encoded, validate=True)
    elif item.get("b64_json"):
        data = base64.b64decode(item["b64_json"], validate=True)
    else:
        raise ValueError("Unrecognized image output")
    path = Path(f"image-{index}" + extensions.get(mime, ".bin"))
    path.write_bytes(data)
    print(path)
PY

Ingin referensi lengkap?

Referensi API →

Pertanyaan umum

Mengenal Ideogram 4.5 Replace Background?

Ideogram 4.5 Replace Background adalah bagian dari keluarga Ideogram 4.5 yang berfokus pada kemampuan pengeditan presisi. Model ini dirancang untuk menghapus dan mengganti latar belakang gambar sambil mempertahankan subjek utama foreground secara akurat. Output yang dihasilkan siap produksi dengan struktur bersih dan detail tajam, serta mendukung generasi resolusi native 2K. Salah satu keunggulan utamanya adalah kemampuan mempertahankan piksel yang tidak diedit tanpa pergeseran piksel atau perubahan warna. Model menyalin piksel yang tidak disentuh dari gambar sumber dan mempertahankan ukuran aslinya. Dalam satu permintaan, model dapat menerima hingga lima gambar sumber untuk diedit, dan mendukung mask opsional untuk membatasi pengeditan pada area tertentu: piksel hitam diedit, piksel putih dipertahankan. Model ini cocok untuk berbagai tugas seperti membuat potongan produk bersih untuk daftar toko online, mengganti latar belakang sambil mempertahankan produk secara tepat untuk kampanye pemasaran, menukar latar belakang untuk menampilkan pengaturan ruangan berbeda dalam desain interior, serta alur kerja restorasi foto dengan pengeditan berurutan. Ideogram 4.5 Replace Background mewarisi kemampuan rendering teks yang kuat dari keluarga Ideogram dan terintegrasi ke dalam alur kerja pengeditan yang komprehensif. Model tersedia melalui platform dan API Ideogram, serta melalui mitra peluncuran Picsart, Runway, Pika, dan Leonardo AI. Rilis berbobot terbuka telah diumumkan akan segera hadir.

Bagaimana penggunaan ditagih?

Tagihan Anda bergantung pada penyedia yang digunakan, tarifnya, dan penggunaan Anda. Masukan yang lebih panjang atau ketentuan lain dapat memiliki harga berbeda.

Apa kemampuan utama Ideogram 4.5 Replace Background?

Model ini menghapus dan mengganti latar belakang gambar sambil mempertahankan subjek utama foreground. Output yang dihasilkan siap produksi dengan struktur bersih dan detail tajam.

Berapa resolusi output yang didukung?

Model mendukung generasi resolusi native 2K. Ukuran gambar asli juga dipertahankan selama pengeditan.

Apakah model mendukung mask untuk pengeditan?

Ya, model mendukung mask opsional untuk membatasi pengeditan pada area tertentu. Piksel hitam akan diedit, sedangkan piksel putih dipertahankan.

Berapa banyak gambar sumber yang dapat diterima dalam satu permintaan?

Model dapat menerima hingga lima gambar sumber dalam satu permintaan untuk diedit.

Apa perbedaan Ideogram 4.5 Replace Background dengan model Ideogram 4.5 lainnya?

Ideogram 4.5 Replace Background adalah bagian dari keluarga Ideogram 4.5 yang berfokus pada pengeditan presisi, khususnya penggantian latar belakang. Model ini mewarisi kemampuan rendering teks dari keluarga Ideogram.

Model terkait