Integrasinya benar-benar kecil. Unggah referensi foto ke satu URL, polling URL kedua hingga status berubah, baca tautan gambar dari payload. Satu jam kerja jika Anda pernah mengirimkan sesuatu secara asinkron sebelumnya.
Lalu seseorang bertanya berapa biaya untuk menjalankan ini untuk setiap karyawan baru, dan sore harinya lenyap. Selusin titik akhir gambar di platform yang sama masing-masing akan mengubah potret menjadi headshot. Yang termurah berada di $0,028, dan itu adalah harga diskon. Yang termahal membutuhkan $0,229768 untuk satu gambar. Sebagian besar rentang itu melacak kembali ke tingkatan resolusi, flag kualitas, dan promosi apa pun yang sedang berjalan, yang bukan hal yang sama dengan rentang seberapa bagus hasil wajahnya.
Ini adalah peta kerja dari keputusan itu bagi siapa pun yang membangun API AI headshot ke dalam sebuah produk. Setiap harga, nama bidang, dan enum di bawah berasal dari skema Atlas Cloud sendiri dan titik akhir penetapan harganya pada 18 Agustus 2026.
Poin Penting
- Headshot bukan kategori model tersendiri di lapisan API. Itu adalah panggilan edit gambar dengan maksud tetap, sehingga titik akhir yang Anda pilih menentukan biaya per pengguna Anda jauh lebih banyak daripada prompt.
- Titik akhir headshot khusus menerima tepat dua bidang dan mengembalikan satu gambar. Titik akhir edit umum menerima selusin bidang dan mengharapkan Anda menjelaskan hasilnya sendiri.
- Meninggalkan parameter ukuran dari panggilan edit Seedream secara diam-diam menempatkan Anda di tingkatan harga yang lebih tinggi, yang menggandakan tagihan tanpa kesalahan yang dapat ditangkap.
- Setiap model di platform berbagi satu loop submit-and-poll, sehingga menukar titik akhir di kemudian hari adalah perubahan pada string model, bukan penulisan ulang.
- Anda dapat mengonfirmasi gaya keluaran sebelum menulis kode apa pun: pembuat headshot AI gratis memberikan setiap akun yang memenuhi syarat satu kali proses resolusi penuh.
Mengapa Pengembang Menggunakan API AI Headshot daripada Situs Headshot
Situs headshot konsumen dibangun di sekitar sesi. Anda mengunggah, menunggu, mengunduh, dan jatahnya direset besok. Tidak ada apa pun dalam loop itu yang bertahan dalam kontak dengan produk yang harus mendaftarkan empat ratus karyawan kuartal ini dan merekonsiliasi pengeluaran terhadap pusat biaya.
Apa yang ditambahkan API sebenarnya bukanlah pembuatan gambar. Itu adalah pembukuan di sekitarnya. Setiap pengiriman kembali dengan id dan status yang dapat Anda polling, yang merupakan perbedaan antara faktur yang dapat Anda jelaskan dan faktur yang tidak bisa.
Ada keuntungan kedua yang lebih tenang. Titik akhir alat menerbitkan skema mereka, sehingga Anda dapat membaca seluruh permukaan input sebelum berkomitmen pada satu. Atlas Cloud mengekspos serangkaian alat gambar tujuan tunggal ini, dan bentuk permintaan mereka hampir identik:
| Titik akhir alat | Bidang wajib | Bidang opsional | Harga per gambar |
|---|---|---|---|
| atlascloud/tool/headshot | model, image | none | $0.045 |
| atlascloud/photo-cleanup | model, image | output_format | $0.02 |
| atlascloud/image-upscaler | model, image | outscale, output_format | $0.01 |
Entri headshot adalah yang paling ketat dari ketiganya: satu foto masuk, satu foto keluar.
Di Mana Atlas Cloud Cocok untuk Pengembang yang Membangun Fitur Headshot
Perlu melihat apa yang sebenarnya dikembalikan model sebelum Anda menulis kode integrasi apa pun, karena gaya keluaran sudah tetap dan Anda menginginkannya atau tidak. Atlas Cloud menyimpan alat tujuan tunggalnya di satu halaman, dan indeks AI tools adalah tempat pembuat headshot berada bersama dengan upscaling dan pembersihan. Halaman alat menyatakan bahwa setiap pengguna yang memenuhi syarat mendapatkan satu uji coba gratis, dan FAQ-nya menambahkan bahwa generasi gratis mencakup unduhan resolusi tinggi penuh.
Setelah proses pertama itu, model yang sama menjadi taman bermain terukur. AI Headshot playground mencetak harganya di tombol Run sebelum Anda mengirimkan, dan pemberitahuan di atas pengunggah menjelaskan bahwa aset masuk ke penyimpanan Atlas Cloud daripada diambil dari tautan yang Anda tempel. Jika Anda lebih suka menulis prompt sendiri dan mengontrol pakaian, latar belakang, dan pembingkaian, keluarga Nano Banana 2 mencakup rute pengeditan umum, dan varian Lite-nya kebetulan berjalan lebih murah per gambar daripada alat tetap. Bagian penetapan harga akan membahas biaya perdagangan itu.
Dua Cara Memanggil API AI Headshot Generator
Kedua jalur menjalankan string model yang sama. Perbedaannya adalah apakah seseorang melihat hasilnya kembali.
Metode 1: Uji API Professional Headshot di Playground
Masuk, buka playground yang ditautkan di atas, dan unggah potret menghadap depan yang jelas. Deskripsi skema sendiri untuk bidang input adalah tepat frasa itu, sehingga model disetel untuk bidikan lurus ke depan daripada profil tiga perempat atau potongan grup.
Tombol Run membawa biaya untuk proses yang akan Anda lakukan, dan itu adalah angka yang harus dianggarkan. Halaman pemasaran tidak mengutip harga sama sekali, sehingga playground adalah tempat angka itu berada. Satu ketidakcocokan berguna yang perlu diketahui saat Anda di sana: salinan halaman alat menyebutkan memilih antara formal bisnis, kasual cerdas, dan tampilan studio polos, tetapi skema yang diterbitkan tidak memiliki bidang gaya. Apa pun yang disarankan salinan, titik akhir mengembalikan perlakuan bisnis default model.
Metode 2: Panggil AI Headshot API dari Kode Anda Sendiri
Alur berjalannya adalah dua permintaan HTTP. Untuk sampai ke sana membutuhkan tiga langkah.
Langkah 1: Buat kunci API. Hasilkan satu di konsol Atlas Cloud, salin, dan simpan di sisi server. Titik akhir alat mengambil kunci yang sama seperti setiap model di platform.
Langkah 2: Periksa docs API. Otentikasi, titik akhir gambar bersama, dan kontrak polling ada di dokumentasi API. Setiap model juga menerbitkan skema OpenAPI-nya sendiri, dan yang ini adalah atlascloud-tool-headshot.json, layak dibaca sebelum Anda menebak nama bidang. Halaman model juga membawa tab API di samping playground, sehingga bentuk permintaan hanya satu klik dari tempat Anda mengujinya. Satu hal yang memakan waktu saya di sini: daftar model publik platform mengembalikan 466 entri ketika saya periksa dan alat headshot tidak ada di antaranya, meskipun alat saudaranya untuk upscaling dan pembersihan foto ada. Skema, readme, dan harga semuanya beres normal, sehingga titik akhir aktif. Pencarian katalog saja tidak akan memunculkannya.
Langkah 3: Kirim permintaan pertama. Pengiriman bersifat asinkron dan mengembalikan id prediksi.
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 }'
Polling hingga statusnya menetap:
Bash1curl -s https://api.atlascloud.ai/api/v1/model/prediction/<PREDICTION_ID> \ 2 -H "Authorization: Bearer $ATLASCLOUD_API_KEY"
Payload yang selesai membawa outputs, sebuah array yang tetap kosong sampai pekerjaan selesai dan kemudian menyimpan URL gambar yang dihosting. status adalah kondisi loop Anda dan membaca created, processing, completed, atau failed.
Uji satu hal pada panggilan pertama itu daripada menganggapnya. Skema mengetik image sebagai referensi gambar tanpa mengatakan di mana file itu mungkin berada, dan playground terus terang tentang sisi pertanyaan itu sendiri. Pemberitahuan hijau di atas pengunggahnya berbunyi "URLs not accepted: images and videos must be submitted via dedicated upload fields." Model edit saudara mendokumentasikan input mereka sebagai URL. Konfirmasi formulir mana yang diambil kunci Anda sebelum Anda menghubungkan pekerjaan batch di sekitarnya.
Bentuk permintaan itu adalah bagian yang perlu diinternalisasi. Kunci yang sama, POST yang sama, dan panggilan polling yang sama menjangkau setiap model gambar di platform, sehingga berpindah dari alat headshot tetap ke editor yang sepenuhnya dapat diprompt di kemudian hari berarti mengedit string model dan menambahkan bidang yang diterima model itu. Tidak ada yang lain dalam pekerja Anda yang berubah.
Harga AI Headshot API per Gambar yang Dihasilkan
Setiap angka di bawah berasal dari titik akhir kalkulasi harga platform pada 18 Agustus 2026, dengan harga terhadap permintaan tepat yang akan saya kirim. Semuanya mengembalikan flag diskon 100, artinya tidak ada promosi yang berjalan, selain dua varian di subbagian berikutnya.
Titik akhir headshot khusus berada di $0,045, yang menempatkan seribu headshot yang dihasilkan sebesar $45. Nano Banana 2 Lite Edit menguranginya di $0,04, sehingga volume yang sama berjalan $40, dan readme-nya eksplisit bahwa jumlah gambar referensi input tidak mempengaruhi harga. Menghemat $5 per seribu itu berarti menulis dan memelihara prompt headshot Anda sendiri, yang merupakan keputusan nyata daripada yang jelas.
Default adalah tempat kebocoran uang. Seedream v5.0 Pro Edit mengenakan biaya $0,045 pada 1024×1024 atau 2048×1152, tetapi parameter ukurannya default ke 2048×2048, yang masuk ke tingkatan lebih tinggi di $0,09. Hilangkan bidang itu dan Anda membayar dua kali lipat tanpa kesalahan yang dapat ditangkap. Model yang sama menambahkan $0,003 untuk setiap gambar input setelah yang pertama, yang dikonfirmasi oleh permintaan dua gambar dengan harga $0,048. GPT Image 2 Edit mengulangi pola dari sudut yang berbeda: kualitas default ke medium di $0,071728, dan pindah ke high membawa satu gambar 1024×1024 ke $0,229768.
Tingkatan resolusi adalah variabel terakhir. Nano Banana 2 Edit mengenakan biaya $0,08, $0,12, dan $0,16 untuk 1k, 2k, dan 4k, sementara varian Lite menawarkan 1k saja. Untuk foto profil yang akhirnya ditampilkan pada beberapa ratus piksel, membayar untuk 4k berarti menghabiskan uang untuk piksel yang tidak akan dilihat siapa pun.
Titik Akhir Pengembang yang Didiskon dalam Jajaran AI Headshot API
Dua varian membawa diskon aktif pada hari penulisan:
| Titik akhir | Harga daftar | Harga saat ini | Diskon |
|---|---|---|---|
| google/nano-banana-2-lite/edit-developer | $0.04 | $0.028 | 30% off |
| google/nano-banana-2/edit-developer | $0.08 | $0.04 | 50% off |
Tidak ada halaman model yang menjelaskan bagaimana titik akhir pengembang berbeda dari yang standar selain harga, jadi perlakukan angka yang tidak didiskon sebagai angka yang tahan lama ketika Anda membangun model biaya. Flag ini telah berpindah sebelumnya, dan cara jujur untuk memeriksa adalah dengan menetapkan harga permintaan tepat Anda terhadap platform daripada mempercayai angka dari artikel, termasuk yang ini.
Apa yang Diubah AI Headshot API pada Wajah
Titik akhir tetap bersifat opini. Readme-nya menggambarkan pekerjaan itu sebagai mengubah potret kasual menjadi headshot bisnis berkualitas studio, yang dalam praktiknya berarti latar belakang dan pakaian diganti sementara wajah dimaksudkan untuk tetap dikenali sebagai milik Anda.
Saya menjalankan satu potret melalui kedua rute untuk melihat di mana mereka berpisah.
Dijalankan pada 19 Agustus 2026. Input adalah orang fiksi buatan AI, bukan foto orang sungguhan.
Kedua keluaran adalah wajah yang sama yang dapat dikenali, dan keduanya melakukan pekerjaan menempatkan seseorang ke dalam pakaian bisnis dengan latar belakang polos. Perbedaannya ada pada apa yang tidak diminta siapa pun. Titik akhir tetap memilih blazer abu-abu muda tanpa apa pun di bawahnya, memutuskan potongan, dan membiarkan rambut panjang bergelombang itu sendiri. Titik akhir edit memberikan setiap item yang disebutkan dalam prompt, blazer arang, kemeja putih, latar belakang abu-abu muda, pembingkaian kepala dan bahu, lalu melangkah lebih jauh dan memperpendek rambut menjadi bentuk yang lebih rapi dan simetris. Prompt telah meminta agar wajah tetap tidak berubah dan tidak mengatakan apa pun tentang rambut.
Memilih rute edit umum mengembalikan keputusan kepada Anda, dengan biaya harus menyatakannya. Bandingkan apa yang diterima masing-masing:
| Bidang | atlascloud/tool/headshot | google/nano-banana-2-lite/edit |
|---|---|---|
| prompt | tidak ada | wajib |
| image / images | satu gambar, wajib | 1 hingga 14 gambar, wajib |
| aspect_ratio | tidak ada | 15 nilai termasuk auto |
| resolution | tidak ada | 1k saja |
| thinking_level | tidak ada | default, high, minimal |
| enable_base64_output | tidak ada | API saja, mengembalikan BASE64, bukan URL |
Dua hal untuk direncanakan. Readme platform untuk tingkatan Lite mengatakan model mungkin kesulitan dengan wajah kecil, ejaan yang akurat, dan detail yang sangat halus. Input dalam tes itu dimulai sebagai bidikan panjang penuh di mana wajah menempati sebagian kecil bingkai dan berhasil melewatinya dengan baik, sehingga peringatan itu bukan batas keras, tetapi potongan foto grup adalah kasus yang lebih sulit dan layak untuk disaring. Readme yang sama menyatakan bahwa gambar yang diedit menyertakan kredensial konten C2PA dan watermark SynthID yang tidak terlihat secara default. Tanda tangan itu berjalan dengan file. LinkedIn menampilkan kredensial konten pada gambar apa pun yang datang dengan informasi C2PA terlampir, sehingga headshot yang dihasilkan dengan cara ini dapat mendarat di profil dengan asal-usulnya ditampilkan.
Yang mana tidak masalah, selama wajahnya adalah yang benar. Pedoman foto profil LinkedIn mengizinkan ilustrasi atau rendering artistik dari diri Anda sendiri, dengan syarat bahwa foto tersebut harus mencerminkan kemiripan Anda. AI headshot lulus tes itu. Wajah yang dihasilkan yang bukan milik pengguna tidak.
Menjalankan AI Headshot API dalam Produksi
Beberapa hal yang perlu diputuskan sebelum dikirim daripada setelahnya.
| Kekhawatiran | Apa yang diberikan platform kepada Anda | Default yang masuk akal |
|---|---|---|
| Penyelesaian pekerjaan | Status empat negara bagian pada setiap prediksi | Polling dengan backoff, perlakukan gagal sebagai dapat dicoba ulang sekali |
| Latensi | Tidak ada angka waktu penyelesaian dalam skema | Antrekan pekerjaan, jangan pernah memblokir render halaman padanya |
| Melewati polling | enable_sync_mode pada model edit umum, tidak ada pada alat tetap | Gunakan mode sinkron hanya untuk permintaan tunggal interaktif |
| Penanganan keluaran | Array outputs dari URL yang dihosting | Salin ke penyimpanan Anda sendiri setelah selesai |
| Kualitas input | Skema meminta potret menghadap depan yang jelas, tidak lebih spesifik | Saring potongan grup dan wajah kecil sebelum menghabiskan panggilan |
| Persetujuan | Catatan penggunaan yang bertanggung jawab memerlukan otorisasi untuk media yang Anda unggah | Tangkap persetujuan pada saat unggah, simpan catatan |
Baris terakhir itu adalah yang dilewatkan tim. Dokumentasi titik akhir sendiri meminta Anda untuk mendapatkan persetujuan sebelum mengedit atau menghasilkan kemiripan orang sungguhan, dan untuk menghindari penggunaan hasil untuk menipu, melecehkan, atau meniru. Jika fitur Anda mengubah foto karyawan menjadi headshot secara otomatis, langkah persetujuan termasuk dalam alur unggah daripada dalam dokumen kebijakan yang tidak dibaca siapa pun.
Pertanyaan yang Sering Diajukan
Apakah ada API AI headshot untuk pengembang dengan tingkat gratis?
API itu sendiri diukur dari panggilan pertama. Proses gratis ada di halaman alat, di mana setiap akun yang memenuhi syarat mendapatkan satu generasi resolusi penuh. Gunakan untuk mengonfirmasi gaya keluaran, lalu anggarkan untuk harga per gambar setelah Anda mengintegrasikan.
String model mana yang harus saya gunakan untuk panggilan API professional headshot?
atlascloud/tool/headshot jika Anda menginginkan perlakuan bisnis tetap tanpa prompt untuk dipelihara. google/nano-banana-2-lite/edit jika Anda memerlukan kontrol atas pakaian, latar belakang, atau rasio aspek dan bersedia menulis instruksi sendiri. Keduanya memposting ke /api/v1/model/generateImage.
Berapa biaya API AI headshot per gambar?
$0,045 melalui titik akhir khusus per 18 Agustus 2026, tanpa diskon aktif. Di dua belas titik akhir yang saya beri harga di platform yang sama, satu gambar yang diedit berkisar dari $0,028 hingga $0,229768 tergantung pada model, tingkatan resolusi, dan pengaturan kualitas.
Apakah API AI headshot generator mempertahankan wajah asli orang tersebut?
Itu adalah perilaku yang dinyatakan: alat mengganti latar belakang dan pakaian daripada menghasilkan orang baru. Kesesuaian sangat bergantung pada input, dan wajah kecil atau miring dalam foto sumber memberi model lebih sedikit untuk dipertahankan.
Apakah keluaran API AI headshot diberi watermark atau ditandatangani?
Suntingan Nano Banana 2 Lite menyertakan kredensial konten C2PA dan watermark SynthID secara default, sesuai dengan dokumentasi model di platform. Perilaku penandatanganan spesifik untuk model, jadi periksa readme untuk titik akhir mana pun yang Anda pilih.
Bisakah headshot yang dihasilkan melalui API digunakan di LinkedIn?
Ya, asalkan gambar tersebut mencerminkan orang yang sebenarnya. Pedoman foto LinkedIn mengizinkan rendering artistik dari diri Anda sendiri dan melarang foto yang hanya terdiri dari kemiripan orang lain, citra stok, atau karakter fiksi.
Kesimpulan
Jika yang Anda butuhkan adalah headshot bisnis standar dan Anda lebih suka tidak memiliki prompt, titik akhir tetap adalah jalur yang lebih pendek. Dua bidang, satu keluaran, harga yang dapat Anda baca sebelum memanggilnya.
Saat produk Anda membutuhkan sesuatu yang spesifik, jaket tertentu, latar belakang merek, potongan potret yang cocok dengan komponen kartu Anda, titik akhir itu tidak menawarkan apa pun dan Anda menulis prompt apakah Anda berencana atau tidak. Dua pertanyaan yang memutuskannya, dan tidak ada satupun yang merupakan harga satuan. Apakah masih ada yang akan memelihara prompt itu dalam dua tahun? Dan akankah kesenjangan antara keluaran 1k dan 4k pernah mencapai layar pengguna?
