製品概要
Imagenは、プロカメラマンのポストプロダクション作業を大幅に削減するAIソリューションです。
仕組みは？
カメラマンは編集用のAI プロファイルを選択し、写真をImagenにアップロードします。Imagenは手動処理の何分の一かの時間で、AI プロファイルを使って写真を編集します。
Imagen APIは、Imagenアプリと同様に、カメラマンのポストプロダクション編集ワークフローを自動化します。このドキュメントでは、フローと呼び出すエンドポイントについて説明します。Imagenアプリの一部の機能はまだAPIに含まれていません。このドキュメントはImagen APIがサポートするエンドポイントを説明します。
はじめに
このセクションの情報を確認して、環境の準備とAPIの基本を理解してください。
Imagenアプリでサインアップしてプロファイルを選択する
Imagen APIを使用する前に、サインアップしてImagenのビジネスプランに登録する必要があります。その後、APIキーを取得するためにサポートにメールしてください。メールにはImagenへのサインアップに使用したメールアドレスを記載してください。
まずアプリでImagenを試して、AI プロファイルを選択するか、独自のプロファイルを作成することをお勧めします。プロファイルを作成したら、APIで編集の自動化を開始できます。
ImagenベースURL
Imagen APIのベースURLはhttps://api.imagen-ai.com/v1/です。
認証
Imagen APIは認証にAPIキーを使用します。テキスト形式でリクエストのヘッダーに追加してください。ヘッダー名はx-api-keyです。
以下に例を示します：
curl --location 'https://api-beta.imagen-ai.com/v1/profiles/' \
--header 'x-api-key: <api_key>' \
--header 'Content-Type: application/json'
写真編集でサポートされているファイル形式
Imagen APIは以下のファイル形式で写真の編集をサポートしています：
- RAW: NEF、CR2、CR3、ARW、NRW、CRW、SRF、SR2、ORF、RW2、RAF、PTX、PEF、RWL、SRW、3FR、FFF
- DNG: HDR マージの場合、DNGファイルにはRAWデータが含まれている必要があります。JPEGデータのみのDNGファイルはサポートされていません。
- JPEG
Imagen APIを試す方法
Python SDKを使って数分でImagen APIを使い始めましょう
Imagen APIは1行のコードで使えます。Python SDKを使ってください。始める前に、README.mdをご確認ください。ご不明な点は、Imagen APIクイックスタートやImagen API AIツールリファレンスをご参照ください。
コードサンプルを試す
クイックスタートを使う
クイックスタートImagen APIの仕組みを学び、コードサンプルとリファレンスAPIドキュメントへのリンクでフローをカスタマイズするには、リファレンスAPIドキュメントをご覧ください。
Pythonコードサンプルから始める
Pythonコードサンプルでは、Imagen APIエンドポイントを呼び出して写真を編集する方法を紹介しています。また、プロジェクト内の写真を1枚ずつではなく同時にアップロード・ダウンロードできるスレッド処理も実演しています。
Postmanコレクションでテストする
Postmanコレクションを使って、Imagen APIエンドポイントをテストできます。
- PostmanコレクションをPCにダウンロードします。
- Postmanを開きます。
- ファイル > インポート to open the collection in Postman.に進み、Postmanでコレクションを開きます。