Nesne kaldırma API'si: GPT Image 2 ile fotoğraftan nesneyi tek cümleyle silin

Nesne başına tek bir metin komutu GPT-Image 2 düzenleme uç noktası için yetti. 28 Ekim 2026'da üç çalıştırmada aynı park fotoğrafından bir kadını köpeğiyle, mavi bir çöp kutusunu ve kırmızı bir uçurtmayı tek cümleyle kaldırdık. Her kaldırmada boşalan yer çevresiyle uyumlu kapandı; bank, ağaçlar ve ufuk çizgisi yerinde kaldı.

İstek bir komut ve bir kaynak görsel gönderip baştan sona yeni bir fotoğraf döndürür. Aşağıda çalıştırdığımız Python kodu, üç sonucun tam boy hâli ve yeniden yapmak isteyeceğiniz bir dolguyu yakalayan kontroller var.

Komutla kaldırma ne yapar

Bir fotoğraf ve bir cümle gönderirsiniz. Cümle nesneyi adlandırır, yerine ne gelmesi gerektiğini söyler ve yerinde kalması gerekenleri listeler. Model o bölgeyi yeniden çizer ve baştan sona yeni bir görsel döndürür, yani ayrı bir birleştirme adımı yoktur.

Çağrı, OmniaKey'deki diğer bütün düzenlemelerle aynı medya görevidir: model gpt-image-2, type image, operation edit, kaynak fotoğraf Base64 olarak input image alanında, cümle input prompt içinde. parameters içinde size WIDTHxHEIGHT biçiminde yazılır ve quality low, medium, high ya da auto olabilir; n 1 olmalıdır. İki işlem de model sayfasında listeleniyor.

Her şeyi ifade belirler. "Gökyüzündeki küçük kırmızı uçurtma" ile "şu kırmızı şey" farklı işlerdir; "çim ve parke taşları" gibi bir dolgu da boşalan yeri neyin kaplayacağını belirler. Cümle sırasını GPT Image 2 komut rehberi anlatıyor; FLUX Kontext alternatifi rehberi de aynı tür komutu GPT Image 2 üzerinde kullanıyor.

İstek

Tek bir Python dosyası bütün işi yapar: fotoğrafı kodlar, görevi oluşturur, bitene kadar sorgular ve PNG'yi indirir.

import base64
import json
import os
import time
import urllib.request
import uuid

API = "https://api.omniakey.com/v1/media/tasks"
KEY = os.environ["OMNIAKEY_API_KEY"]


def request(method, url, body=None, extra_headers=None):
    headers = {"Authorization": f"Bearer {KEY}", "User-Agent": "omniakey-example/1"}
    data = None
    if body is not None:
        headers["Content-Type"] = "application/json"
        data = json.dumps(body).encode()
    headers.update(extra_headers or {})
    req = urllib.request.Request(url, data=data, headers=headers, method=method)
    with urllib.request.urlopen(req, timeout=120) as resp:
        return json.load(resp)


def edit_image(source_path, prompt, out_path, size="1024x1536", quality="medium"):
    with open(source_path, "rb") as f:
        image = base64.b64encode(f.read()).decode()
    body = {
        "model": "gpt-image-2",
        "type": "image",
        "operation": "edit",
        "input": {"prompt": prompt, "image": {"data": image, "mime_type": "image/jpeg"}},
        "parameters": {"size": size, "quality": quality},
    }
    task = request("POST", API, body, {"Idempotency-Key": str(uuid.uuid4())})["id"]
    for _ in range(150):
        time.sleep(4)
        state = request("GET", f"{API}/{task}")
        if state["status"] not in ("queued", "processing"):
            break
    if state["status"] != "succeeded":
        raise RuntimeError(state.get("error") or state["status"])
    asset_url = state["assets"][0]["url"]  # signed link: valid for about an hour, so download now
    req = urllib.request.Request(asset_url, headers={"User-Agent": "omniakey-example/1"})
    with urllib.request.urlopen(req, timeout=120) as resp, open(out_path, "wb") as f:
        f.write(resp.read())
    return task
if __name__ == "__main__":
    task = edit_image(
        "park-base.jpg",
        "Remove the blue trash bin completely. Fill its spot with grass and paving stones so it matches the surroundings. Keep everything else exactly the same. Photorealistic, no text, no logos.",
        "park-no-bin.png",
        size="1536x1024",
    )
    print("task", task)

Fonksiyonu 28 Ekim 2026'da farklı bir komutla, sarı bir yağmurlukla, temel modelin 1024 piksellik JPEG'i üzerinde denedik ve 1024x1536 PNG döndü.

• Oluşturma isteği HTTP 202 ve bir görev id'si döndürür (OmniaKey görsel dokümanları, 28 Ekim 2026'da kontrol edildi). Durum queued veya processing'den çıkana kadar aynı görevi sorgulayın; succeeded dosyaların hazır olduğu anlamına gelir, başarısız görev ise hata kodu ve mesajıyla gelir ve ücretlendirilmez.
• İmzalı dosya bağlantısı yaklaşık bir saat geçerlidir, dosyanın kendisi 24 saat saklanır. API anahtarı göndermeyen düz bir GET ile hemen indirin.
• Gövdedeki Base64, 1 MiB'lık istek sınırına sayılır; bu yüzden telefon fotoğrafını önce küçültün.
• User-Agent başlığını gönderin: 28 Ekim 2026'da Python'un varsayılan User-Agent değeriyle giden istek HTTP 403 döndü, başlık eklenince düzeldi.
• size açıkça verilir, bu yüzden yatay bir fotoğraf 1536x1024 olarak gider. GPT Image her zaman opak PNG döndürür, gerçek boyutları indirilen dosyadan okuyun.

