Tích hợp thực sự rất nhỏ. Đăng một tham chiếu ảnh lên một URL, hỏi một URL thứ hai cho đến khi trạng thái thay đổi, đọc đường dẫn ảnh từ tải trọng. Một giờ làm việc nếu bạn đã từng gửi bất kỳ thứ gì không đồng bộ trước đây.
Sau đó, ai đó hỏi chi phí để chạy việc này cho mỗi nhân viên mới là bao nhiêu, và cả buổi chiều biến mất. Một tá endpoint ảnh trên cùng một nền tảng sẽ biến mỗi bức chân dung thành một bức ảnh chân dung chuyên nghiệp. Rẻ nhất là $0,028, và đó là giá đã chiết khấu. Đắt nhất là $0,229768 cho một bức ảnh. Phần lớn sự chênh lệch này bắt nguồn từ các mức độ phân giải, cờ chất lượng, và bất kỳ chương trình khuyến mãi nào đang diễn ra, chứ không phải là sự khác biệt về chất lượng khuôn mặt đầu ra.
Đây là một bản đồ làm việc cho quyết định đó dành cho bất kỳ ai đang xây dựng API AI headshot vào một sản phẩm. Mọi giá, tên trường và enum bên dưới đều được lấy từ lược đồ riêng của Atlas Cloud và endpoint giá của nó vào ngày 18 tháng 8 năm 2026.
Kết luận chính
- Một bức ảnh chân dung không phải là một loại mô hình riêng ở lớp API. Nó là một lệnh gọi chỉnh sửa ảnh với một mục đích cố định, vì vậy endpoint bạn chọn quyết định chi phí cho mỗi người dùng hơn nhiều so với prompt.
- Endpoint chuyên dụng cho headshot chấp nhận chính xác hai trường và trả về một ảnh. Các endpoint chỉnh sửa chung chấp nhận một tá trường và mong bạn tự mô tả kết quả.
- Bỏ qua tham số kích thước trong một lệnh gọi chỉnh sửa Seedream sẽ âm thầm đưa bạn vào mức giá cao hơn, tăng gấp đôi hóa đơn mà không có bất kỳ lỗi nào để bắt.
- Mọi mô hình trên nền tảng đều dùng chung một vòng lặp gửi và hỏi, vì vậy việc đổi endpoint sau này chỉ là thay đổi một chuỗi mô hình chứ không phải viết lại.
- Bạn có thể xác nhận phong cách đầu ra trước khi viết bất kỳ mã nào: công cụ tạo headshot AI miễn phí cung cấp cho mỗi tài khoản đủ điều kiện một lần chạy độ phân giải đầy đủ.
Tại sao các nhà phát triển chọn API AI Headshot thay vì một trang web headshot
Các trang web headshot dành cho người dùng cuối được xây dựng xung quanh một phiên. Bạn tải lên, bạn chờ, bạn tải xuống, và hạn mức được đặt lại vào ngày hôm sau. Không có gì trong vòng lặp đó tồn tại khi tiếp xúc với một sản phẩm phải tiếp nhận bốn trăm nhân viên trong quý này và đối chiếu chi tiêu với một trung tâm chi phí.
Điều mà một API thêm vào không thực sự là việc tạo ra. Đó là việc ghi sổ kế toán xung quanh nó. Mỗi lần gửi đều trả về một id và một trạng thái mà bạn có thể hỏi, đó là sự khác biệt giữa một hóa đơn bạn có thể giải thích và một hóa đơn bạn không thể.
Có một lợi thế nhỏ hơn, yên tĩnh hơn. Các endpoint công cụ công bố lược đồ của chúng, vì vậy bạn có thể đọc toàn bộ bề mặt đầu vào trước khi cam kết với một cái. Atlas Cloud công bố một loạt các công cụ ảnh đơn mục đích này, và hình dạng yêu cầu của chúng gần như giống hệt nhau:
| Endpoint công cụ | Trường bắt buộc | Trường tùy chọn | Giá mỗi ảnh |
|---|---|---|---|
| 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 |
Entry headshot là nghiêm ngặt nhất trong ba: một ảnh đầu vào, một ảnh đầu ra.
Nơi Atlas Cloud phù hợp cho các nhà phát triển xây dựng tính năng headshot
Đáng để xem mô hình thực sự trả về kết quả gì trước khi bạn viết bất kỳ mã tích hợp nào, bởi vì phong cách đầu ra là cố định và bạn hoặc muốn nó hoặc không. Atlas Cloud giữ các công cụ đơn mục đích của mình trên một trang, và danh sách các công cụ AI là nơi trình tạo headshot nằm cùng với tính năng nâng cấp và làm sạch. Trang công cụ nói rằng mỗi người dùng đủ điều kiện được dùng thử miễn phí một lần, và FAQ của nó bổ sung rằng bản tạo miễn phí bao gồm tải xuống độ phân giải cao đầy đủ.
Sau lần chạy đầu tiên, cùng một mô hình trở thành một sân chơi có tính phí. Sân chơi AI Headshot hiển thị giá của nó trên nút Run trước khi bạn gửi, và một thông báo phía trên bộ tải lên giải thích rằng tài sản sẽ được chuyển đến bộ nhớ của Atlas Cloud thay vì được kéo từ một liên kết bạn dán. Nếu bạn muốn tự viết prompt và kiểm soát trang phục, nền và khung hình, dòng Nano Banana 2 bao gồm con đường chỉnh sửa chung, và biến thể Lite của nó tình cờ chạy rẻ hơn mỗi ảnh so với công cụ cố định. Phần giá sẽ giải thích chi phí của sự đánh đổi đó.
Hai cách gọi API AI Headshot Generator
Cả hai đường dẫn đều chạy cùng một chuỗi mô hình. Sự khác biệt là liệu có người đang theo dõi kết quả trở về hay không.
Phương pháp 1: Kiểm tra API Professional Headshot trong Sân chơi
Đăng nhập, mở sân chơi được liên kết ở trên, và tải lên một bức chân dung chính diện rõ ràng. Mô tả của lược đồ cho trường đầu vào chính xác là cụm từ đó, vì vậy mô hình được tinh chỉnh cho một bức ảnh chụp thẳng mặt hơn là một cấu hình ba phần tư hoặc một crop nhóm.
Nút Run mang chi phí cho lần chạy bạn sắp thực hiện, và đó là con số cần dự trù. Trang tiếp thị không trích dẫn giá nào cả, vì vậy sân chơi là nơi con số tồn tại. Một sự không khớp hữu ích cần biết trong khi bạn ở đó: văn bản trang của công cụ đề cập đến việc chọn giữa business formal, smart casual và một phong cách studio đơn giản, nhưng lược đồ được công bố không có trường style. Bất kể văn bản gợi ý gì, endpoint trả về cách xử lý doanh nghiệp mặc định của mô hình.
Phương pháp 2: Gọi API AI Headshot từ mã của riêng bạn
Luồng chạy là hai yêu cầu HTTP. Để đến được đó cần ba bước.
Bước 1: Tạo khóa API. Tạo một khóa trong bảng điều khiển Atlas Cloud, sao chép nó và giữ nó ở phía máy chủ. Các endpoint công cụ nhận cùng một khóa như mọi mô hình trên nền tảng.
Bước 2: Kiểm tra tài liệu API. Xác thực, endpoint ảnh dùng chung và hợp đồng hỏi nằm trong tài liệu API. Mỗi mô hình cũng công bố lược đồ OpenAPI riêng của nó, và cái này là atlascloud-tool-headshot.json, đáng đọc trước khi bạn đoán tên trường. Trang mô hình cũng có một tab API bên cạnh sân chơi, vì vậy hình dạng yêu cầu chỉ cách một cú nhấp từ nơi bạn đã kiểm tra. Một điều đã làm tôi mất thời gian ở đây: danh sách mô hình công khai của nền tảng trả về 466 mục khi tôi kiểm tra và công cụ headshot không nằm trong số đó, mặc dù các công cụ anh em của nó để nâng cấp và làm sạch ảnh thì có. Lược đồ, readme và giá cả đều phân giải bình thường, vậy endpoint đang hoạt động. Chỉ tìm kiếm trong danh mục sẽ không làm nó xuất hiện.
Bước 3: Gửi yêu cầu đầu tiên. Việc gửi là không đồng bộ và trả về một id dự đoán.
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 }'
Hỏi cho đến khi trạng thái ổn định:
Bash1curl -s https://api.atlascloud.ai/api/v1/model/prediction/<PREDICTION_ID> \ 2 -H "Authorization: Bearer $ATLASCLOUD_API_KEY"
Tải trọng hoàn thành mang theo outputs, một mảng vẫn trống cho đến khi công việc kết thúc và sau đó chứa URL ảnh được lưu trữ. status là điều kiện vòng lặp của bạn và đọc là created, processing, completed hoặc failed.
Kiểm tra một điều trong lần gọi đầu tiên đó thay vì giả định. Lược đồ mô tả image là một tham chiếu ảnh mà không nói tệp có thể nằm ở đâu, và sân chơi thẳng thắn về phía riêng của nó đối với câu hỏi đó. Thông báo xanh phía trên bộ tải lên của nó ghi "URLs not accepted: images and videos must be submitted via dedicated upload fields." Các mô hình chỉnh sửa anh em ghi tài liệu đầu vào của chúng là URL. Xác nhận hình thức mà khóa của bạn sử dụng trước khi bạn nối dây một công việc hàng loạt xung quanh nó.
Hình dạng yêu cầu đó là phần đáng để ghi nhớ. Cùng một khóa, cùng một POST, và cùng một cuộc gọi hỏi đến mọi mô hình ảnh trên nền tảng, vì vậy việc chuyển từ công cụ headshot cố định sang một trình chỉnh sửa có thể prompt đầy đủ sau này có nghĩa là chỉnh sửa chuỗi mô hình và thêm các trường mà mô hình đó chấp nhận. Không có gì khác trong worker của bạn thay đổi.
Giá API AI Headshot cho mỗi ảnh được tạo
Mọi con số bên dưới đều được lấy từ endpoint tính toán giá của nền tảng vào ngày 18 tháng 8 năm 2026, được định giá dựa trên yêu cầu chính xác mà tôi sẽ gửi. Tất cả đều trả về cờ discount là 100, nghĩa là không có chương trình khuyến mãi nào đang chạy, ngoại trừ hai biến thể trong phần nhỏ tiếp theo.
Endpoint headshot chuyên dụng nằm ở $0,045, nghĩa là một nghìn bức headshot được tạo sẽ có giá $45. Nano Banana 2 Lite Edit rẻ hơn ở $0,04, vì vậy cùng một khối lượng chạy $40, và readme của nó nói rõ rằng số lượng ảnh tham chiếu đầu vào không ảnh hưởng đến giá. Tiết kiệm $5 mỗi nghìn đó có nghĩa là viết và duy trì prompt headshot của riêng bạn, đó là một quyết định thực sự chứ không phải là một quyết định hiển nhiên.
Các giá trị mặc định là nơi tiền bị rò rỉ. Seedream v5.0 Pro Edit tính $0,045 ở 1024×1024 hoặc 2048×1152, nhưng tham số size của nó mặc định là 2048×2048, dẫn đến mức cao hơn ở $0,09. Bỏ qua trường và bạn phải trả gấp đôi mà không có lỗi nào để bắt. Cùng một mô hình thêm $0,003 cho mỗi ảnh đầu vào sau ảnh đầu tiên, điều mà một yêu cầu hai ảnh xác nhận bằng cách định giá ở $0,048. GPT Image 2 Edit lặp lại mô hình từ một góc độ khác: quality mặc định là medium ở $0,071728, và chuyển sang high đưa một ảnh 1024×1024 duy nhất lên $0,229768.
Các mức độ phân giải là biến cuối cùng. Nano Banana 2 Edit tính $0,08, $0,12 và $0,16 cho 1k, 2k và 4k, trong khi biến thể Lite chỉ cung cấp 1k. Đối với một ảnh hồ sơ cuối cùng được hiển thị ở vài trăm pixel, trả tiền cho 4k là chi tiêu cho những pixel không ai nhìn thấy.
Các endpoint dành cho nhà phát triển được giảm giá trong dòng API AI Headshot
Hai biến thể có một chương trình giảm giá đang hoạt động vào ngày viết:
| Endpoint | Giá niêm yết | Giá hiện tại | Giảm giá |
|---|---|---|---|
| google/nano-banana-2-lite/edit-developer | $0,04 | $0,028 | Giảm 30% |
| google/nano-banana-2/edit-developer | $0,08 | $0,04 | Giảm 50% |
Không có trang mô hình nào giải thích endpoint dành cho nhà phát triển khác với tiêu chuẩn như thế nào ngoài giá, vì vậy hãy coi con số chưa giảm giá là con số bền vững khi bạn xây dựng một mô hình chi phí. Các cờ này đã từng thay đổi trước đây, và cách trung thực để kiểm tra là định giá yêu cầu chính xác của bạn dựa trên nền tảng thay vì tin tưởng một con số từ một bài báo, bao gồm cả bài này.
API AI Headshot thay đổi điều gì về khuôn mặt
Endpoint cố định có quan điểm riêng. Readme của nó mô tả công việc là biến một bức chân dung thường ngày thành một bức headshot doanh nghiệp chất lượng studio, điều này trong thực tế có nghĩa là nền và quần áo được thay thế trong khi khuôn mặt được giữ nguyên để có thể nhận ra bạn.
Tôi đã chạy một bức chân dung qua cả hai tuyến đường để xem chúng khác nhau ở đâu.
Chạy vào ngày 19 tháng 8 năm 2026. Đầu vào là một người hư cấu do AI tạo, không phải ảnh của người thật.
Cả hai đầu ra đều có thể nhận ra là cùng một khuôn mặt, và cả hai đều làm tốt công việc đặt một người vào trang phục kinh doanh trên nền đơn giản. Sự khác biệt nằm ở những thứ không ai yêu cầu. Endpoint cố định chọn một chiếc blazer xám nhạt không có gì bên trong, quyết định crop, và để mái tóc dài gợn sóng yên. Endpoint chỉnh sửa cung cấp mọi món đồ mà prompt đã nêu, blazer than, áo sơ mi trắng, nền xám nhạt, khung hình đầu và vai, sau đó còn đi xa hơn và cắt ngắn mái tóc thành một hình dạng gọn gàng, đối xứng hơn. Prompt đã yêu cầu khuôn mặt không thay đổi và không nói gì về tóc.
Đi theo con đường chỉnh sửa chung sẽ trao lại quyền quyết định cho bạn, với cái giá phải nêu rõ chúng. So sánh những gì mỗi endpoint chấp nhận:
| Trường | atlascloud/tool/headshot | google/nano-banana-2-lite/edit |
|---|---|---|
| prompt | không có | bắt buộc |
| image / images | một ảnh, bắt buộc | 1 đến 14 ảnh, bắt buộc |
| aspect_ratio | không có | 15 giá trị bao gồm auto |
| resolution | không có | chỉ 1k |
| thinking_level | không có | default, high, minimal |
| enable_base64_output | không có | Chỉ API, trả về BASE64 thay vì URL |
Hai điều cần lên kế hoạch. Readme của nền tảng cho tầng Lite nói rằng mô hình có thể gặp khó khăn với khuôn mặt nhỏ, chính tả chính xác và các chi tiết rất nhỏ. Đầu vào trong bài kiểm tra đó bắt đầu như một bức ảnh toàn thân, nơi khuôn mặt chiếm một phần nhỏ của khung hình và vẫn cho kết quả tốt, vì vậy cảnh báo không phải là một giới hạn cứng, nhưng một crop ảnh nhóm là trường hợp khó hơn và đáng để sàng lọc. Cùng một readme nói rằng các ảnh đã chỉnh sửa bao gồm thông tin xác thực nội dung C2PA và một hình mờ SynthID không thể nhận thấy theo mặc định. Chữ ký đó đi cùng với tệp. LinkedIn hiển thị thông tin xác thực nội dung trên bất kỳ ảnh nào đến với thông tin C2PA đính kèm, vì vậy một headshot được tạo theo cách này có thể xuất hiện trên một hồ sơ với nguồn gốc của nó được hiển thị.
Điều đó ổn, miễn là khuôn mặt là đúng. Hướng dẫn ảnh hồ sơ của LinkedIn cho phép một hình minh họa hoặc mô tả nghệ thuật về chính bạn, với điều kiện ảnh phải phản ánh chân dung của bạn. Một headshot AI vượt qua bài kiểm tra đó. Một khuôn mặt được tạo ra không phải của người dùng thì không.
Chạy API AI Headshot trong sản xuất
Một vài điều đáng quyết định trước khi phát hành hơn là sau đó.
| Mối quan tâm | Nền tảng cung cấp cho bạn những gì | Mặc định hợp lý |
|---|---|---|
| Hoàn thành công việc | Trạng thái bốn trạng thái trên mọi dự đoán | Hỏi với backoff, coi failed là có thể thử lại một lần |
| Độ trễ | Không có con số thời gian hoàn thành trong lược đồ | Xếp hàng công việc, không bao giờ chặn render trang trên nó |
| Bỏ qua việc hỏi | enable_sync_mode trên các mô hình chỉnh sửa chung, không có trên công cụ cố định | Chỉ sử dụng chế độ đồng bộ cho các yêu cầu đơn tương tác |
| Xử lý đầu ra | Mảng outputs của các URL được lưu trữ | Sao chép vào bộ nhớ của riêng bạn khi hoàn thành |
| Chất lượng đầu vào | Lược đồ yêu cầu một bức chân dung chính diện rõ ràng, không có gì cụ thể hơn | Sàng lọc crop nhóm và khuôn mặt nhỏ trước khi chi tiêu một cuộc gọi |
| Sự đồng ý | Ghi chú sử dụng có trách nhiệm yêu cầu ủy quyền cho phương tiện bạn tải lên | Thu thập sự đồng ý tại thời điểm tải lên, lưu trữ bản ghi |
Hàng cuối cùng đó là hàng mà các nhóm bỏ qua. Tài liệu của endpoint yêu cầu bạn có được sự đồng ý trước khi chỉnh sửa hoặc tạo ra chân dung của một người thật, và tránh sử dụng kết quả để lừa dối, quấy rối hoặc mạo danh. Nếu tính năng của bạn tự động biến ảnh nhân viên thành headshot, bước đồng ý thuộc về luồng tải lên chứ không phải trong một tài liệu chính sách không ai đọc.
Câu hỏi thường gặp
Có API AI headshot cho nhà phát triển với tầng miễn phí không?
Bản thân API được tính phí ngay từ lần gọi đầu tiên. Lần chạy miễn phí nằm trên trang công cụ, nơi mỗi tài khoản đủ điều kiện được tạo một lần với độ phân giải đầy đủ. Sử dụng nó để xác nhận phong cách đầu ra, sau đó dự trù cho việc định giá mỗi ảnh khi bạn tích hợp.
Tôi nên sử dụng chuỗi mô hình nào cho một cuộc gọi API headshot chuyên nghiệp?
atlascloud/tool/headshot nếu bạn muốn cách xử lý doanh nghiệp cố định mà không cần duy trì prompt. google/nano-banana-2-lite/edit nếu bạn cần kiểm soát trang phục, nền hoặc tỷ lệ khung hình và sẵn sàng tự viết hướng dẫn. Cả hai đều gửi đến /api/v1/model/generateImage.
API AI headshot có giá bao nhiêu mỗi ảnh?
$0,045 thông qua endpoint chuyên dụng tính đến ngày 18 tháng 8 năm 2026, không có chiết khấu nào đang hoạt động. Trong số mười hai endpoint tôi đã định giá trên cùng một nền tảng, một ảnh đã chỉnh sửa duy nhất có giá từ $0,028 đến $0,229768 tùy thuộc vào mô hình, mức độ phân giải và cài đặt chất lượng.
API AI headshot generator có giữ lại khuôn mặt thật của người dùng không?
Đó là hành vi được nêu: công cụ thay thế nền và trang phục thay vì tạo ra một người mới. Độ trung thực phụ thuộc rất nhiều vào đầu vào, và một khuôn mặt nhỏ hoặc nghiêng trong ảnh nguồn sẽ cho mô hình ít hơn để giữ lại.
Đầu ra API AI headshot có bị watermark hoặc ký không?
Các bản chỉnh sửa Nano Banana 2 Lite bao gồm thông tin xác thực nội dung C2PA và hình mờ SynthID theo mặc định, theo tài liệu của mô hình trên nền tảng. Hành vi ký là cụ thể cho từng mô hình, vì vậy hãy kiểm tra readme cho bất kỳ endpoint nào bạn chọn.
Headshot được tạo qua API có thể sử dụng trên LinkedIn không?
Có, miễn là ảnh phản ánh người thật. Hướng dẫn ảnh hồ sơ của LinkedIn cho phép mô tả nghệ thuật về chính bạn và cấm ảnh chỉ bao gồm chân dung của người khác, hình ảnh có sẵn hoặc nhân vật hư cấu.
Kết luận
Nếu những gì bạn cần là một bức headshot doanh nghiệp tiêu chuẩn và bạn không muốn sở hữu một prompt, endpoint cố định là con đường ngắn hơn. Hai trường, một đầu ra, một giá bạn có thể đọc trước khi gọi.
Khoảnh khắc sản phẩm của bạn cần một thứ gì đó cụ thể, một chiếc áo khoác cụ thể, một nền thương hiệu, một crop chân dung phù hợp với thành phần thẻ của bạn, endpoint đó không có gì để cung cấp và bạn sẽ phải viết một prompt cho dù bạn có kế hoạch hay không. Hai câu hỏi quyết định điều đó, và không câu nào là đơn giá. Liệu có ai đó vẫn duy trì prompt đó trong hai năm nữa không? Và liệu khoảng cách giữa đầu ra 1k và 4k có bao giờ đến được màn hình của người dùng không?
