Entegrasyon gerçekten küçük. Bir URL'ye bir fotoğraf referansı gönder, durum değişene kadar ikinci bir URL'yi yokla, yanıttaki görsel bağlantısını oku. Daha önce asenkron bir şey teslim ettiyseniz bir saatlik iş.
Sonra biri bunu her yeni işe alımda çalıştırmanın maliyetini sorar ve öğleden sonra kaybolur. Aynı platformdaki bir düzine görsel uç noktasının her biri bir portreyi vesikalık fotoğrafa dönüştürecek. En ucuzu 0,028 $ ve bu indirimli bir fiyat. En pahalısı, tek bir resim için 0,229768 $ tutuyor. Bu farkın çoğu, çözünürlük katmanlarına, kalite işaretlerine ve hangi promosyonun aktif olduğuna dayanıyor, yani yüzün ne kadar iyi çıktığıyla ilgili bir fark değil.
Bu, bir ürüne AI vesikalık fotoğraf API'si entegre eden herkes için bu kararın çalışan bir haritasıdır. Aşağıdaki her fiyat, alan adı ve numaralandırma, 18 Ağustos 2026'daki Atlas Cloud'un kendi şemalarından ve fiyatlandırma uç noktasından gelmiştir.
Önemli Çıkarımlar
- Bir vesikalık fotoğraf, API katmanında kendi model kategorisi değildir. Sabit bir amaca sahip bir görsel düzenleme çağrısıdır, bu nedenle seçtiğiniz uç nokta, kullanıcı başına maliyetinizi istemden çok daha fazla belirler.
- Özel vesikalık fotoğraf uç noktası tam olarak iki alan kabul eder ve bir görsel döndürür. Genel düzenleme uç noktaları bir düzine alan kabul eder ve sonucu kendiniz tanımlamanızı bekler.
- Seedream düzenleme çağrısında boyut parametresini atlamak sizi sessizce daha yüksek fiyatlı katmana yerleştirir ve yakalanacak herhangi bir hata olmadan faturanızı ikiye katlar.
- Platformdaki her model, aynı gönder-ve-yokla döngüsünü paylaşır, bu nedenle daha sonra uç noktaları değiştirmek, bir model dizgisini değiştirmektir, yeniden yazmak değil.
- Herhangi bir kod yazmadan önce çıktı stilini onaylayabilirsiniz: ücretsiz AI vesikalık fotoğraf oluşturucu, uygun her hesaba bir adet tam çözünürlüklü çalıştırma hakkı verir.
Geliştiriciler Neden Bir Vesikalık Fotoğraf Sitesi Yerine AI Vesikalık Fotoğraf API'sine Yöneliyor?
Tüketici vesikalık fotoğraf siteleri bir oturum etrafında inşa edilmiştir. Yüklersiniz, beklersiniz, indirirsiniz ve kota ertesi gün sıfırlanır. Bu döngüdeki hiçbir şey, bu çeyrekte dört yüz çalışanı işe alması gereken ve harcamayı bir maliyet merkezine karşı dengelemesi gereken bir ürünle başa çıkamaz.
Bir API'nin eklediği şey aslında oluşturma değildir. Etrafındaki muhasebedir. Her gönderim, yoklayabileceğiniz bir id ve bir durumla geri gelir; bu, açıklayabileceğiniz bir fatura ile açıklayamayacağınız bir fatura arasındaki farktır.
Daha sessiz ikinci bir avantaj daha vardır. Araç uç noktaları şemalarını yayınlar, böylece birine bağlanmadan önce tüm giriş yüzeyini okuyabilirsiniz. Atlas Cloud, bu tek amaçlı görsel araçlardan oluşan bir aile sunar ve istek şekilleri neredeyse aynıdır:
| Araç uç noktası | Zorunlu alanlar | İsteğe bağlı alanlar | Görsel başına fiyat |
|---|---|---|---|
| atlascloud/tool/headshot | model, image | yok | 0,045 $ |
| atlascloud/photo-cleanup | model, image | output_format | 0,02 $ |
| atlascloud/image-upscaler | model, image | outscale, output_format | 0,01 $ |
Vesikalık fotoğraf girişi, üçünün en katısıdır: bir fotoğraf girer, bir fotoğraf çıkar.
Vesikalık Fotoğraf Özellikleri Oluşturan Geliştiriciler İçin Atlas Cloud'un Yeri
Herhangi bir entegrasyon kodu yazmadan önce modelin gerçekte ne döndürdüğünü görmeye değer, çünkü çıktı stili sabittir ve ya istersiniz ya da istemezsiniz. Atlas Cloud, tek amaçlı araçlarını tek bir sayfada tutar ve AI araçları dizini, vesikalık fotoğraf oluşturucunun ölçeklendirme ve temizleme araçlarının yanında yer aldığı yerdir. Araç sayfası, uygun her kullanıcının bir ücretsiz deneme hakkı olduğunu belirtir ve SSS'si, ücretsiz oluşturmanın tam yüksek çözünürlüklü bir indirme içerdiğini ekler.
Bu ilk çalıştırmadan sonra, aynı model ölçülü bir oyun alanı haline gelir. AI Vesikalık Fotoğraf oyun alanı, fiyatını göndermeden önce Çalıştır düğmesinde yazdırır ve yükleyicinin üzerindeki bir bildirim, varlıkların, yapıştırdığınız bir bağlantıdan çekilmek yerine Atlas Cloud depolama alanına gittiğini açıklar. İstemi kendiniz yazmak ve giysi, arka plan ve çerçevelemeyi kontrol etmek isterseniz, Nano Banana 2 ailesi genel düzenleme yolunu kapsar ve Lite varyantı, sabit araçtan görsel başına daha ucuza gelir. Fiyatlandırma bölümü, bu takasın maliyetini ayrıntılı olarak ele alır.
AI Vesikalık Fotoğraf Oluşturucu API'sini Çağırmanın İki Yolu
Her iki yol da aynı model dizgisini çalıştırır. Fark, sonucun geri gelmesini bir kişinin izleyip izlememesidir.
Yöntem 1: Profesyonel Vesikalık Fotoğraf API'sini Oyun Alanında Test Edin
Giriş yapın, yukarıda bağlantısı verilen oyun alanını açın ve net, önden bir portre yükleyin. Şemanın giriş alanı için kendi açıklaması tam olarak bu ifadedir, bu nedenle model, üç çeyrek profil veya grup kırpma yerine düz bir çekim için ayarlanmıştır.
Çalıştır düğmesi, yapmak üzere olduğunuz çalıştırma için ücreti taşır ve bütçelemeniz gereken sayı budur. Pazarlama sayfası hiçbir fiyat belirtmez, bu nedenle rakamın yaşadığı yer oyun alanıdır. Orada olduğunuzda bilmeniz gereken kullanışlı bir uyumsuzluk: aracın sayfa kopyası, iş kıyafeti, smart casual ve düz bir stüdyo görünümü arasında seçim yapmaktan bahseder, ancak yayınlanan şemada stil alanı yoktur. Kopya ne söylerse söylesin, uç nokta modelin varsayılan iş muamelesini döndürür.
Yöntem 2: AI Vesikalık Fotoğraf API'sini Kendi Kodunuzdan Çağırın
Çalışma akışı iki HTTP isteğidir. Oraya ulaşmak üç adım sürer.
Adım 1: Bir API anahtarı oluşturun. Atlas Cloud konsolunda bir tane oluşturun, kopyalayın ve sunucu tarafında saklayın. Araç uç noktaları, platformdaki her modelle aynı anahtarı alır.
Adım 2: API dokümanlarını kontrol edin. Kimlik doğrulama, paylaşılan görsel uç noktası ve yoklama sözleşmesi API dokümantasyonunda bulunur. Her model ayrıca kendi OpenAPI şemasını yayınlar ve bu şema atlascloud-tool-headshot.json adresindedir; alan adlarını tahmin etmeden önce okumaya değer. Model sayfası ayrıca oyun alanının yanında bir API sekmesi taşır, bu nedenle istek şekli test ettiğiniz yere bir tıklama uzaklığındadır. Burada bana zaman kaybettiren bir şey: kontrol ettiğimde platformun genel model listesi 466 giriş döndürdü ve vesikalık fotoğraf aracı bunların arasında değildi, oysa ölçeklendirme ve fotoğraf temizleme kardeş araçları vardı. Şema, benioku ve fiyatlandırma normal şekilde çözümleniyor, bu nedenle uç nokta canlı. Yalnızca katalog araması onu yüzeye çıkarmayacaktır.
Adım 3: İlk isteği gönderin. Gönderim asenkrondur ve bir tahmin kimliği döndürür.
Bash1curl -X POST https://api.atlascloud.ai/api/v1/model/generateImage \ 2 -H "Content-Type: application/json" \ 3 -H "Authorization: Bearer $ATLASCLOUD_API_KEY" \ 4 -d '{ 5 "model": "atlascloud/tool/headshot", 6 "image": "https://your-cdn.com/portraits/emp-4192.jpg" 7 }'
Durum yerleşene kadar yoklayın:
Bash1curl -s https://api.atlascloud.ai/api/v1/model/prediction/<PREDICTION_ID> \ 2 -H "Authorization: Bearer $ATLASCLOUD_API_KEY"
Tamamlanan yük, outputs (çıktılar) taşır; bu dizi, iş bitene kadar boş kalır ve ardından barındırılan görsel URL'sini tutar. status, döngü koşulunuzdur ve created, processing, completed veya failed değerlerini okur.
İlk çağrınızda varsaymak yerine bir şeyi test edin. Şema, image'ı, dosyanın nerede yaşayabileceğini söylemeden bir görsel referansı olarak türler ve oyun alanı, bu sorunun kendi tarafı konusunda açık sözlüdür. Yükleyicisinin üzerindeki yeşil bildirimde "URL'ler kabul edilmez: görseller ve videolar özel yükleme alanları aracılığıyla gönderilmelidir." yazmaktadır. Kardeş düzenleme modelleri, girdilerini URL'ler olarak belgeler. Bir toplu işi bunun etrafında bağlamadan önce anahtarınızın hangi formu aldığını onaylayın.
Bu istek şekli, içselleştirmeye değer kısımdır. Aynı anahtar, aynı POST ve aynı yoklama çağrısı, platformdaki her görsel modele ulaşır; bu nedenle sabit vesikalık fotoğraf aracından tamamen istemlenebilir bir düzenleyiciye geçmek, model dizgisini düzenlemek ve o modelin kabul ettiği alanları eklemek anlamına gelir. Çalışanınızdaki başka hiçbir şey değişmez.
Oluşturulan Görsel Başına AI Vesikalık Fotoğraf API Fiyatlandırması
Aşağıdaki her rakam, 18 Ağustos 2026'da platformun fiyatlandırma hesaplama uç noktasından, göndereceğim tam isteğe karşı fiyatlandırılmıştır. Bir sonraki alt bölümdeki iki varyant dışında, tümü 100 indirim bayrağı döndürmüştür, yani hiçbir promosyon aktif değildir.
Özel vesikalık fotoğraf uç noktası 0,045 $'dır, bu da bin oluşturulmuş vesikalık fotoğrafı 45 $ yapar. Nano Banana 2 Lite Edit, 0,04 $ ile onu düşürür, bu nedenle aynı hacim 40 $ tutar ve beniokusu, giriş referans görsel sayısının fiyatı etkilemediğini açıkça belirtir. Bin başına 5 $ tasarruf etmek, kendi vesikalık fotoğraf isteminizi yazmak ve sürdürmek anlamına gelir ki bu, bariz olmaktan çok gerçek bir karardır.
Varsayılanlar, paranın sızdığı yerdir. Seedream v5.0 Pro Edit, 1024×1024 veya 2048×1152'de 0,045 $ ücret alır, ancak boyut parametresi varsayılan olarak 2048×2048'dir ve bu da daha yüksek katmana (0,09 $) düşer. Alanı atlayın ve yakalanacak hata olmadan iki kat ödersiniz. Aynı model, ilkinden sonraki her giriş görseli için 0,003 $ ekler; bu, iki görselli bir isteğin 0,048 $ olarak fiyatlandırarak onayladığı bir durumdur. GPT Image 2 Edit, kalıbı farklı bir açıdan tekrarlar: kalite varsayılan olarak 0,071728 $'da orta düzeydir ve yüksek seviyeye geçmek, tek bir 1024×1024 görseli 0,229768 $'a çıkarır.
Çözünürlük katmanları son değişkendir. Nano Banana 2 Edit, 1k, 2k ve 4k için 0,08 $, 0,12 $ ve 0,16 $ ücret alırken, Lite varyantı yalnızca 1k sunar. Birkaç yüz pikselde görüntülenen bir profil fotoğrafı için 4k ödemek, kimsenin görmeyeceği piksellere para harcamaktır.
AI Vesikalık Fotoğraf API Serisindeki İndirimli Geliştirici Uç Noktaları
Yazıldığı gün iki varyant, alan adında aktif bir indirim taşıyordu:
| Uç nokta | Liste fiyatı | Güncel fiyat | İndirim |
|---|---|---|---|
| google/nano-banana-2-lite/edit-developer | 0,04 $ | 0,028 $ | %30 indirim |
| google/nano-banana-2/edit-developer | 0,08 $ | 0,04 $ | %50 indirim |
Hiçbir model sayfası, bir geliştirici uç noktasının standart olandan fiyat dışında nasıl farklı olduğunu açıklamaz, bu nedenle bir maliyet modeli oluştururken indirimsiz rakamı dayanıklı sayı olarak kabul edin. Bu bayraklar daha önce değişti ve kontrol etmenin dürüst yolu, bu makale dahil bir makaledeki bir rakama güvenmek yerine, tam isteğinizi platforma karşı fiyatlandırmaktır.
AI Vesikalık Fotoğraf API'si Bir Yüz Hakkında Neyi Değiştirir?
Sabit uç nokta fikir sahibidir. Beniokusu, işi günlük bir portreyi stüdyo kalitesinde bir iş vesikalık fotoğrafına dönüştürmek olarak tanımlar; bu, pratikte arka plan ve kıyafetin değiştirildiği, yüzün ise tanınabilir şekilde sizinki olarak kalması gerektiği anlamına gelir.
Bir portreyi her iki yoldan da çalıştırdım ve nerede ayrıldıklarını gördüm.
19 Ağustos 2026'da çalıştırıldı. Giriş, gerçek bir kişinin fotoğrafı değil, AI tarafından oluşturulmuş kurgusal bir kişidir.
Her iki çıktı da tanınabilir şekilde aynı yüzdür ve her ikisi de bir kişiyi düz bir arka planda iş kıyafeti içine sokma işini yapmıştır. Farklılıklar, kimsenin istemediği şeylerdedir. Sabit uç nokta, altında hiçbir şey olmayan açık gri bir blazer seçti, kırpmaya karar verdi ve uzun dalgalı saçı olduğu gibi bıraktı. Düzenleme uç noktası, istemin adlandırdığı her öğeyi teslim etti: kömür grisi blazer, beyaz gömlek, açık gri arka plan, baş-omuz çerçevesi, ardından daha da ileri giderek saçı daha düzenli, daha simetrik bir şekle kısalttı. İstem, yüzün değişmemesini istemişti ve saç hakkında hiçbir şey söylememişti.
Genel düzenleme yoluna gitmek, kararları size geri verir, ancak bunları belirtme maliyetiyle birlikte. Her birinin kabul ettiği şeyleri karşılaştırın:
| Alan | atlascloud/tool/headshot | google/nano-banana-2-lite/edit |
|---|---|---|
| prompt | yok | zorunlu |
| image / images | bir görsel, zorunlu | 1 ila 14 görsel, zorunlu |
| aspect_ratio | yok | auto dahil 15 değer |
| resolution | yok | yalnızca 1k |
| thinking_level | yok | default, high, minimal |
| enable_base64_output | yok | yalnızca API, URL yerine BASE64 döndürür |
Planlamanız gereken iki şey. Platformun Lite katmanı için beniokusu, modelin küçük yüzler, doğru yazım ve çok ince detaylarla zorlanabileceğini söyler. Bu testteki giriş, yüzün çerçevenin küçük bir kısmını kapladığı tam boy bir çekim olarak başladı ve sorunsuz geldi, bu nedenle uyarı sert bir taban değildir, ancak bir grup fotoğrafı kırpması daha zor bir durumdur ve taramaya değer. Aynı benioku, düzenlenmiş görsellerin varsayılan olarak C2PA içerik kimlik bilgileri ve algılanamaz bir SynthID filigranı içerdiğini belirtir. Bu imza dosyayla birlikte seyahat eder. LinkedIn, C2PA bilgisi eklenmiş herhangi bir görselde içerik kimlik bilgilerini gösterir, bu nedenle bu şekilde oluşturulan bir vesikalık fotoğraf, kökeni sergilenerek bir profile yerleşebilir.
Yüz doğru olduğu sürece bu sorun değildir. LinkedIn'in profil fotoğrafı yönergeleri, kendinizin bir illüstrasyonuna veya sanatsal yorumuna izin verir, ancak fotoğrafın sizin benzerliğinizi yansıtması şartıyla. Bir AI vesikalık fotoğrafı bu testi geçer. Kullanıcının kendisine ait olmayan oluşturulmuş bir yüz ise geçmez.
Bir AI Vesikalık Fotoğraf API'sini Üretimde Çalıştırmak
Göndermeden önce karar vermeye değer birkaç şey.
| Endişe | Platformun size verdiği | Makul varsayılan |
|---|---|---|
| İş tamamlama | Her tahminde dört durumlu bir durum | Geri çekilmeli yoklama, başarısız olanı bir kez yeniden dene |
| Gecikme | Şemada tamamlanma süresi rakamı yok | İşi kuyruğa al, sayfa işlemesini asla bunun için engelleme |
| Yoklamayı atlama | Genel düzenleme modellerinde enable_sync_mode var, sabit araçta yok | Senkron modu yalnızca etkileşimli tek istekler için kullan |
| Çıktı işleme | Barındırılan URL'lerden oluşan outputs dizisi | Tamamlandığında kendi depolamanıza kopyalayın |
| Giriş kalitesi | Şema, net bir önden portre ister, daha spesifik bir şey değil | Bir çağrı harcamadan önce grup kırpmalarını ve küçük yüzleri eleyin |
| Onay | Sorumlu kullanım notu, yüklediğiniz medya için yetkilendirme gerektirir | Yükleme akışında onayı yakalayın, kaydı saklayın |
Son satır, ekiplerin atladığı satırdır. Uç noktanın kendi dokümantasyonu, gerçek bir kişinin benzerliğini düzenlemeden veya oluşturmadan önce onay almanızı ve sonuçları aldatmak, taciz etmek veya kimlik taklidi yapmak için kullanmaktan kaçınmanızı ister. Özelliğiniz çalışan fotoğraflarını otomatik olarak vesikalık fotoğraflara dönüştürüyorsa, onay adımı, kimsenin okumadığı bir politika belgesi yerine yükleme akışına ait olur.
Sıkça Sorulan Sorular
Ücretsiz katmanı olan bir AI vesikalık fotoğraf API'si var mı?
API'nin kendisi ilk çağrudan itibaren ölçülüdür. Ücretsiz çalıştırma, uygun her hesabın bir tam çözünürlüklü oluşturma hakkı aldığı araç sayfasında bulunur. Çıktı stilini onaylamak için kullanın, ardından entegre ettiğinizde görsel başına fiyatlandırma için bütçe yapın.
Profesyonel bir vesikalık fotoğraf API çağrısı için hangi model dizgisini kullanmalıyım?
atlascloud/tool/headshot: bakımı gereken bir istem olmadan sabit iş muamelesi istiyorsanız. google/nano-banana-2-lite/edit: giysi, arka plan veya en boy oranı üzerinde kontrole ihtiyacınız varsa ve talimatı kendiniz yazmaya istekliyseniz. Her ikisi de /api/v1/model/generateImage adresine POST yapar.
AI vesikalık fotoğraf API'sinin görsel başına maliyeti nedir?
18 Ağustos 2026 itibarıyla özel uç nokta üzerinden 0,045 $, aktif indirim yok. Aynı platformda fiyatlandırdığım on iki uç nokta arasında, tek bir düzenlenmiş görsel, modele, çözünürlük katmanına ve kalite ayarına bağlı olarak 0,028 $ ile 0,229768 $ arasında değişiyordu.
AI vesikalık fotoğraf oluşturucu API'si kişinin gerçek yüzünü koruyor mu?
Belirtilen davranış budur: araç, yeni bir kişi oluşturmak yerine arka planı ve kıyafeti değiştirir. Doğruluk büyük ölçüde girdiye bağlıdır ve kaynak fotoğrafta küçük veya açılı bir yüz, modele koruyacak daha az şey verir.
AI vesikalık fotoğraf API çıktıları filigranlı veya imzalı mı?
Nano Banana 2 Lite düzenlemeleri, platformdaki model dokümantasyonuna göre varsayılan olarak C2PA içerik kimlik bilgileri ve bir SynthID filigranı içerir. İmzalama davranışı modele özgüdür, bu nedenle hangi uç noktaya karar verirseniz verin, beniokuyu kontrol edin.
Bir API aracılığıyla oluşturulan vesikalık fotoğraflar LinkedIn'de kullanılabilir mi?
Evet, görselin gerçek kişiyi yansıtması koşuluyla. LinkedIn'in fotoğraf yönergeleri, kendinizin sanatsal yorumlarına izin verir ve yalnızca başkalarının benzerliklerinden, stok görsellerden veya kurgusal karakterlerden oluşan fotoğrafları yasaklar.
Sonuç
İhtiyacınız olan standart bir iş vesikalık fotoğrafıysa ve bir isteme sahip olmayı tercih etmiyorsanız, sabit uç nokta daha kısa yoldur. İki alan, bir çıktı, çağırmadan önce okuyabileceğiniz bir fiyat.
Ürününüzün belirli bir şeye ihtiyaç duyduğu an, belirli bir ceket, bir marka arka planı, kart bileşeninize uyan bir portre kırpması, bu uç noktanın sunacağı hiçbir şey yoktur ve planlamış olsanız da olmasanız da bir istem yazıyorsunuz demektir. Buna iki soru karar verir ve hiçbiri birim fiyat değildir. Bu istemi iki yıl sonra hala birisi sürdürecek mi? Ve 1k çıktı ile 4k çıktı arasındaki fark bir kullanıcının ekranına hiç ulaşacak mı?