Maliyete gelince, OpenAI'nin fiyat sayfası GPT Image 2 için milyon görsel giriş token'ı başına $8.00, milyon görsel çıkış token'ı başına $30.00 yazıyor; toplu fiyatlar bunun yarısı (28 Ekim 2026'da kontrol edildi). Sayfada görsel başına tablo yok; görsel üretimi rehberinde tek görsel için bir hesaplayıcı var. OmniaKey'in güncel ücreti fiyat sayfasında.

Aynı park fotoğrafında üç kaldırma

Dört görselin hepsi tek bir temel kareden geliyor: güneşli bir şehir parkı yolu, ortada ahşap bir bank, solda mavi metal bir çöp kutusu, kameraya doğru küçük kahverengi bir köpeği gezdiren bir kadın ve berrak gökyüzünün yükseklerinde küçük kırmızı bir uçurtma. Temel görsel ve sonuçlar 1536x1024, quality medium olarak 28 Ekim 2026'da OmniaKey üzerinden GPT Image 2 ile üretildi; sahne ve insanlar sentetik. Nesne başına bir cümle gönderdik ve her birini bir kez çalıştırdık.

28 Ekim 2026'da OmniaKey API'si üzerinden GPT-Image 2 ile üretildi, boyut 1536x1024, kalite medium.

İkinci kutuda kadın ve köpek yok, yol ile çim arkalarından kapanıyor; bank, kutu, ağaçlar, uçurtma ve ufuk çizgisi yerinde duruyor. Üçüncü kutu çöp kutusunu çıkarıyor ve yerini çim ile parke taşından yeniden kuruyor, kadın ve köpek hâlâ karede. Dördüncü kutu uçurtmayı temizliyor ve gökyüzü aynı kalıyor.

Her kaldırmadan sonra ne kontrol edilir

Bir kaldırmayı yayına almadan önce her kutuyu gerçek boyutta okuyun.

• Dolgunun kenarı ve karenin geri kalanı. Yeni çim, parke taşı veya yol dokusu bir yerde eskiyle birleşir ve model tüm resmi yeniden çizer; bu ek yerini ve nesnenin çevresindeki bir şeridi kaynak fotoğrafla karşılaştırın. Yumuşak, tekrarlayan ya da bulanık bir alan ilk orada görünür.
• Nesneye değen her şey. Tasma, gölge veya yansıma da onunla birlikte yeniden kurulmalı.
• Korunacaklar listesi, tek tek. 1. kaldırma bankı, kutuyu, ağaçları, uçurtmayı ve gökyüzünü korudu; 2. kaldırma kadını ve köpeği korudu. Her maddeyi adlandırın, sonra sonuçta onu arayın.

Neyi test etmedik

Maske girişini, kalabalık sahneleri ve çok küçük nesneleri test etmedik; bu yüzden fotoğrafınızda kalabalık, çit sırası veya tasma gibi ince bir şerit varsa ikinci bir çalıştırma planlayın ve o kenarı tam boyutta okuyun.

Komut şablonu

[Nesneyi, onu ayırt eden ayrıntıyla birlikte] tamamen kaldırın. Yerini [malzeme] ile, çevreye uyacak şekilde doldurun. [Kalması gerekenleri] tamamen aynı bırakın. Fotogerçekçi, yazı yok, logo yok.

• Nesne, onu ayırt eden ayrıntıyla. "Gökyüzündeki küçük kırmızı uçurtma", "uçurtma"dan iyidir ve karede birkaç uçurtma varsa hangisini kastettiğinizi modele söyler.
• Dolgu, malzeme olarak. "Çim ve parke taşı" modele çevreyle hizalanacak bir şey verir; tek başına "kaldır" seçimi modele bırakır.
• Korunacaklar listesi. Hayatta kalması gerekenleri adlandırın: bank, mavi çöp kutusu, ağaçlar, uçurtma, gökyüzü.
• Stil kuyruğu. "Fotogerçekçi, yazı yok, logo yok" fotoğrafın fotoğraf gibi görünmesini sağlar.

Bir kişide kıyafet değiştirmek için aynı kalıp, kıyafet değişen nesne olarak adlandırıldığında da çalışır; sanal deneme rehberi bu durumu anlatıyor.

Sık sorulan sorular

Bir kişiyi API ile fotoğraftan kaldırabilir miyim?

Evet, sonucu kontrol etmek koşuluyla. 1. kaldırmada kadın ve köpeği tek adımda kareden çıktı, yol ve çim arkalarında yeniden oluştu.

Uç nokta maske kabul ediyor mu?

OmniaKey dokümanları bir kaynak görsel ve bir komut tanımlıyor (28 Ekim 2026'da kontrol edildi). Maske alanı tanımlanmıyor ve maske test edilmedi. Nesneyi ve konumunu resimle boyamak yerine kelimelerle adlandırıyorsunuz.

Sonuç bağlantıları ne kadar geçerli?

İmzalı bağlantı yaklaşık bir saat geçerlidir (OmniaKey dokümanları, 28 Ekim 2026'da kontrol edildi), dosyanın kendisi 24 saat saklanır. Görev succeeded olur olmaz indirin.

Hangi boyutu istemeliyim?

size değerini açık bir WIDTHxHEIGHT olarak verin, yatay fotoğraf için 1536x1024 gibi, gerçek boyutları indirilen PNG'den okuyun. GPT Image her zaman opak bir dosya döndürür, kırpmayı indirmeden sonra planlayın.

Tek komut iki nesneyi kaldırabilir mi?

1. kaldırmada tek cümle bir kadını ve köpeğini birlikte kaldırdı. Diğer ikililer test edilmedi.

Parametreler için GPT-Image 2 model sayfasından başlayın ve bir sonraki kaldırmayı planlamadan önce güncel fiyatları kontrol edin.