ある午後、ヘッドショットエンドポイントをセットアップした。価格設定にはもっと時間がかかった。

統合は本当に小さい。1つのURLに写真の参照を投稿し、ステータスが変わるまで2番目のURLをポーリングし、ペイロードから画像リンクを読み取る。非同期のものを出荷したことがある人なら、1時間の作業だ。

それから、これを新入社員ごとに実行するコストはいくらかと聞かれると、午後は消えてしまう。同じプラットフォーム上の12の画像エンドポイントは、それぞれポートレートをヘッドショットに変換する。最も安いのは0.028ドルで、それも割引価格だ。最も高いのは1枚0.229768ドル。その差のほとんどは解像度の階層、品質フラグ、そしてたまたま実施中のプロモーションによるものであり、顔の仕上がりの良さの差によるものではない。

これは、AIヘッドショットAPIを製品に組み込もうとしている開発者向けの、その意思決定の実用的なマップである。以下のすべての価格、フィールド名、および列挙型は、2026年8月18日時点のAtlas Cloud自身のスキーマと価格設定エンドポイントからのものである。

主なポイント

• ヘッドショットはAPIレイヤーでは独自のモデルカテゴリではない。固定された意図を持つ画像編集呼び出しであるため、ユーザーあたりのコストはプロンプトよりも、選択するエンドポイントによってはるかに大きく決まる。
• 専用ヘッドショットエンドポイントは、正確に2つのフィールドを受け入れ、1つの画像を返す。汎用編集エンドポイントは、十数個のフィールドを受け入れ、結果を自分で説明することを期待する。
• Seedreamの編集呼び出しでサイズパラメータを省略すると、黙ってより高い価格帯に誘導され、キャッチするエラーもなく請求額が2倍になる。
• プラットフォーム上のすべてのモデルは、1つの送信＆ポーリングループを共有しているため、後でエンドポイントを交換するのは、リライトではなくモデル文字列の変更で済む。
• コードを書く前に出力スタイルを確認できる：無料AIヘッドショットジェネレーターは、対象となる各アカウントに1回のフル解像度実行を提供する。

なぜ開発者はヘッドショットサイトではなくAIヘッドショットAPIを選ぶのか

消費者向けヘッドショットサイトは、セッションを中心に構築されている。アップロードし、待ち、ダウンロードし、割り当ては翌日リセットされる。このループの中には、今四半期に400人の従業員をオンボーディングし、支出をコストセンターと照合しなければならない製品と接触しても生き残るものは何もない。

APIが追加するのは、実際には生成機能ではない。その周りの会計処理だ。各送信には、ポーリングできるIDとステータスが付随して返される。これは、説明できる請求書とできない請求書の違いである。

2つ目の、より静かな利点がある。ツールエンドポイントはスキーマを公開しているため、1つにコミットする前に入力面全体を読むことができる。Atlas Cloudは、これらの単一目的の画像ツールのファミリーを公開しており、そのリクエスト形状はほぼ同じである：

ヘッドショットエントリはこれら3つの中で最も厳格で、1枚の写真を入力し、1枚の写真を出力する。

ヘッドショット機能を構築する開発者にとってのAtlas Cloudの位置づけ

実際に統合コードを書く前に、モデルが何を返すかを確認する価値がある。出力スタイルは固定されており、それを望むか望まないかのどちらかだからだ。Atlas Cloudは、単一目的のツールを1ページにまとめており、AI toolsインデックスには、ヘッドショットジェネレーターがアップスケーリングやクリーンアップと並んで配置されている。ツールページには、対象となる各ユーザーが1回の無料トライアルを利用できると記載されており、FAQには無料生成にはフルハイレゾダウンロードが含まれると追加されている。

その最初の実行以降、同じモデルは従量制のプレイグラウンドになる。AI Headshot playgroundは、送信前にRunボタンに価格を表示し、アップローダーの上の注意書きは、アセットが貼り付けたリンクから取得されるのではなく、Atlas Cloudストレージに送られることを説明している。自分でプロンプトを作成し、ワードローブ、背景、フレーミングを制御したい場合は、Nano Banana 2 ファミリーが汎用編集ルートをカバーしており、そのLiteバリアントは固定ツールよりも画像あたりのコストが低い。価格設定セクションでは、そのトレードオフのコストについて説明する。

AIヘッドショットジェネレーターAPIを呼び出す2つの方法

どちらのパスも同じモデル文字列を実行する。違いは、結果が返ってくるのを誰かが見ているかどうかだ。

方法1：プレイグラウンドでプロフェッショナルヘッドショットAPIをテストする

