GASでDALL·E3の画像生成をAPI経由で実行する方法！設定パラメータ解説

2023年11月29日

2023年11月にOpenAIが画像生成AIのDALL·E3(ダリスリー)をAPIリクエストして利用できるようにしました。

DALL-E2(ダリツー)よりも高性能なDALL-E3を、Google Apps Script(GAS)からAPI経由で実行する方法を解説します。

APIリクエストに必要なパラメータ設定を説明しながら、コピペで動かせるサンプルコードを掲載しています。

1. 2023年11月にDALL-E3のAPIがリリース
2. DALL-E2よりも高精度・高画質なDALL-E3
3. DALL-E3のAPIはエンドポイントがDALL-E2と同じ
4. DALL-E3のみ設定可能なAPIパラメータ
5. GASでのDALL-E3のAPIリクエストはDALL-E2を少し改良
6. GASでDALL-E3の画像生成するサンプルコード
7. DALL-E3のAPI利用の注意点
8. まとめ・終わりに

2023年11月にDALL-E3のAPIがリリース

2023年11月に開催されたOpenAIのイベント「DevDay」では生成AIに関するアップデート情報が発表されました。

アップデート情報の１つが画像生成AIであるDALL-E3のAPIリリースです。

2023年11月に開催されたOpenAIのDevDayにてDALL-E3のAPI提供が発表

これまでは1つ前のバージョンであるDALL-E2しかAPI経由では利用できませんでした。

しかし、2023年11月からはDALL-E3をAPIリクエストして画像生成が可能になりました。

これによって、Google Apps Script(GAS)から高性能なDALL-E3による画像生成するプログラムが作成できます。

DALL-E2よりも高精度・高画質なDALL-E3

OpenAIによると、DALL-E3は前のバージョンであるDALL-E2よりも画像生成AIとしての性能が向上しているそうです。

同じプロンプトを入力した場合でも、DALL-E2とDALL-E3では画像生成されるアウトプットの画像の品質に大きな差が生じています。

OpenAIのDALL-E3の解説によると、同じプロンプトでもDALLE2よりもDALLE3のほうが高品質な画像が生成

さらに、DALL-E2よりもDALL-E3のほうがプロンプトで指示した項目がきちんと反映された画像が生成されるとのことです。

それゆえにDALL-E3を使うことでより高精度・高品質な画像を生成することができます。

DALL-E3のAPIはエンドポイントがDALL-E2と同じ

そんな性能が格段に向上したDALL-E3がAPIを叩いて画像生成できるようになりました。

DALL-E3のAPIリクエストするためのエンドポイントは実はDALL-E2と同じURLです。

OpenAIのAPIリファレンスによると、DALLE·3のAPIもDALLE2と同じエンドポイント使用

https://api.openai.com/v1/images/generations

上記のエンドポイントURLにHTTPSのPOSTすることでDALL-E3のAPI実行できます。

APIでリクエストできるプロンプトの分量はDALL-E2が英語で1000文字だったのに対し、DALL-E3はその4倍となる4000文字まで入力可能です。

DALL-E3のみ設定可能なAPIパラメータ

前述した通り、DALL-E3のAPIはエンドポイントのURLがDALL-E2と同一です。

ただ、DALL-E3のAPIをリクエストする場合、DALL-E2とは設定パラメータの変更が必要です。

DALL-E3のAPIにペイロードでセットするパラメータとして、以下の項目を設定します。

model
quality
size
style

①modelは画像生成AIのモデルを指定するパラメータです。

DALL-E3で画像生成するには、「dall-e-3」を指定します。

modelパラメータを省略してしまうと、モデルがDALL-E2になるので、DALL-E3を使いたい場合は設定必須です。

②qualityはDALL-E3でのみ利用できる品質を制御するパラメータです。

standardとhdの2種類が設定でき、省略した場合のデフォルトはstandardが指定されます。

hdを指定するとより高精度・高画質な画像が生成されます。

※その分APIリクエストにかかる料金が倍になるので注意が必要です。

③sizeは生成する画像の大きさを指定するパラメータです。

DALL-E3の画像生成AIモデルの場合、以下の3パターンのサイズを指定できます。

1024×1024
1024×1792
1792×1024

DALL-E2では256×256、512×512、1024×1024の3種類でした。

DALL-E3のAPIでは正方形サイズ以外に縦長・横長の長方形サイズも画像生成できるようになっています。

※sizeパラメータを省略すると、1024×1024がセットされます。

④styleはDALL-E3でのみ利用できる生成画像のスタイルを選択するパラメータです。

現在設定できるstyleパラメータはvividまたはnaturalの2種類となっています。

省略した場合はvividなので、naturalなスタイルの画像を生成したい場合は設定します。

GASでのDALL-E3のAPIリクエストはDALL-E2を少し改良

ここまで説明してきた通り、DALL-E3のAPIリクエストはエンドポイントURLが同じで、設定するパラメータが異なります。

そのため、Google Apps Script(GAS)でDALL-E3をAPI実行する場合、コードはDALL-E2と基本的に同じです。

AutoWorkerではGASでDALL-E2をAPIリクエストして画像生成する方法を解説しています。

【GAS】画像生成AI・DALL-EをOpenAIのAPIから画像を生成(ドライブ保存)

今回、DALL-E3のAPIを実行する方法も上記のサンプルコードをベースに、パラメータ周りを少し追加しています。

GASでDALL-E3の画像生成するサンプルコード

実際にGoogle Apps Script(GAS)でDALL-E3のAPIを実行して画像を生成する方法をサンプルコードで解説します。

DALL-E3のAPIをリクエストして設定プロンプトから画像生成し、Googleドライブに画像を保存するサンプルコードは以下の通りです。

function requestDallE3Image() {
  //スクリプトプロパティに設定したOpenAIのAPIキーを取得
  const apiKey = PropertiesService.getScriptProperties().getProperty('APIKEY');
  //画像生成AIのAPIのエンドポイントを設定
  const apiUrl = 'https://api.openai.com/v1/images/generations';
  //画像生成AIに投げるテキスト(プロンプト)を定義
  const prompt = '画像生成したいプロンプトを入力してください';
  //OpenAIのAPIリクエストに必要なヘッダー情報を設定
  let headers = {
    'Authorization':'Bearer '+ apiKey,
    'Content-type': 'application/json',
    'X-Slack-No-Retry': 1
  };
  //DALL-E3モデル指定と画質、画像生成の枚数とサイズ、プロンプトをオプションに設定
  let options = {
    'muteHttpExceptions' : true,
    'headers': headers, 
    'method': 'POST',
    'payload': JSON.stringify({
      'model' : 'dall-e-3',
      'quality' : 'standard',
      'style' : 'natural',
      'n': 1,
      'size' : '1024x1024',
      'prompt': prompt})
  };
  //OpenAIの画像生成AI(Images)にAPIリクエストを送り、結果を変数に格納
  const response = JSON.parse(UrlFetchApp.fetch(apiUrl, options).getContentText());
  //生成された画像のURLにフェッチして画像データを取得して、名前をつける
  const image = UrlFetchApp.fetch(response.data[0].url).getAs('image/png').setName('DALL-E3生成画像');
  //Googleドライブに画像を保存し、画像の保存先URLをログ出力
  const driveUrl = DriveApp.createFile(image).getUrl();
  console.log('Googleドライブ格納先：'+ driveUrl);
}