Integracja jest naprawdę mała. Wrzuć referencję do zdjęcia pod jeden URL, odpytywaj drugi URL, aż status się zmieni, odczytaj link do obrazu z ładunku. Godzina roboty, jeśli kiedykolwiek wdrażałeś coś asynchronicznego.
Potem ktoś pyta, ile kosztuje uruchomienie tego dla każdego nowego pracownika, i popołudnie znika. Tuzin punktów końcowych obrazu na tej samej platformie zamieni każdy portret w zdjęcie portretowe. Najtańszy kosztuje 0,028 USD, i to jest cena po rabacie. Najdroższy bierze 0,229768 USD za jeden obraz. Większość tego rozrzutu wynika z poziomów rozdzielczości, flag jakości i aktualnie trwających promocji, co nie jest tym samym co rozrzut w jakości uzyskanej twarzy.
To jest działająca mapa tej decyzji dla każdego, kto wbudowuje API do generowania zdjęć portretowych AI w swój produkt. Każda cena, nazwa pola i wartość wyliczeniowa poniżej pochodzą ze schematów Atlas Cloud i jego punktu końcowego wyceny z 18 sierpnia 2026 roku.
Kluczowe wnioski
- Zdjęcie portretowe nie jest osobną kategorią modelu w warstwie API. Jest to wywołanie edycji obrazu z ustalonym przeznaczeniem, więc wybrany punkt końcowy decyduje o koszcie na użytkownika w znacznie większym stopniu niż prompt.
- Dedykowany punkt końcowy zdjęć portretowych akceptuje dokładnie dwa pola i zwraca jeden obraz. Ogólne punkty końcowe edycji akceptują kilkanaście pól i oczekują, że sam opiszesz wynik.
- Pominięcie parametru rozmiaru w wywołaniu edycji Seedream cicho umieszcza cię w wyższej warstwie cenowej, co podwaja rachunek bez żadnego błędu do wykrycia.
- Każdy model na platformie współdzieli tę samą pętlę submit-and-poll, więc późniejsza zmiana punktów końcowych to zmiana ciągu modelu, a nie przepisywanie kodu.
- Możesz potwierdzić styl wyjściowy przed napisaniem jakiegokolwiek kodu: darmowy generator zdjęć portretowych AI daje każdemu uprawnionemu kontu jedno pełnowymiarowe uruchomienie.
Dlaczego deweloperzy sięgają po API do zdjęć portretowych AI zamiast strony z headshotami
Konsumenckie strony z headshotami są zbudowane wokół sesji. Wgrywasz, czekasz, pobierasz, a limit odnawia się następnego dnia. Nic w tej pętli nie przetrwa kontaktu z produktem, który musi wdrożyć czterystu pracowników w tym kwartale i rozliczyć wydatki względem centrum kosztów.
To, co dodaje API, to tak naprawdę nie generowanie. To księgowość wokół niego. Każde zgłoszenie wraca z identyfikatorem i statusem, który możesz odpytywać, co stanowi różnicę między fakturą, którą możesz wyjaśnić, a taką, której nie możesz.
Jest druga, cichsza zaleta. Punkty końcowe narzędzi publikują swoje schematy, więc możesz przeczytać całą powierzchnię wejściową, zanim zobowiążesz się do jednego z nich. Atlas Cloud udostępnia rodzinę tych jednowymiarowych narzędzi obrazowych, a ich kształty żądań są prawie identyczne:
| Punkt końcowy narzędzia | Wymagane pola | Opcjonalne pola | Cena za obraz |
|---|---|---|---|
| atlascloud/tool/headshot | model, image | brak | 0,045 USD |
| atlascloud/photo-cleanup | model, image | output_format | 0,02 USD |
| atlascloud/image-upscaler | model, image | outscale, output_format | 0,01 USD |
Wpis dotyczący headshotów jest najściślejszy z trzech: jedno zdjęcie w środku, jedno zdjęcie na wyjściu.
Gdzie Atlas Cloud pasuje dla deweloperów budujących funkcje headshotów
Warto zobaczyć, co model faktycznie zwraca, zanim napiszesz jakikolwiek kod integracyjny, ponieważ styl wyjściowy jest stały i albo go chcesz, albo nie. Atlas Cloud trzyma swoje jednowymiarowe narzędzia na jednej stronie, a indeks AI tools jest miejscem, gdzie znajduje się generator headshotów obok upscalingu i czyszczenia. Strona narzędzia informuje, że każdy uprawniony użytkownik otrzymuje jedną bezpłatną próbę, a FAQ dodaje, że darmowe generowanie obejmuje pełne pobranie w wysokiej rozdzielczości.
Po tym pierwszym uruchomieniu ten sam model staje się płatnym placem zabaw. AI Headshot playground wyświetla swoją cenę na przycisku Run przed wysłaniem, a informacja nad przesyłarką wyjaśnia, że zasoby trafiają do magazynu Atlas Cloud, a nie są pobierane z linku, który wkleisz. Jeśli wolisz napisać prompt samodzielnie i kontrolować ubiór, tło oraz kadrowanie, rodzina Nano Banana 2 obejmuje ogólną ścieżkę edycji, a jej wariant Lite jest tańszy na obraz niż stałe narzędzie. Sekcja dotycząca cen omawia, jakim kosztem wiąże się ten wybór.
Dwa sposoby wywołania API generatora zdjęć portretowych AI
Obie ścieżki uruchamiają ten sam ciąg modelu. Różnica polega na tym, czy ktoś obserwuje wynik.
Metoda 1: Przetestuj API profesjonalnych headshotów w playgroundzie
Zaloguj się, otwórz playground podlinkowany powyżej i prześlij wyraźny portret z przodu. Opis schematu dla pola wejściowego to dokładnie to zdanie, więc model jest dostrojony do ujęcia frontalnego, a nie do profilu trzech czwartych czy kadru grupowego.
Przycisk Run pokazuje opłatę za bieżące uruchomienie i to jest liczba, którą należy uwzględnić w budżecie. Strona marketingowa nie podaje żadnej ceny, więc playground jest miejscem, gdzie ta kwota się znajduje. Jedna użyteczna niezgodność, o której warto wiedzieć: kopia strony narzędzia wspomina o wyborze między business formal, smart casual a zwykłym wyglądem studyjnym, ale opublikowany schemat nie ma pola stylu. Cokolwiek sugeruje kopia, punkt końcowy zwraca domyślne biznesowe traktowanie modelu.
Metoda 2: Wywołaj API headshotów AI z własnego kodu
Przepływ działania to dwa żądania HTTP. Dotarcie tam wymaga trzech kroków.
Krok 1: Utwórz klucz API. Wygeneruj go w konsoli Atlas Cloud, skopiuj i przechowuj po stronie serwera. Punkty końcowe narzędzi przyjmują ten sam klucz co każdy model na platformie.
Krok 2: Sprawdź dokumentację API. Uwierzytelnianie, wspólny punkt końcowy obrazu i kontrakt dotyczący odpytywania znajdują się w dokumentacji API. Każdy model publikuje również swój własny schemat OpenAPI, a ten jest dostępny pod adresem atlascloud-tool-headshot.json – warto go przeczytać, zanim zaczniesz zgadywać nazwy pól. Strona modelu ma również zakładkę API obok playgroundu, więc kształt żądania jest jedno kliknięcie od miejsca, w którym go testowałeś. Jedna rzecz, która zajęła mi tutaj czas: publiczna lista modeli platformy zwróciła 466 wpisów, gdy sprawdzałem, i narzędzie do headshotów nie było wśród nich, mimo że jego siostrzane narzędzia do upscalingu i czyszczenia zdjęć były. Schemat, readme i ceny działają normalnie, więc punkt końcowy jest aktywny. Jednak samo wyszukiwanie w katalogu go nie ujawni.
Krok 3: Wyślij pierwsze żądanie. Zgłoszenie jest asynchroniczne i zwraca identyfikator predykcji.
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 }'
Odpytywaj, aż status się ustabilizuje:
Bash1curl -s https://api.atlascloud.ai/api/v1/model/prediction/<PREDICTION_ID> \ 2 -H "Authorization: Bearer $ATLASCLOUD_API_KEY"
Ukończony ładunek zawiera outputs, tablicę, która pozostaje pusta, dopóki zadanie się nie zakończy, a następnie przechowuje adres URL hostowanego obrazu. status jest warunkiem pętli i przyjmuje wartości created, processing, completed lub failed.
Przetestuj jedną rzecz przy pierwszym wywołaniu, zamiast zakładać. Schemat typuje image jako referencję do obrazu, nie mówiąc, gdzie plik może się znajdować, a playground jest jednoznaczny co do swojej strony tego pytania. Zielona informacja nad jego przesyłarką brzmi: "URLs not accepted: images and videos must be submitted via dedicated upload fields." Siostrzane modele edycji dokumentują swoje wejścia jako adresy URL. Potwierdź, jaką formę przyjmuje twój klucz, zanim zaprogramujesz wokół tego zadanie wsadowe.
Ten kształt żądania jest częścią wartą przyswojenia. Ten sam klucz, to samo POST i to samo wywołanie odpytywania docierają do każdego modelu obrazu na platformie, więc przejście ze stałego narzędzia do headshotów na w pełni promptowalny edytor później oznacza edycję ciągu modelu i dodanie pól, które ten model akceptuje. Nic innego w twoim workerze się nie zmienia.
Ceny API headshotów AI za wygenerowany obraz
Każda poniższa liczba pochodzi z punktu końcowego kalkulacji cen platformy z 18 sierpnia 2026 roku, wyceniona względem dokładnego żądania, które wysłałbym. Wszystkie zwróciły flagę rabatu 100, co oznacza brak aktywnej promocji, z wyjątkiem dwóch wariantów w następnym podrozdziale.
Dedykowany punkt końcowy headshotów kosztuje 0,045 USD, co daje tysiąc wygenerowanych headshotów za 45 USD. Nano Banana 2 Lite Edit jest tańszy, kosztując 0,04 USD, więc ta sama objętość kosztuje 40 USD, a jego readme wyraźnie stwierdza, że liczba referencyjnych obrazów wejściowych nie wpływa na cenę. Oszczędzenie tych 5 USD na tysiąc oznacza napisanie i utrzymanie własnego promptu do headshotów, co jest prawdziwą decyzją, a nie oczywistą.
Domyślne ustawienia to miejsce, gdzie wyciekają pieniądze. Seedream v5.0 Pro Edit kosztuje 0,045 USD przy 1024×1024 lub 2048×1152, ale jego parametr rozmiaru domyślnie ustawia 2048×2048, co trafia do wyższej warstwy za 0,09 USD. Pomiń pole i płacisz podwójnie, bez żadnego błędu do wykrycia. Ten sam model dodaje 0,003 USD za każdy dodatkowy obraz wejściowy poza pierwszym, co żądanie dwóch obrazów potwierdza, wyceniając na 0,048 USD. GPT Image 2 Edit powtarza wzór z innej perspektywy: jakość domyślnie ustawiona na medium przy 0,071728 USD, a przejście na high podnosi pojedynczy obraz 1024×1024 do 0,229768 USD.
Poziomy rozdzielczości to ostatnia zmienna. Nano Banana 2 Edit kosztuje odpowiednio 0,08 USD, 0,12 USD i 0,16 USD za 1k, 2k i 4k, podczas gdy wariant Lite oferuje tylko 1k. W przypadku zdjęcia profilowego, które ostatecznie jest wyświetlane w kilkuset pikselach, płacenie za 4k to wydawanie pieniędzy na piksele, których nikt nie zobaczy.
Zdyskontowane punkty końcowe dla deweloperów w ofercie API headshotów AI
Dwa warianty miały aktywny rabat w dniu pisania:
| Punkt końcowy | Cena katalogowa | Aktualna cena | Rabat |
|---|---|---|---|
| google/nano-banana-2-lite/edit-developer | 0,04 USD | 0,028 USD | 30% |
| google/nano-banana-2/edit-developer | 0,08 USD | 0,04 USD | 50% |
Żadna strona modelu nie wyjaśnia, czym deweloperski punkt końcowy różni się od standardowego poza ceną, więc traktuj kwotę bez rabatu jako trwałą liczbę przy budowaniu modelu kosztów. Te flagi zmieniały się już wcześniej, a uczciwym sposobem sprawdzenia jest wycena twojego dokładnego żądania względem platformy, zamiast ufać liczbie z artykułu, w tym tego.
Co API headshotów AI zmienia w twarzy
Stały punkt końcowy ma swoje zdanie. Jego readme opisuje zadanie jako przekształcenie swobodnego portretu w studyjny headshot biznesowy, co w praktyce oznacza, że tło i ubranie są zastępowane, podczas gdy twarz ma pozostać rozpoznawalnie twoja.
Przepuściłem jeden portret przez obie ścieżki, aby zobaczyć, gdzie się rozchodzą.
Uruchomiono 19 sierpnia 2026 roku. Obraz wejściowy to wygenerowana przez AI fikcyjna osoba, a nie zdjęcie kogokolwiek prawdziwego.
Oba wyniki są rozpoznawalnie tą samą twarzą i oba spełniły zadanie umieszczenia osoby w biznesowym stroju na gładkim tle. Różnice dotyczą rzeczy, o które nikt nie prosił. Stały punkt końcowy wybrał jasnoszarą marynarkę bez niczego pod spodem, zdecydował o kadrze i pozostawił długie falujące włosy w spokoju. Punkt końcowy edycji dostarczył każdy element wymieniony w prompcie, grafitową marynarkę, białą koszulę, jasnoszare tło, kadrowanie od ramion, a następnie poszedł dalej i skrócił włosy do schludniejszego, bardziej symetrycznego kształtu. Prompt prosił o pozostawienie twarzy bez zmian i nie wspominał o włosach.
Przejście na ogólną ścieżkę edycji oddaje decyzje z powrotem w twoje ręce, kosztem konieczności ich określenia. Porównaj, co akceptuje każdy z nich:
| Pole | atlascloud/tool/headshot | google/nano-banana-2-lite/edit |
|---|---|---|
| prompt | brak | wymagane |
| image / images | jeden obraz, wymagane | 1 do 14 obrazów, wymagane |
| aspect_ratio | brak | 15 wartości, w tym auto |
| resolution | brak | tylko 1k |
| thinking_level | brak | default, high, minimal |
| enable_base64_output | brak | tylko API, zwraca BASE64 zamiast URL |
Dwie rzeczy do zaplanowania. Readme platformy dla warstwy Lite mówi, że model może mieć trudności z małymi twarzami, dokładną pisownią i bardzo drobnymi szczegółami. Wejście w tym teście zaczynało się jako pełnopostaciowe ujęcie, w którym twarz zajmowała niewielką część kadru, i przeszło przez to bez problemu, więc ostrzeżenie nie jest twardym progiem, ale kadr ze zdjęcia grupowego jest trudniejszym przypadkiem i warto go sprawdzić. To samo readme stwierdza, że edytowane obrazy domyślnie zawierają poświadczenia treści C2PA i niewidoczny znak wodny SynthID. Ten podpis podróżuje z plikiem. LinkedIn wyświetla poświadczenia treści na każdym obrazie, który dociera z dołączonymi informacjami C2PA, więc headshot wygenerowany w ten sposób może trafić na profil z widocznym pochodzeniem.
Co jest w porządku, o ile twarz jest właściwa. Wytyczne dotyczące zdjęć profilowych LinkedIn zezwalają na ilustrację lub artystyczne przedstawienie siebie, pod warunkiem że zdjęcie odzwierciedla twój wizerunek. Headshot AI przechodzi ten test. Wygenerowana twarz, która nie jest twarzą użytkownika, nie przechodzi.
Uruchamianie API headshotów AI w produkcji
Kilka rzeczy, które warto zdecydować przed wdrożeniem, a nie po.
| Obszar | Co daje platforma | Rozsądna wartość domyślna |
|---|---|---|
| Zakończenie zadania | Status czterostanowy dla każdej predykcji | Odpytywanie z backoffem, niepowodzenie traktuj jako możliwe do ponowienia raz |
| Opóźnienie | Brak wartości czasu zakończenia w schemacie | Kolejkuj pracę, nigdy nie blokuj renderowania strony na niej |
| Pominięcie odpytywania | enable_sync_mode w modelach edycji ogólnej, brak w stałym narzędziu | Używaj trybu synchronicznego tylko dla interaktywnych pojedynczych żądań |
| Obsługa wyjścia | Tablica outputs z hostowanymi adresami URL | Kopiuj do własnego magazynu po zakończeniu |
| Jakość wejścia | Schemat prosi o wyraźny portret frontalny, nic więcej | Odrzuć kadry grupowe i małe twarze przed wydaniem na wywołanie |
| Zgoda | Nota o odpowiedzialnym użyciu wymaga autoryzacji do przesyłanych mediów | Zbierz zgodę podczas przesyłania, przechowuj rekord |
Ten ostatni wiersz to ten, który zespoły pomijają. Dokumentacja samego punktu końcowego prosi o uzyskanie zgody przed edycją lub generowaniem wizerunku prawdziwej osoby oraz o unikanie używania wyników do oszukiwania, nękania lub podszywania się. Jeśli twoja funkcja automatycznie przekształca zdjęcia pracowników w headshoty, krok zgody powinien znajdować się w przepływie przesyłania, a nie w dokumencie polityki, którego nikt nie czyta.
Często zadawane pytania
Czy istnieje API do headshotów AI dla deweloperów z darmowym poziomem?
Samo API jest płatne od pierwszego wywołania. Darmowe uruchomienie znajduje się na stronie narzędzia, gdzie każde uprawnione konto otrzymuje jedno generowanie w pełnej rozdzielczości. Użyj go, aby potwierdzić styl wyjściowy, a następnie budżetuj według ceny za obraz po integracji.
Którego ciągu modelu użyć do wywołania API profesjonalnych headshotów?
atlascloud/tool/headshot, jeśli chcesz stałego biznesowego traktowania bez konieczności utrzymywania promptu. google/nano-banana-2-lite/edit, jeśli potrzebujesz kontroli nad ubiorem, tłem lub proporcjami i jesteś gotów samodzielnie napisać instrukcję. Oba wysyłają zapytanie do /api/v1/model/generateImage.
Ile kosztuje API headshotów AI za obraz?
0,045 USD przez dedykowany punkt końcowy według stanu na 18 sierpnia 2026 roku, bez aktywnego rabatu. Wśród dwunastu punktów końcowych, które wyceniłem na tej samej platformie, jeden edytowany obraz kosztował od 0,028 USD do 0,229768 USD, w zależności od modelu, poziomu rozdzielczości i ustawienia jakości.
Czy API generatora headshotów AI zachowuje prawdziwą twarz osoby?
To jest deklarowane zachowanie: narzędzie zastępuje tło i strój, a nie generuje nową osobę. Wierność w dużym stopniu zależy od wejścia, a mała lub nachylona twarz w źródle daje modelowi mniej do zachowania.
Czy wyniki API headshotów AI są oznaczone znakiem wodnym lub podpisane?
Edycje Nano Banana 2 Lite domyślnie zawierają poświadczenia treści C2PA i znak wodny SynthID, zgodnie z dokumentacją modelu na platformie. Zachowanie podpisywania jest specyficzne dla modelu, więc sprawdź readme dla wybranego punktu końcowego.
Czy headshoty wygenerowane przez API mogą być używane na LinkedIn?
Tak, pod warunkiem że obraz odzwierciedla rzeczywistą osobę. Wytyczne LinkedIn dotyczące zdjęć zezwalają na artystyczne przedstawienia siebie i zabraniają zdjęć składających się wyłącznie z wizerunków innych osób, zdjęć stockowych lub fikcyjnych postaci.
Podsumowanie
Jeśli potrzebujesz standardowego biznesowego headshota i wolisz nie utrzymywać promptu, stały punkt końcowy jest krótszą ścieżką. Dwa pola, jeden wynik, cena, którą możesz odczytać przed wywołaniem.
W momencie, gdy twój produkt potrzebuje czegoś konkretnego, konkretnej marynarki, firmowego tła, kadru portretowego pasującego do twojego komponentu karty, ten punkt końcowy nie ma nic do zaoferowania i piszesz prompt, niezależnie od tego, czy planowałeś, czy nie. Dwa pytania decydują o tym i żadne z nich nie dotyczy ceny jednostkowej. Czy ktoś będzie nadal utrzymywał ten prompt za dwa lata? I czy różnica między wynikiem 1k a 4k kiedykolwiek trafi na ekran użytkownika?
