통합 자체는 정말 작습니다. 사진 참조를 하나의 URL에 게시하고, 상태가 바뀔 때까지 두 번째 URL을 폴링한 다음, 페이로드에서 이미지 링크를 읽어오면 됩니다. 비동기 작업을 몇 번 해봤다면 한 시간이면 충분합니다.
그런데 누군가 이걸 모든 신규 직원에 대해 실행하는 데 비용이 얼마나 드는지 묻고, 오후 내내 사라집니다. 같은 플랫폼에 있는 12개의 이미지 엔드포인트는 각각 초상화를 헤드샷으로 바꿔줍니다. 가장 저렴한 것은 $0.028이며, 이는 할인된 가격입니다. 가장 비싼 것은 한 장에 $0.229768입니다. 대부분의 가격 차이는 해상도 등급, 품질 플래그, 그리고 진행 중인 프로모션에 따라 달라지며, 얼굴이 얼마나 잘 나오는지와는 관계가 없습니다.
이 글은 AI 헤드샷 API를 제품에 통합하려는 모든 사람을 위한 그 결정에 대한 실제적인 지도입니다. 아래의 모든 가격, 필드 이름, 열거형은 2026년 8월 18일 기준 Atlas Cloud 자체 스키마와 가격 책정 엔드포인트에서 가져온 것입니다.
핵심 요점
- 헤드샷은 API 계층에서 별도의 모델 카테고리가 아닙니다. 고정된 의도를 가진 이미지 편집 호출이므로, 프롬프트보다는 선택한 엔드포인트가 사용자당 비용을 훨씬 더 많이 결정합니다.
- 전용 헤드샷 엔드포인트는 정확히 두 개의 필드를 받아들이고 하나의 이미지를 반환합니다. 일반 편집 엔드포인트는 12개의 필드를 받아들이고 결과를 직접 설명해야 합니다.
- Seedream 편집 호출에서 size 매개변수를 생략하면 조용히 더 높은 가격 등급으로 들어가며, 잡을 수 있는 오류 없이 요금이 두 배가 됩니다.
- 플랫폼의 모든 모델은 하나의 제출 및 폴링 루프를 공유하므로, 나중에 엔드포인트를 변경하는 것은 모델 문자열을 변경하는 것일 뿐 코드를 다시 작성할 필요가 없습니다.
- 코드를 작성하기 전에 출력 스타일을 확인할 수 있습니다: 무료 AI 헤드샷 생성기는 적격 계정마다 한 번의 전체 해상도 실행을 제공합니다.
개발자가 헤드샷 사이트 대신 AI 헤드샷 API를 사용하는 이유
소비자용 헤드샷 사이트는 세션을 기반으로 합니다. 업로드하고, 기다리고, 다운로드하고, 할당량은 다음 날 초기화됩니다. 이 루프에서 분기당 400명의 신규 직원을 온보딩하고 비용을 비용 센터에 맞춰 정산해야 하는 제품과 접촉할 수 있는 것은 아무것도 없습니다.
API가 추가하는 것은 실제로 생성 자체가 아닙니다. 그 주변의 회계 처리입니다. 각 제출은 폴링할 수 있는 ID와 상태를 반환하며, 이것이 설명할 수 있는 인보이스와 설명할 수 없는 인보이스의 차이입니다.
두 번째로 조용한 이점이 있습니다. 도구 엔드포인트는 스키마를 게시하므로, 하나를 확정하기 전에 전체 입력 표면을 읽을 수 있습니다. Atlas Cloud는 이러한 단일 목적 이미지 도구 제품군을 제공하며, 요청 형태는 거의 동일합니다:
| 도구 엔드포인트 | 필수 필드 | 선택 필드 | 이미지당 가격 |
|---|---|---|---|
| atlascloud/tool/headshot | model, image | 없음 | $0.045 |
| atlascloud/photo-cleanup | model, image | output_format | $0.02 |
| atlascloud/image-upscaler | model, image | outscale, output_format | $0.01 |
헤드샷 항목은 세 가지 중 가장 엄격합니다: 하나의 사진 입력, 하나의 사진 출력.
헤드샷 기능을 개발하는 개발자를 위한 Atlas Cloud의 위치
통합 코드를 작성하기 전에 모델이 실제로 무엇을 반환하는지 확인하는 것이 좋습니다. 출력 스타일이 고정되어 있고, 원하는지 여부를 결정해야 하기 때문입니다. Atlas Cloud는 단일 목적 도구를 한 페이지에 모아두고 있으며, AI 도구 인덱스에는 헤드샷 생성기가 업스케일링 및 정리 도구와 함께 있습니다. 도구 페이지에는 적격 사용자당 한 번의 무료 평가판이 제공된다고 명시되어 있으며, FAQ에는 무료 생성에 전체 고해상도 다운로드가 포함된다고 추가되어 있습니다.
첫 번째 실행 이후에는 동일한 모델이 측정된 플레이그라운드가 됩니다. AI 헤드샷 플레이그라운드는 제출하기 전에 실행 버튼에 가격을 표시하며, 업로더 위의 공지에는 자산이 붙여넣은 링크에서 가져오는 대신 Atlas Cloud 스토리지로 이동한다고 설명합니다. 직접 프롬프트를 작성하고 복장, 배경, 구도를 제어하려면 Nano Banana 2 제품군이 일반 편집 경로를 다루며, 그 Lite 변형은 고정 도구보다 이미지당 더 저렴하게 실행됩니다. 가격 책정 섹션에서는 이러한 거래의 비용을 설명합니다.
AI 헤드샷 생성기 API를 호출하는 두 가지 방법
두 경로 모두 동일한 모델 문자열을 실행합니다. 차이점은 사람이 결과가 돌아오는 것을 지켜보고 있는지 여부입니다.
방법 1: 플레이그라운드에서 전문 헤드샷 API 테스트
로그인하고 위에 링크된 플레이그라운드를 열고 명확한 정면 초상화를 업로드합니다. 스키마 자체의 입력 필드 설명이 정확히 그 문구이므로, 모델은 3/4 프로필이나 그룹 크롭보다는 정면 샷에 맞춰 조정되어 있습니다.
실행 버튼에는 곧 실행할 작업에 대한 요금이 표시되며, 이 숫자가 예산을 세울 기준입니다. 마케팅 페이지에는 가격이 전혀 나와 있지 않으므로, 플레이그라운드가 실제 가격을 확인할 수 있는 곳입니다. 알고 있으면 유용한 한 가지 불일치: 도구 페이지의 카피에는 비즈니스 포멀, 스마트 캐주얼, 평범한 스튜디오 룩 중에서 선택할 수 있다고 언급되어 있지만, 게시된 스키마에는 스타일 필드가 없습니다. 카피가 무엇을 제안하든, 엔드포인트는 모델의 기본 비즈니스 처리를 반환합니다.
방법 2: 자체 코드에서 AI 헤드샷 API 호출
실행 흐름은 두 개의 HTTP 요청입니다. 거기에 도달하는 데는 세 단계가 있습니다.
1단계: API 키 생성. Atlas Cloud 콘솔에서 키를 생성하고 복사한 후 서버 측에 안전하게 보관합니다. 도구 엔드포인트는 플랫폼의 모든 모델과 동일한 키를 사용합니다.
2단계: API 문서 확인. 인증, 공유 이미지 엔드포인트, 폴링 계약은 API 문서에 있습니다. 각 모델은 자체 OpenAPI 스키마도 게시하며, 이 모델의 스키마는 atlascloud-tool-headshot.json입니다. 필드 이름을 추측하기 전에 읽어보는 것이 좋습니다. 모델 페이지에는 플레이그라운드 옆에 API 탭도 있으므로, 요청 형태는 테스트한 곳에서 한 번의 클릭으로 확인할 수 있습니다. 여기서 시간이 걸렸던 한 가지: 확인했을 때 플랫폼의 공개 모델 목록에는 466개의 항목이 있었지만, 헤드샷 도구는 그 목록에 없었습니다. 업스케일링 및 사진 정리 도구는 있었지만요. 스키마, 리드미, 가격은 모두 정상적으로 확인되므로 엔드포인트는 작동 중입니다. 카탈로그 검색만으로는 찾을 수 없습니다.
3단계: 첫 번째 요청 보내기. 제출은 비동기식이며 예측 ID를 반환합니다.
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 }'
상태가 안정될 때까지 폴링합니다:
Bash1curl -s https://api.atlascloud.ai/api/v1/model/prediction/<PREDICTION_ID> \ 2 -H "Authorization: Bearer $ATLASCLOUD_API_KEY"
완료된 페이로드에는 outputs 배열이 있으며, 작업이 완료될 때까지 비어 있다가 호스팅된 이미지 URL을 보유합니다. status는 루프 조건이며 created, processing, completed, failed 값을 읽습니다.
첫 번째 호출에서 한 가지를 가정하지 말고 테스트하세요. 스키마는 image를 이미지 참조로 유형화하지만 파일이 어디에 있을 수 있는지는 말하지 않으며, 플레이그라운드는 그 질문에 대해 자신의 입장을 솔직하게 밝힙니다. 업로더 위의 녹색 공지에는 "URL은 허용되지 않습니다: 이미지와 비디오는 전용 업로드 필드를 통해 제출해야 합니다."라고 적혀 있습니다. 자매 편집 모델은 입력을 URL로 문서화합니다. 배치 작업을 구성하기 전에 키가 어떤 형식을 취하는지 확인하세요.
그 요청 형태는 내재화할 가치가 있는 부분입니다. 동일한 키, 동일한 POST, 동일한 폴링 호출이 플랫폼의 모든 이미지 모델에 도달하므로, 나중에 고정 헤드샷 도구에서 완전히 프롬프트 가능한 편집기로 이동하려면 모델 문자열을 편집하고 해당 모델이 허용하는 필드를 추가하면 됩니다. 작업자 코드의 다른 부분은 변경되지 않습니다.
생성된 이미지당 AI 헤드샷 API 가격 책정
아래의 모든 수치는 2026년 8월 18일 플랫폼의 가격 계산 엔드포인트에서 가져온 것이며, 제가 보낼 정확한 요청에 대해 가격이 책정되었습니다. 모두 할인 플래그가 100으로 반환되었으며, 이는 프로모션이 실행되지 않았음을 의미합니다(다음 하위 섹션의 두 변형 제외).
전용 헤드샷 엔드포인트는 $0.045로, 1,000개의 헤드샷을 생성하는 데 $45입니다. Nano Banana 2 Lite Edit는 $0.04로 더 저렴하므로 동일한 볼륨에 $40이며, 리드미에는 입력 참조 이미지 수가 가격에 영향을 미치지 않는다고 명시되어 있습니다. 천 개당 $5를 절약하려면 자체 헤드샷 프롬프트를 작성하고 유지 관리해야 하며, 이는 명백한 결정이라기보다는 실제 결정입니다.
기본값에서 돈이 새는 곳입니다. Seedream v5.0 Pro Edit는 1024×1024 또는 2048×1152에서 $0.045이지만, size 매개변수 기본값은 2048×2048로 더 높은 등급($0.09)에 해당합니다. 필드를 생략하면 잡을 수 있는 오류 없이 두 배를 지불하게 됩니다. 동일한 모델은 첫 번째 이후 입력 이미지마다 $0.003을 추가하므로, 두 이미지 요청은 $0.048로 확인됩니다. GPT Image 2 Edit는 다른 각도에서 패턴을 반복합니다: quality 기본값은 medium($0.071728)이며, high로 올리면 단일 1024×1024 이미지가 $0.229768이 됩니다.
해상도 등급은 마지막 변수입니다. Nano Banana 2 Edit는 1k, 2k, 4k에 대해 각각 $0.08, $0.12, $0.16을 청구하는 반면, Lite 변형은 1k만 제공합니다. 결국 몇 백 픽셀로 표시되는 프로필 사진의 경우 4k에 비용을 지불하는 것은 아무도 보지 못할 픽셀에 돈을 쓰는 것입니다.
AI 헤드샷 API 라인업의 할인된 개발자 엔드포인트
작성일 기준으로 두 가지 변형에 활성 할인이 적용되었습니다:
| 엔드포인트 | 정가 | 현재 가격 | 할인 |
|---|---|---|---|
| google/nano-banana-2-lite/edit-developer | $0.04 | $0.028 | 30% 할인 |
| google/nano-banana-2/edit-developer | $0.08 | $0.04 | 50% 할인 |
두 모델 페이지 모두 개발자 엔드포인트가 가격 외에 표준 엔드포인트와 어떻게 다른지 설명하지 않으므로, 비용 모델을 구축할 때는 할인되지 않은 수치를 내구성 있는 숫자로 취급하세요. 이러한 플래그는 이전에도 변경된 적이 있으며, 정직한 확인 방법은 이 기사(이 기사 포함)의 수치를 신뢰하기보다는 플랫폼에서 정확한 요청에 대한 가격을 확인하는 것입니다.
AI 헤드샷 API가 얼굴에 대해 변경하는 것
고정 엔드포인트는 고정된 의견을 가지고 있습니다. 리드미는 작업을 캐주얼 초상화를 스튜디오 품질의 비즈니스 헤드샷으로 바꾸는 것으로 설명하며, 실제로는 배경과 옷이 교체되는 반면 얼굴은 알아볼 수 있게 유지되어야 합니다.
한 초상화를 두 경로로 실행하여 차이점을 확인했습니다.
2026년 8월 19일 실행. 입력은 실제 사람의 사진이 아닌 AI 생성 가상 인물입니다.
두 출력 모두 같은 얼굴로 알아볼 수 있으며, 두 출력 모두 사람을 비즈니스 복장에 평범한 배경에 배치하는 작업을 수행했습니다. 차이점은 아무도 요청하지 않은 부분에 있습니다. 고정 엔드포인트는 밝은 회색 블레이저(안에 아무것도 없음)를 선택하고, 크롭을 결정했으며, 긴 웨이브 헤어를 그대로 두었습니다. 편집 엔드포인트는 프롬프트에 명명된 모든 항목(차콜 블레이저, 흰 셔츠, 밝은 회색 배경, 머리와 어깨 구도)을 전달한 후, 더 나아가 머리카락을 더 짧고 깔끔하며 대칭적인 모양으로 만들었습니다. 프롬프트는 얼굴이 변경되지 않도록 요청했으며 머리카락에 대해서는 아무 말도 하지 않았습니다.
일반 편집 경로로 가면 결정권이 사용자에게 돌아오지만, 그 결정을 명시해야 하는 비용이 따릅니다. 각각이 허용하는 것을 비교하세요:
| 필드 | atlascloud/tool/headshot | google/nano-banana-2-lite/edit |
|---|---|---|
| prompt | 없음 | 필수 |
| image / images | 이미지 1개, 필수 | 1~14개 이미지, 필수 |
| aspect_ratio | 없음 | auto 포함 15개 값 |
| resolution | 없음 | 1k만 |
| thinking_level | 없음 | default, high, minimal |
| enable_base64_output | 없음 | API 전용, URL 대신 BASE64 반환 |
계획해야 할 두 가지 사항. Lite 등급의 플랫폼 리드미에는 모델이 작은 얼굴, 정확한 철자, 매우 미세한 세부 사항에 어려움을 겪을 수 있다고 명시되어 있습니다. 해당 테스트의 입력은 얼굴이 프레임의 작은 부분을 차지하는 전신 샷으로 시작했지만 잘 처리되었으므로, 경고가 절대적인 하한선은 아니지만, 그룹 사진 자르기가 더 어려운 경우이며 검토할 가치가 있습니다. 동일한 리드미에는 편집된 이미지에 기본적으로 C2PA 콘텐츠 자격 증명과 눈에 띄지 않는 SynthID 워터마크가 포함된다고 명시되어 있습니다. 그 서명은 파일과 함께 전달됩니다. LinkedIn은 C2PA 정보가 첨부된 모든 이미지에 콘텐츠 자격 증명을 표시하므로, 이렇게 생성된 헤드샷은 출처가 표시된 상태로 프로필에 표시될 수 있습니다.
얼굴이 올바른 것이라면 괜찮습니다. LinkedIn의 프로필 사진 가이드라인은 자신의 일러스트레이션이나 예술적 표현을 허용하지만, 사진이 본인의 모습을 반영해야 한다는 조건이 있습니다. AI 헤드샷은 그 테스트를 통과합니다. 사용자의 얼굴이 아닌 생성된 얼굴은 통과하지 못합니다.
프로덕션에서 AI 헤드샷 API 실행
배송 후보다는 배송 전에 결정해야 할 몇 가지 사항이 있습니다.
| 우려 사항 | 플랫폼이 제공하는 것 | 합리적인 기본값 |
|---|---|---|
| 작업 완료 | 모든 예측에 대한 4가지 상태 | 백오프로 폴링, 실패 시 한 번 재시도 가능으로 처리 |
| 지연 시간 | 스키마에 완료 시간 수치 없음 | 작업을 대기열에 넣고, 페이지 렌더링을 차단하지 않음 |
| 폴링 건너뛰기 | 일반 편집 모델에는 enable_sync_mode, 고정 도구에는 없음 | 대화형 단일 요청에만 동기 모드 사용 |
| 출력 처리 | 호스팅된 URL의 outputs 배열 | 완료 시 자체 스토리지로 복사 |
| 입력 품질 | 스키마는 명확한 정면 초상화를 요구하며 더 구체적이지 않음 | 호출을 소비하기 전에 그룹 크롭과 작은 얼굴 걸러내기 |
| 동의 | 책임 사용 노트: 업로드하는 미디어에 대한 승인 필요 | 업로드 시 동의를 캡처하고 기록 저장 |
마지막 행은 팀이 건너뛰는 부분입니다. 엔드포인트의 문서는 실제 사람의 초상화를 편집하거나 생성하기 전에 동의를 얻고, 결과를 속이거나 괴롭히거나 사칭하는 데 사용하지 말 것을 요청합니다. 기능이 직원 사진을 자동으로 헤드샷으로 변환하는 경우, 동의 단계는 아무도 읽지 않는 정책 문서가 아닌 업로드 흐름에 속해야 합니다.
자주 묻는 질문
개발자를 위한 무료 등급의 AI 헤드샷 API가 있나요?
API 자체는 첫 번째 호출부터 측정됩니다. 무료 실행은 도구 페이지에 있으며, 적격 계정마다 한 번의 전체 해상도 생성이 제공됩니다. 출력 스타일을 확인한 후 통합 시 이미지당 가격에 대한 예산을 세우세요.
전문 헤드샷 API 호출에 어떤 모델 문자열을 사용해야 하나요?
유지 관리할 프롬프트 없이 고정된 비즈니스 처리를 원한다면 atlascloud/tool/headshot을 사용하세요. 복장, 배경, 종횡비를 제어해야 하고 직접 지침을 작성할 의향이 있다면 google/nano-banana-2-lite/edit을 사용하세요. 둘 다 /api/v1/model/generateImage로 POST합니다.
AI 헤드샷 API는 이미지당 얼마인가요?
2026년 8월 18일 기준으로 전용 엔드포인트를 통해 $0.045이며, 활성 할인은 없습니다. 같은 플랫폼에서 가격을 책정한 12개의 엔드포인트 중에서 단일 편집 이미지는 모델, 해상도 등급, 품질 설정에 따라 $0.028에서 $0.229768까지 다양했습니다.
AI 헤드샷 생성기 API는 실제 사람의 얼굴을 유지하나요?
이는 명시된 동작입니다: 도구는 새로운 사람을 생성하는 대신 배경과 복장을 교체합니다. 충실도는 입력에 크게 의존하며, 원본 사진에서 얼굴이 작거나 각도가 있으면 모델이 보존할 대상이 줄어듭니다.
AI 헤드샷 API 출력에 워터마크나 서명이 있나요?
Nano Banana 2 Lite 편집에는 플랫폼의 모델 문서에 따라 기본적으로 C2PA 콘텐츠 자격 증명과 SynthID 워터마크가 포함됩니다. 서명 동작은 모델별로 다르므로, 선택한 엔드포인트의 리드미를 확인하세요.
API를 통해 생성된 헤드샷을 LinkedIn에서 사용할 수 있나요?
예, 단 이미지가 실제 사람을 반영해야 합니다. LinkedIn의 사진 가이드라인은 자신의 예술적 표현을 허용하며, 다른 사람의 초상화, 스톡 이미지, 가상 인물로만 구성된 사진을 금지합니다.
결론
필요한 것이 표준 비즈니스 헤드샷이고 프롬프트를 소유하고 싶지 않다면, 고정 엔드포인트가 더 짧은 경로입니다. 두 개의 필드, 하나의 출력, 호출하기 전에 읽을 수 있는 가격.
제품에 특정한 것이 필요할 때, 즉 특정 재킷, 브랜드 배경, 카드 컴포넌트에 맞는 초상화 크롭 등이 필요할 때, 그 엔드포인트는 제공할 것이 없으며 계획했든 아니든 프롬프트를 작성해야 합니다. 두 가지 질문이 결정하며, 둘 다 단가가 아닙니다. 2년 후에도 누군가 그 프롬프트를 유지 관리하고 있을까요? 그리고 1k 출력과 4k 출력의 차이가 사용자의 화면에 도달할까요?