サインインし、上記のプレイグラウンドを開き、クリアな正面ポートレートをアップロードする。スキーマ自身の入力フィールドの説明はまさにそのフレーズなので、モデルはスリークォータープロファイルやグループクロップではなく、真正面からのショットに調整されている。

Runボタンには、これから実行する実行の料金が表示されており、それが予算の基準となる数字だ。マーケティングページには価格がまったく記載されていないので、プレイグラウンドがその数字が存在する場所である。そこにいる間に知っておくべき便利な不一致が1つある。ツールのページコピーには、ビジネスフォーマル、スマートカジュアル、プレーンなスタジオルックから選択できると書かれているが、公開されているスキーマにはスタイルフィールドがない。コピーが何を示唆していようと、エンドポイントはモデルのデフォルトのビジネス処理を返す。

方法2：独自のコードからAIヘッドショットAPIを呼び出す

実行フローは2つのHTTPリクエストである。そこに到達するには3つのステップが必要だ。

ステップ1：APIキーを作成する。 Atlas Cloudコンソールでキーを生成し、コピーして、サーバーサイドで保管する。ツールエンドポイントは、プラットフォーム上のすべてのモデルと同じキーを受け取る。

ステップ2：APIドキュメントを確認する。 認証、共有画像エンドポイント、およびポーリング契約は、API documentationに記載されている。各モデルは独自のOpenAPIスキーマも公開しており、このモデルのものはatlascloud-tool-headshot.jsonである。フィールド名を推測する前に読む価値がある。モデルページにはプレイグラウンドの横にAPIタブもあるので、テストした場所からワンクリックでリクエスト形状を確認できる。ここで時間を費やしたことが1つある。確認した時点では、プラットフォームの公開モデルリストは466のエントリを返し、ヘッドショットツールはその中になかった。アップスケーリングや写真クリーンアップの兄弟ツールはリストにあったにもかかわらずだ。スキーマ、README、価格設定はすべて正常に解決されるため、エンドポイントは稼働している。カタログ検索だけではそれを見つけられない。

ステップ3：最初のリクエストを送信する。 送信は非同期で、予測IDを返す。

BashCopy
1curl -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  }'

ステータスが確定するまでポーリングする：

BashCopy
1curl -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を読み取る。

最初の呼び出しで、仮定せずに1つのことをテストする。スキーマは、ファイルがどこに存在してもよいかについては言及せずに、imageを画像参照として型指定している。プレイグラウンドは、その質問に関する自身の側面について率直だ。アップローダーの上の緑色の注意書きには、「URLは受け付けられません：画像と動画は専用のアップロードフィールドを介して送信する必要があります」とある。兄弟モデルは、入力をURLとして文書化している。バッチジョブを構築する前に、キーがどの形式を取るかを確認する。

そのリクエスト形状は、内面化する価値のある部分だ。同じキー、同じPOST、同じポーリング呼び出しが、プラットフォーム上のすべての画像モデルに到達する。したがって、固定ヘッドショットツールから完全にプロンプト可能なエディターに後で移行するには、モデル文字列を編集し、そのモデルが受け入れるフィールドを追加するだけでよい。ワーカーの他の部分は何も変わらない。

AIヘッドショットAPIの生成画像あたりの価格

以下のすべての数字は、2026年8月18日にプラットフォームの価格計算エンドポイントから、私が送信する正確なリクエストに対して価格設定されたものである。すべて、割引フラグが100であることを返した。これは、次のサブセクションの2つのバリアントを除いて、プロモーションが実行されていないことを意味する。

専用ヘッドショットエンドポイントは0.045ドルで、1000枚のヘッドショットを生成すると45ドルになる。Nano Banana 2 Lite Editは0.04ドルでそれより安いため、同じボリュームで40ドルになる。そのREADMEは、入力参照画像の数が価格に影響しないことを明示している。1000枚あたり5ドルの節約は、独自のヘッドショットプロンプトを作成して維持することを意味し、これは明白な決定ではなく、実際の判断である。

デフォルト設定は、費用が漏れる場所である。Seedream v5.0 Pro Editは、1024×1024または2048×1152で0.045ドルであるが、そのサイズパラメータのデフォルトは2048×2048であり、より高い階層の0.09ドルになる。フィールドを省略すると、キャッチするエラーもなく、2倍の料金を支払うことになる。同じモデルは、最初の画像以降、入力画像ごとに0.003ドル追加される。2枚の画像のリクエストは0.048ドルで価格設定されることで確認できる。GPT Image 2 Editは、別の角度から同じパターンを繰り返す。品質のデフォルトは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ラインナップの割引開発者向けエンドポイント

執筆時点で、2つのバリアントが有効な割引をフィールド名に持っていた：

