写真カラー化 API とは？
ImgGen AI カラー化 API は、モノクロやグレースケールの画像に写実的な色を加える REST エンドポイントです。モデルは画像の内容そのものから、肌・衣服・草木・空・素材のもっともらしい色を推論するため、参照パレットも手動選択も必要ありません。色のついた結果は同じレスポンスで返ります。
これは ImgGen AI 画像編集 API の 7 つのエンドポイントのひとつで、いずれも同じ API キー、同じベース URL、同じリクエストとレスポンスの形式を共有しています。コードからではなくブラウザでもこの機能が必要な場合は、同じ AI モデルが Colorize Photo ツールを動かしています。
リクエストパラメータ
https://app.imggen.ai/v1/colorize-photo に POST リクエストを送り、Authorization ヘッダーの API キーで認証します。
| パラメータ | 型 | 必須 | デフォルト | 説明 |
|---|---|---|---|---|
| image | file | 必須 | — | カラー化しながら傷や裂けを修復します。 |
| removeTears | boolean | 任意 | false | Repair scratches and tears while colorizing. |
写真カラー化 API はどう組み込みますか？
ImgGen アカウントで API キーを作成し、環境変数に設定してエンドポイントを呼び出します。同じリクエストを cURL、Node.js、Python で示します。
curl --request POST \
--url 'https://app.imggen.ai/v1/colorize-photo' \
--header 'Authorization: Bearer sk_live_YOUR_API_KEY' \
--form image=@/path/to/photo.jpg \
--form removeTears=falseimport fs from 'node:fs';
const form = new FormData();
form.append('image', new Blob([fs.readFileSync('photo.jpg')]), 'photo.jpg');
form.append('removeTears', 'false');
const res = await fetch('https://app.imggen.ai/v1/colorize-photo', {
method: 'POST',
headers: { Authorization: `Bearer ${process.env.IMGGEN_API_KEY}` },
body: form,
});
const data = await res.json();
// data.image is a base64-encoded PNG
fs.writeFileSync('result.png', Buffer.from(data.image, 'base64'));import base64, os, requests
with open("photo.jpg", "rb") as f:
res = requests.post(
"https://app.imggen.ai/v1/colorize-photo",
headers={"Authorization": f"Bearer {os.environ['IMGGEN_API_KEY']}"},
files={"image": f},
data={"removeTears": "false"},
)
data = res.json()
with open("result.png", "wb") as out:
out.write(base64.b64decode(data["image"]))レスポンス
成功した呼び出しは JSON を返します。結果は base64 エンコードされているので、ディスクやオブジェクトストレージに書き込む前にデコードしてください。成功したレスポンスにはいずれも、呼び出し後の残高を示す X-Credit-Remaining ヘッダーが付きます。
{
"success": true,
"message": "Image colorized successfully",
"image": "iVBORw0KGgoAAAANSUhEUgAA...SUVORK5CYII="
}知っておきたい制限と挙動
このエンドポイントは JPEG（JPG）、PNG、WebP を最大 25 MB のファイルサイズで受け付け、60 秒以内に同期的に応答します。ジョブをポーリングする必要も、Webhook を設定する必要もありません。
色は推論であって復元ではありません
モデルは画像の内容からもっともらしい色を予測します。説得力のある解釈を作りますが、史実として検証されたものではありません。結果をユーザーに見せるなら、そこははっきり伝える価値があります。
カラー化しながら修復
removeTears=true を指定すれば、修復エンドポイントを 2 回目に呼ぶことなく、同じ処理の中で傷や物理的な損傷を直せます。
すでに色がある画像
このエンドポイントはグレースケール入力向けに作られています。すでに色のある画像を送っても意味がありません。目的が修復なら、修復エンドポイントをお使いください。
写真カラー化 API は何に使われていますか？
各チームがこのエンドポイントを本番環境に投入し、プログラムから大規模に画像を処理している場面です。
家族史に関わるプロダクト
受け継がれた写真のカラー化を、有料アップグレードやエンゲージメント機能としてアプリ内でユーザーに提供します。
編集・出版
特集や回顧記事のために、アーカイブ写真のカラー版を制作します。解釈であることを明示したうえで使います。
アーカイブの一括処理
グレースケールのコレクション全体にカラーの利用コピーを生成しつつ、原本には手を触れません。
記念・ギフトサービス
受注処理の一環として、顧客がアップロードした写真を自動でカラー化・修復します。
写真カラー化 API の料金は？
成功した呼び出し 1 回につき 2クレジット かかるため、1 枚あたりの実質コストはご利用のプランによって決まります。クレジットはプランから消費され、すべてのエンドポイントと Web エディターで共通なので、ツールごとに別枠を購入する必要はありません。失敗した呼び出しは自動的に返金されます。詳細は料金ページをご覧ください。
| プラン | 料金 | クレジット | API |
|---|---|---|---|
| Free | $0 | 無料クレジット 50（一度限り） | API アクセスなし |
| Starter | $9.99 / month | 月 400 クレジット | API アクセス込み |
| Pro | $29.99 / month | 月 1,400 クレジット | API アクセス + 優先サポート |
| Enterprise | Custom | カスタム量 | 専有インフラ |
クレジット料金と制限の最終確認日 2026-08-27.
関連するエンドポイントとツール
写真カラー化 API を使っているチームが、次に手を伸ばすことが多いのはこちらです。
その他の利用可能なもの： 背景除去, ウォーターマーク除去, テキスト除去, 画像生成.
写真カラー化 API のよくある質問
- モノクロ画像を受け取り、色のついた版を返す HTTP エンドポイントです。モデルは写真の内容（顔、衣服、草木、空、素材）を読み取り、それに合う色を予測するので、パレットを指定しなくても自然な結果が得られます。
- 検証済みというより、もっともらしいものです。1953 年のその上着が実際に何色だったかをモデルは知りません。画面に見えるすべてを踏まえて、もっとも可能性の高い着色を出しています。肌の色・草木・空は変動の幅が狭いため、たいてい説得力があります。衣服や塗装面など、色が任意に決まるものは根拠のある推測です。歴史的な資料では、出力を解釈として提示してください。
- 成功 1 回につき 2 クレジットです。Starter は月 400 クレジットで 9.99 ドル、Pro は 1,400 クレジットで 29.99 ドル、購読中は未使用クレジットが繰り越されます。
- ImgGen アカウントで API キーを作成し、image フィールドを含むマルチパートフォームを Authorization: Bearer ヘッダーで認証しながら https://app.imggen.ai/v1/colorize-photo に POST します。JSON レスポンスの base64 の image フィールドをデコードして、保存先に書き込んでください。cURL・Node.js・Python の例はこのページにあります。
- このエンドポイントは色を加えるために作られており、任意で裂けを修復できます。修復エンドポイントは損傷を直すために作られており、任意で色を加えられます。写真が主に傷んでいるなら修復を、主にモノクロなだけならこちらをお使いください。
- API は 1 枚あたり最大 25 MB の JPEG（JPG）、PNG、WebP ファイルを受け付けます。結果は JSON レスポンス内に base64 エンコードされた画像として返されます。
- いいえ。この API はステートレスです。プロジェクトを作成することも、ファイルを保存することも、あなたの画像を保持することもありません。アップロードされたファイルは一時オブジェクトに書き込まれ、処理後、レスポンスを返すと同時に削除されます。残るのは、呼び出しが行われたことと消費クレジット数を記録した利用ログだけです。あなたの画像がモデルの学習に使われることは一切ありません。
はじめる
写真カラー化 API を呼び出してみる
キー 1 つで 7 つのエンドポイントすべてが使えます。ウォーターマークなし、完全な商用利用権付き、そして送信したものはレスポンス後に一切保存されません。
API キーを取得