AI APIリファレンス.

DXPR Builderは3つのAIルートを公開します。ブラウザーが呼び出し、コントローラーがDrupal AIモジュール経由でDXPRプロバイダー(ai_provider_dxpr)にリクエストをプロキシーするため、APIキーがブラウザーに届くことはありません。ルートはdxpr_builder.routing.ymlで定義されています。下記の動作はsrc/Controller/AiChatController.phpとsrc/Controller/AiImageController.phpによるものです。

アクセス要件(3ルート共通)

トークンはルートパス用のDrupalルートCSRFトークンです。DXPR Builderはサーバー側で生成し、drupalSettings.dxprBuilder.aiAgentにendpointUrl、imageEndpointUrl、imageEditEndpointUrlとして埋め込みます(DxprBuilderFormatter参照)。有効なURLを得るには、エディターが読み込まれたページからこれらの値のいずれかを読み取ります。アクセスチェックの失敗はDrupal標準の403レスポンスを返します。

コントローラーは常にdxprプロバイダーをインスタンス化します。/admin/config/ai/settingsで設定したプロバイダーは使われません。

Chat

POST /dxpr_builder/ajax/ai/chat?token=...

テキストコマンド、ページ作成、プロンプト候補が使います。コントローラーはJSONボディを読み取り、$provider->chat()を呼び出します。

リクエストボディ

コントローラーは常にプロバイダー設定にjsonrpc: falseを追加します。呼び出し前にAI Output Filtering > Allowed domainsのドメインをAIモジュールのホスト名フィルターにリクエスト中のみマージします(*でフィルターは完全信頼になります)。

レスポンス

ストリーミング(streamがtrue、デフォルト)：200、Content-Type: text/event-stream。各イベントはdata: {json}の後に空行が続き、ストリームはdata: [DONE]で終わります。

data: {"choices":[{"delta":{"content":"Hello"}}],"id":"...","model":"kavya-m1","usage":{...}}

data: [DONE]

id、object、created、model、 original_model、usageはプロバイダーの生チャンクにあればコピーされます。

非ストリーミング(streamがfalse)：200、application/json。

{"choices":[{"message":{"role":"assistant","content":"..."}}]}

エラー

例

const url = drupalSettings.dxprBuilder.aiAgent.endpointUrl;
const res = await fetch(url, {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    model: "kavya-m1",
    stream: false,
    messages: [
      { role: "system", content: "You are a copywriter." },
      { role: "user", content: "Shorten: <p>Our team ...</p>" }
    ]
  })
});
const data = await res.json();
console.log(data.choices[0].message.content);

画像生成

POST /dxpr_builder/ajax/ai/image?token=...

呼び出すのは$provider->textToImage()です。

リクエストボディ

レスポンス

200、application/json。返されるのは最初の画像のみで、base64エンコード済みです。DXPRプロバイダーはwebp出力を要求します。

{"data":[{"b64_json":"UklGRi..."}]}

エラー

例

curl -X POST "https://example.com/dxpr_builder/ajax/ai/image?token=TOKEN" \
  -H "Content-Type: application/json" \
  -H "Cookie: SESSxxx=..." \
  -d '{"prompt":"Flat illustration of a rocket","size":"1536x1024"}'

画像編集

POST /dxpr_builder/ajax/ai/image/edit?token=...

呼び出すのは$provider->imageToImage()で、アップロード画像とプロンプトを渡します。

リクエストボディ

レスポンス

画像生成と同じ形状です。{"data":[{"b64_json":"..."}]}。

エラー

例

const url = drupalSettings.dxprBuilder.aiAgent.imageEditEndpointUrl;
const res = await fetch(url, {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    prompt: "Remove the background",
    image: base64String,
    mimeType: "image/jpeg"
  })
});
const { data } = await res.json();

生成画像の保存

ルートが返すのは画像バイトのみです。ビルダーはb64_jsonをwebpファイルに変換し、POST /dxpr_builder/ajax/file_upload(drupalSettings.dxprBuilder.fileUploadUrl、フォームフィールドupload[])にアップロードします。応答はファイルのurlとfidです。プロンプトはファイル名(先頭80文字)と代替テキストになります。

次のステップ

• モデルとプロバイダー
• AI設定
• AIのトラブルシューティング