どちらのモデルページも、開発者向けエンドポイントが価格以外の点で標準のものとどのように異なるかを説明していない。したがって、コストモデルを構築する際には、割引なしの数字を耐久性のある数字として扱うこと。これらのフラグは以前にも動いたことがあり、正直な確認方法は、この記事を含む記事の数字を信頼するのではなく、プラットフォームに対して正確なリクエストの価格を確認することである。

AIヘッドショットAPIが顔に何を変えるか

固定エンドポイントは意見を持っている。そのREADMEは、仕事を「カジュアルなポートレートをスタジオ品質のビジネスヘッドショットに変えること」と説明しており、実際には、背景と衣服が置き換えられ、顔は認識可能なままであることを意図している。

1つのポートレートを両方のルートで実行して、どこで分岐するかを見た。

2026年8月19日実行。入力はAI生成の架空人物であり、実在の人物の写真ではない。

両方の出力は、同じ顔として認識可能であり、どちらも人物をビジネスアタイアに着せ替え、プレーンな背景にするという仕事を果たした。違いは、誰も要求しなかった部分にある。固定エンドポイントは、薄いグレーのブレザーを選び、その下には何もなく、クロップを決定し、長いウェーブのかかった髪はそのままにした。編集エンドポイントは、プロンプトで指定されたすべてのアイテム（濃いグレーのブレザー、白いシャツ、薄いグレーの背景、頭と肩のフレーミング）を提供し、さらに進んで髪を短くし、よりきちんとした対称的な形状にした。プロンプトは顔を変えないように求めていたが、髪については何も言及していなかった。

汎用編集ルートを選択すると、決定権はあなたに戻るが、それらを明示するコストがかかる。それぞれが受け入れるものを比較する：

計画すべき2つのこと。LiteティアのプラットフォームのREADMEは、モデルが小さな顔、正確なスペル、非常に細かいディテールに苦労する可能性があると述べている。そのテストの入力は、顔がフレームのごく一部を占める全身ショットから始まり、問題なく処理された。したがって、警告は絶対的な下限ではないが、グループ写真のトリミングはより難しいケースであり、スクリーニングする価値がある。同じREADMEは、編集された画像にはデフォルトでC2PAコンテンツクレデンシャルと知覚できないSynthID透かしが含まれると述べている。そのシグネチャはファイルとともに移動する。LinkedInは、C2PA情報が添付された画像にコンテンツクレデンシャルを表示する。したがって、この方法で生成されたヘッドショットは、その出所が表示された状態でプロフィールに表示される可能性がある。

それは問題ない。顔が正しい限りは。LinkedInのプロフィール写真ガイドラインは、自分自身のイラストや芸術的表現を許可しており、写真があなたの似顔絵を反映していることを条件としている。AIヘッドショットはそのテストに合格する。ユーザーの顔ではない生成された顔は、合格しない。

本番環境でのAIヘッドショットAPIの実行

出荷する前に、後回しにするのではなく、決定しておく価値のあることがいくつかある。

最後の行は、チームがスキップするものである。エンドポイント自身のドキュメントは、実際の人物の似顔絵を編集または生成する前に同意を得ること、および結果を欺瞞、嫌がらせ、またはなりすましに使用しないことを求めている。機能が従業員の写真を自動的にヘッドショットに変換する場合、同意ステップは誰も読まないポリシードキュメントではなく、アップロードフローに属する。

よくある質問

無料枠のある開発者向けAIヘッドショットAPIはありますか？

API自体は最初の呼び出しから従量制である。無料実行はツールページにあり、対象となる各アカウントは1回のフル解像度生成を利用できる。出力スタイルを確認し、統合後に画像ごとの価格設定を予算に組み込むために使用する。

プロフェッショナルヘッドショット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透かしが含まれる。署名動作はモデル固有であるため、選択したエンドポイントのREADMEを確認すること。

APIを通じて生成されたヘッドショットはLinkedInで使用できますか？

はい、画像が実際の人物を反映している場合に限る。LinkedInの写真ガイドラインは、自分自身の芸術的表現を許可し、他の人物の似顔絵のみ、ストック画像、または架空のキャラクターで構成される写真を禁止している。

結論

必要なのが標準的なビジネスヘッドショットで、プロンプトを所有したくないのであれば、固定エンドポイントがより短い道である。2つのフィールド、1つの出力、呼び出す前に読める価格。

製品が特定のもの（特定のジャケット、ブランドの背景、カードコンポーネントに一致するポートレートクロップ）を必要とする瞬間、そのエンドポイントは何も提供できず、計画していなくてもプロンプトを書くことになる。2つの質問がそれを決定し、どちらも単価ではない。2年後も誰かがそのプロンプトを維持しているだろうか？1k出力と4k出力の違いは、ユーザーの画面に届くことがあるだろうか？