Azure OpenAI イメージ、オーディオ、およびビデオ REST API リファレンス (v1 プレビュー)

この記事では、v1 プレビューリリースで OpenAI Azureの画像、オーディオ (音声)、およびビデオ生成データプレーン推論 REST API 操作について説明します。チャットの完了、埋め込み、回避、ファイル、微調整、応答、ベクターストア、その他すべての操作については、OpenAI REST API リファレンスAzure公式を参照してください。

データプレーン推論

この記事の残りの部分では、Azure OpenAI データプレーン推論仕様の新しい v1 プレビュー API リリースでの画像、オーディオ、およびビデオの操作について説明します。詳細については、 API ライフサイクルガイドを参照してください。

完全な v1 GA データプレーン API については、OpenAI REST API リファレンスAzure公式を参照してください。

音声を作成する

POST {endpoint}/openai/v1/audio/speech?api-version=preview

入力テキストからテキスト読み上げオーディオを生成します。

URI パラメーター

名前	インチ	必須	タイプ	説明
エンドポイント	パス	はい	文字列 Url	OpenAI Azureエンドポイント(プロトコルおよびホスト名、例:`https://aoairesource.openai.azure.com`)に対応しています。「aoairesource」をAzure OpenAIリソース名に置き換えてください。 https://{your-resource-name}.openai.azure.com
api-version	クエリ	いいえ		この要求Microsoft使用する Foundry Models API の明示的なバージョン。 `v1` それ以外の場合は〗。

要求ヘッダー

トークンベースの認証かAPIキーのいずれかを使ってください。トークンベースの認証を用いることが推奨され、より安全です。

名前	必須	タイプ	説明
承認	True	文字列	例：`Authorization: Bearer {Azure_OpenAI_Auth_Token}` 認証トークンを生成するにはAzure CLI: `az account get-access-token --resource https://cognitiveservices.azure.com` 型: oauth2 認証URL: `https://login.microsoftonline.com/common/oauth2/v2.0/authorize` 範囲: `https://ai.azure.com/.default`
api-key	True	文字列	ここにAzure OpenAI API キーを提供してください

要求本文

Content-Type: マルチパート/フォームデータ

名前	タイプ	説明	必須	既定
入力	文字列	オーディオを生成する対象のテキスト。最大長は 4096 文字です。	はい
指示	文字列	追加の手順を使用して、生成されたオーディオの音声を制御します。 `tts-1`または`tts-1-hd`では機能しません。	いいえ
モデル	文字列	このテキスト読み上げ要求に使用するモデル。	はい
response_format	オブジェクト	テキスト読み上げでサポートされているオーディオ出力形式。	いいえ
速度	数	生成されたオーディオの音声速度。値は 0.25 から 4.0 の範囲で有効です。既定値は 1.0 で、より高速な音声に対応する値は 1.0 です。	いいえ	1
stream_format	列挙型	オーディオをストリーミングする形式。サポートされている形式は、 `sse` と `audio`です。 `sse` は、 `tts-1` または `tts-1-hd`ではサポートされていません。可能な値: `sse`、 `audio`	いいえ
声	オブジェクト		はい

応答

ステータスコード: 200

説明: 要求は成功しました。

Content-Type	型	説明
application/octet-stream	文字列

ステータスコード: デフォルト

説明: 予期しないエラー応答。

Content-Type	型	説明
application/json	AzureErrorResponse

例

提供されたテキストから音声を合成します。

POST {endpoint}/openai/v1/audio/speech?api-version=preview

{
 "input": "Hi! What are you going to make?",
 "voice": "fable",
 "response_format": "mp3",
 "model": "tts-1"
}

回答:ステータスコード:200

{
  "body": "101010101"
}

文字起こしを作成する

POST {endpoint}/openai/v1/audio/transcriptions?api-version=preview

音声を入力言語に書き起こします。

URI パラメーター

名前	インチ	必須	タイプ	説明
エンドポイント	パス	はい	文字列 Url	OpenAI Azureエンドポイント(プロトコルおよびホスト名、例:`https://aoairesource.openai.azure.com`)に対応しています。「aoairesource」をAzure OpenAIリソース名に置き換えてください。 https://{your-resource-name}.openai.azure.com
api-version	クエリ	いいえ		この要求に使用する明示的な Foundry Models API バージョン。 `v1` それ以外の場合は〗。

要求ヘッダー

トークンベースの認証かAPIキーのいずれかを使ってください。トークンベースの認証を用いることが推奨され、より安全です。

名前	必須	タイプ	説明
承認	True	文字列	例：`Authorization: Bearer {Azure_OpenAI_Auth_Token}` 認証トークンを生成するにはAzure CLI: `az account get-access-token --resource https://cognitiveservices.azure.com` 型: oauth2 認証URL: `https://login.microsoftonline.com/common/oauth2/v2.0/authorize` 範囲: `https://ai.azure.com/.default`
api-key	True	文字列	ここにAzure OpenAI API キーを提供してください

要求本文

Content-Type: マルチパート/フォームデータ

名前	タイプ	説明	必須	既定
chunking_strategy	オブジェクト		いいえ
└─ prefix_padding_ms（プリフィックス・パディング・ミリ秒）	整数	VADが音声を検出する前に含める音声量(ミリ秒単位)。	いいえ	300
└─ 無音時間_ミリ秒	整数	発言停止を検出するための無音の持続時間(ミリ秒単位)。短い値を使えばモデルはより速く反応しますが、ユーザーの短い間入りに飛び込むことがあります。	いいえ	200
└─ しきい値	数	音声アクティビティ検出の感度しきい値 (0.0 から 1.0)。閾値が高いほど、モデルを起動するにはより大きな音が必要になり、騒がしい環境での性能が向上する可能性があります。	いいえ	0.5
└─ 型	列挙型	サーバー側 VAD を使用して手動チャンクを有効にするには、 `server_vad` に設定する必要があります。可能な値: `server_vad`	いいえ
ファイル	文字列		はい
Filename	文字列	オーディオデータに関連付けるファイル名または説明識別子 (省略可能)。	いいえ
include[]	アレイ	文字起こし応答に含める追加情報。 `logprobs` では、文字起こしに対するモデルの信頼度を理解するために、応答でトークンのログ確率が返されます。 `logprobs` は、 `json` に設定されたresponse_formatでのみ機能し、モデル `gpt-4o-transcribe`、 `gpt-4o-transcribe-diarize`、 `gpt-4o-mini-transcribe`、および `gpt-4o-mini-transcribe-2025-12-15`でのみ機能します。	いいえ
言語	文字列	入力音声の言語。 ISO-639-1 (例: `en`) 形式で入力言語を指定すると、精度と待機時間が向上します。	いいえ
モデル	文字列	この文字起こし要求に使用するモデル。	いいえ
ダイアログを表示する	文字列	モデルのスタイルをガイドしたり、前の音声セグメントを続けるためのオプションテキスト。プロンプトは音声言語に合っているべきです。	いいえ
response_format	オブジェクト		いいえ
ストリーミング	ブール	trueに設定すると、モデル応答データはサーバー送信イベントで生成される際にクライアントにストリーミングされます。注: ストリーミングは、 `whisper-1` モデルではサポートされていないため、無視されます。	いいえ	False
温度	数	サンプリング温度は0から1の間です。 0.8のような高い値は出力をよりランダムにし、0.2のように低い値はより集中して決定的になります。 0 に設定すると、モデルはログ確率を使用して、特定のしきい値に達するまで温度を自動的に上昇させます。	いいえ	0
timestamp_granularities[]	アレイ	この文字起こしのために入力するタイムスタンプの細さ。 `response_format` タイムスタンプの粒度を使わせるように `verbose_json` 設定する必要があります。これらの選択肢のいずれか、または両方がサポートされています: `word`または `segment`。注:セグメントタイムスタンプに追加の遅延はありませんが、ワードタイムスタンプを生成すると追加の遅延が発生します。	いいえ	['segment']

応答

ステータスコード: 200

説明: 要求は成功しました。

Content-Type	型	説明
application/json	AzureAudioTranscriptionResponse
text/plain	文字列

ステータスコード: デフォルト

説明: 予期しないエラー応答。

Content-Type	型	説明
application/json	AzureErrorResponse

例

提供された音声データから文字起こしテキストと関連メタデータを取得します。

POST {endpoint}/openai/v1/audio/transcriptions?api-version=preview

{
 "file": "<binary audio data>",
 "model": "whisper-1",
 "response_format": "text"
}

回答:ステータスコード:200

{
  "body": "plain text when requesting text, srt, or vtt"
}

翻訳の作成

POST {endpoint}/openai/v1/audio/translations?api-version=preview

提供された音声データから英語の文字起こしテキストと関連するメタデータを取得します。

URI パラメーター

名前	インチ	必須	タイプ	説明
エンドポイント	パス	はい	文字列 Url	OpenAI Azureエンドポイント(プロトコルおよびホスト名、例:`https://aoairesource.openai.azure.com`)に対応しています。「aoairesource」をAzure OpenAIリソース名に置き換えてください。 https://{your-resource-name}.openai.azure.com
api-version	クエリ	いいえ		この要求に使用する明示的な Foundry Models API バージョン。 `v1` それ以外の場合は〗。

要求ヘッダー

トークンベースの認証かAPIキーのいずれかを使ってください。トークンベースの認証を用いることが推奨され、より安全です。

名前	必須	タイプ	説明
承認	True	文字列	例：`Authorization: Bearer {Azure_OpenAI_Auth_Token}` 認証トークンを生成するにはAzure CLI: `az account get-access-token --resource https://cognitiveservices.azure.com` 型: oauth2 認証URL: `https://login.microsoftonline.com/common/oauth2/v2.0/authorize` 範囲: `https://ai.azure.com/.default`
api-key	True	文字列	ここにAzure OpenAI API キーを提供してください

要求本文

Content-Type: マルチパート/フォームデータ

名前	タイプ	説明	必須	既定
ファイル	文字列		はい
Filename	文字列	オーディオデータに関連付けるファイル名または説明識別子 (省略可能)	いいえ
モデル	文字列	この翻訳要求に使用するモデル。	いいえ
ダイアログを表示する	文字列	モデルのスタイルをガイドしたり、前の音声セグメントを続けるためのオプションテキスト。プロンプトは英語で書かれるべきです。	いいえ
response_format	オブジェクト		いいえ
温度	数	サンプリング温度は0から1の間です。 0.8のような高い値は出力をよりランダムにし、0.2のように低い値はより集中して決定的になります。 0 に設定すると、モデルはログ確率を使用して、特定のしきい値に達するまで温度を自動的に上昇させます。	いいえ	0

応答

ステータスコード: 200

説明: 要求は成功しました。

Content-Type	型	説明
application/json	AzureAudioTranslationResponse
text/plain	文字列

ステータスコード: デフォルト

説明: 予期しないエラー応答。

Content-Type	型	説明
application/json	AzureErrorResponse

例

提供された音声データから英語の文字起こしテキストと関連するメタデータを取得します。

POST {endpoint}/openai/v1/audio/translations?api-version=preview

{
 "file": "<binary audio data>",
 "model": "whisper-1",
 "response_format": "text"
}

回答:ステータスコード:200

{
  "body": "plain text when requesting text, srt, or vtt"
}

イメージの編集を作成する

POST {endpoint}/openai/v1/images/edits?api-version=preview

URI パラメーター

名前	インチ	必須	タイプ	説明
エンドポイント	パス	はい	文字列 Url	OpenAI Azureエンドポイント(プロトコルおよびホスト名、例:`https://aoairesource.openai.azure.com`)に対応しています。「aoairesource」をAzure OpenAIリソース名に置き換えてください。 https://{your-resource-name}.openai.azure.com
api-version	クエリ	いいえ		この要求に使用する明示的な Foundry Models API バージョン。 `v1` それ以外の場合は〗。

要求ヘッダー

トークンベースの認証かAPIキーのいずれかを使ってください。トークンベースの認証を用いることが推奨され、より安全です。

名前	必須	タイプ	説明
承認	True	文字列	例：`Authorization: Bearer {Azure_OpenAI_Auth_Token}` 認証トークンを生成するにはAzure CLI: `az account get-access-token --resource https://cognitiveservices.azure.com` 型: oauth2 認証URL: `https://login.microsoftonline.com/common/oauth2/v2.0/authorize` 範囲: `https://ai.azure.com/.default`
api-key	True	文字列	ここにAzure OpenAI API キーを提供してください

要求本文

Content-Type: マルチパート/フォームデータ

名前	タイプ	説明	必須	既定
バックグラウンド	列挙型	生成画像の背景の透明度設定が可能です。このパラメーターは、 `gpt-image-1` モデルでのみサポートされます。 `transparent`、`opaque`、または`auto`のいずれかである必要があります (既定値)。 `auto`を使用すると、モデルによってイメージに最適な背景が自動的に決定されます。 `transparent`場合、出力形式は透明度をサポートする必要があるため、`png` (既定値) または`webp`に設定する必要があります。可能な値: `transparent`、 `opaque`、 `auto`	いいえ
イメージ	文字列または配列		はい
マスク	文字列		いいえ
モデル	文字列	イメージ編集操作に使用するモデルデプロイ。	はい
N	整数	生成すべき画像の数。 1から10の間でなければなりません。	いいえ	1
output_compression	整数	生成画像の圧縮レベル(0-100%)です。このパラメーターは、`gpt-image-1`形式または`webp`出力形式の`jpeg`シリーズモデルでのみサポートされ、既定値は 100 です。	いいえ	100
output_format	列挙型	生成された画像が返される形式。このパラメーターは、 `gpt-image-1` シリーズモデルでのみサポートされます。 `png`、`jpeg`、または`webp`のいずれかである必要があります。デフォルト値は `png`です。可能な値: `png`、 `jpeg`、 `webp`	いいえ
ダイアログを表示する	文字列	目的の画像のテキスト説明。 `dall-e-2`の最大長は 1,000 文字、`gpt-image-1` シリーズモデルの場合は 3,2000 文字です。	はい
品質	列挙型	生成される画像の品質。 `high`、 `medium` 、および `low` は、 `gpt-image-1` シリーズモデルでのみサポートされます。 `dall-e-2` は、 `standard` 品質のみをサポートします。デフォルトは `auto`です。可能な値: `standard`、 `low`、 `medium`、 `high`、 `auto`	いいえ
response_format	列挙型	生成された画像が返される形式。 `url`か`b64_json`のどちらかに違いない。 URL は、イメージが生成されてから 60 分間のみ有効です。 `dall-e-2` シリーズモデルは常に base64 でエンコードされたイメージを返すので、このパラメーターは`gpt-image-1`でのみサポートされます。可能な値: `url`、 `b64_json`	いいえ
サイズ	列挙型	生成される画像のサイズ。 `1024x1024` シリーズモデルの場合は、`1536x1024`、`1024x1536` (横)、`auto` (縦)、または`gpt-image-1` (既定値) のいずれか、および`256x256`の`512x512`、`1024x1024`、または`dall-e-2`のいずれかである必要があります。可能な値: `256x256`、 `512x512`、 `1024x1024`、 `1536x1024`、 `1024x1536`、 `auto`	いいえ
ユーザー	文字列	エンドユーザーを表す一意の識別子で、OpenAIが悪用を監視・検出するのに役立ちます。	いいえ

応答

ステータスコード: 200

説明: 要求は成功しました。

Content-Type	型	説明
application/json	AzureImagesResponse

ステータスコード: デフォルト

説明: 予期しないエラー応答。

Content-Type	型	説明
application/json	AzureErrorResponse

Createimage

POST {endpoint}/openai/v1/images/generations?api-version=preview

URI パラメーター

名前	インチ	必須	タイプ	説明
エンドポイント	パス	はい	文字列 Url	OpenAI Azureエンドポイント(プロトコルおよびホスト名、例:`https://aoairesource.openai.azure.com`)に対応しています。「aoairesource」をAzure OpenAIリソース名に置き換えてください。 https://{your-resource-name}.openai.azure.com
api-version	クエリ	いいえ		この要求に使用する明示的な Foundry Models API バージョン。 `v1` それ以外の場合は〗。

要求ヘッダー

トークンベースの認証かAPIキーのいずれかを使ってください。トークンベースの認証を用いることが推奨され、より安全です。

名前	必須	タイプ	説明
承認	True	文字列	例：`Authorization: Bearer {Azure_OpenAI_Auth_Token}` 認証トークンを生成するにはAzure CLI: `az account get-access-token --resource https://cognitiveservices.azure.com` 型: oauth2 認証URL: `https://login.microsoftonline.com/common/oauth2/v2.0/authorize` 範囲: `https://ai.azure.com/.default`
api-key	True	文字列	ここにAzure OpenAI API キーを提供してください

要求本文

コンテンツタイプ: アプリケーション/json

名前	タイプ	説明	必須	既定
バックグラウンド	列挙型	生成画像の背景の透明度設定が可能です。このパラメーターは、 `gpt-image-1` モデルでのみサポートされます。 `transparent`、`opaque`、または`auto`のいずれかである必要があります (既定値)。 `auto`を使用すると、モデルによってイメージに最適な背景が自動的に決定されます。 `transparent`場合、出力形式は透明度をサポートする必要があるため、`png` (既定値) または`webp`に設定する必要があります。可能な値: `transparent`、 `opaque`、 `auto`	いいえ
モデル	文字列	イメージの生成に使用するモデルデプロイ。	はい
節度	列挙型	`gpt-image-1` シリーズモデルによって生成されるイメージのコンテンツモデレーションレベルを制御します。制限の緩いフィルター処理の場合は `low` または `auto` (既定値) である必要があります。可能な値: `low`、 `auto`	いいえ
N	整数	生成すべき画像の数。 1から10の間でなければなりません。 `dall-e-3`では、`n=1`のみがサポートされます。	いいえ	1
output_compression	整数	生成画像の圧縮レベル(0-100%)です。このパラメーターは、`gpt-image-1`形式または`webp`出力形式の`jpeg`シリーズモデルでのみサポートされ、既定値は 100 です。	いいえ	100
output_format	列挙型	生成された画像が返される形式。このパラメーターは、 `gpt-image-1` シリーズモデルでのみサポートされます。 `png`、`jpeg`、または`webp`のいずれかである必要があります。可能な値: `png`、 `jpeg`、 `webp`	いいえ
ダイアログを表示する	文字列	目的の画像のテキスト説明。最大長は、 `gpt-image-1` シリーズモデルでは 3,2000 文字、 `dall-e-2` では 1,000 文字、 `dall-e-3`では 4,000 文字です。	はい
品質	列挙型	生成される画像の品質。 - `auto` (既定値) は、指定されたモデルの最適な品質を自動的に選択します。 - `high`、 `medium` 、および `low` は、 `gpt-image-1` シリーズモデルでサポートされています。 - `hd` `standard`では、`dall-e-3`がサポートされています。 - `standard` は、 `dall-e-2`の唯一のオプションです。可能な値: `standard`、 `hd`、 `low`、 `medium`、 `high`、 `auto`	いいえ
response_format	列挙型	`dall-e-2`と`dall-e-3`を含む生成されたイメージが返される形式。 `url`か`b64_json`のどちらかに違いない。 URL は、イメージが生成されてから 60 分間のみ有効です。このパラメータは、常にbase64エンコード画像を返す `gpt-image-1`シリーズモデルにはサポートされていません。可能な値: `url`、 `b64_json`	いいえ
サイズ	列挙型	生成される画像のサイズ。 `1024x1024` シリーズモデルの場合は、`1536x1024`、`1024x1536` (横)、`auto` (縦)、または`gpt-image-1` (既定値) のいずれか、`256x256`の`512x512`、`1024x1024`、または`dall-e-2`のいずれか、および`1024x1024`の`1792x1024`、`1024x1792`、または`dall-e-3`のいずれかである必要があります。可能な値: `auto`、 `1024x1024`、 `1536x1024`、 `1024x1536`、 `256x256`、 `512x512`、 `1792x1024`、 `1024x1792`	いいえ
スタイル	列挙型	生成された画像のスタイル。このパラメータは `dall-e-3`のみサポートされています。 `vivid`か`natural`のどちらかに違いない。鮮やかなモデルは、超リアルで劇的な画像の生成に傾く原因となります。自然なモデルは、より自然で、より少ないハイパーリアルな画像を生成します。可能な値: `vivid`、 `natural`	いいえ
ユーザー	文字列	エンドユーザーを表す一意の識別子で、OpenAIが悪用を監視・検出するのに役立ちます。	いいえ

応答

ステータスコード: 200

説明: 要求は成功しました。

Content-Type	型	説明
application/json	AzureImagesResponse

ステータスコード: デフォルト

説明: 予期しないエラー応答。

Content-Type	型	説明
application/json	AzureErrorResponse

例

プロンプトを与えられた画像を作成します。

POST {endpoint}/openai/v1/images/generations?api-version=preview

{
 "model": "dall-e-3",
 "prompt": "In the style of WordArt, Microsoft Clippy wearing a cowboy hat.",
 "n": 1,
 "style": "natural",
 "quality": "standard"
}

回答:ステータスコード:200

{
  "body": {
    "created": 1698342300,
    "data": [
      {
        "revised_prompt": "A vivid, natural representation of Microsoft Clippy wearing a cowboy hat.",
        "prompt_filter_results": {
          "sexual": {
            "severity": "safe",
            "filtered": false
          },
          "violence": {
            "severity": "safe",
            "filtered": false
          },
          "hate": {
            "severity": "safe",
            "filtered": false
          },
          "self_harm": {
            "severity": "safe",
            "filtered": false
          },
          "profanity": {
            "detected": false,
            "filtered": false
          },
          "custom_blocklists": {
            "filtered": false,
            "details": []
          }
        },
        "url": "https://dalletipusw2.blob.core.windows.net/private/images/e5451cc6-b1ad-4747-bd46-b89a3a3b8bc3/generated_00.png?se=2023-10-27T17%3A45%3A09Z&...",
        "content_filter_results": {
          "sexual": {
            "severity": "safe",
            "filtered": false
          },
          "violence": {
            "severity": "safe",
            "filtered": false
          },
          "hate": {
            "severity": "safe",
            "filtered": false
          },
          "self_harm": {
            "severity": "safe",
            "filtered": false
          }
        }
      }
    ]
  }
}

ビデオ生成ジョブ - 作成

POST {endpoint}/openai/v1/video/generations/jobs?api-version=preview

新しいビデオ生成ジョブを作成します。

URI パラメーター

名前	インチ	必須	タイプ	説明
エンドポイント	パス	はい	文字列 Url	OpenAI Azureエンドポイント(プロトコルおよびホスト名、例:`https://aoairesource.openai.azure.com`)に対応しています。「aoairesource」をAzure OpenAIリソース名に置き換えてください。 https://{your-resource-name}.openai.azure.com
api-version	クエリ	いいえ		この要求に使用する明示的な Foundry Models API バージョン。 `v1` それ以外の場合は〗。

要求ヘッダー

トークンベースの認証かAPIキーのいずれかを使ってください。トークンベースの認証を用いることが推奨され、より安全です。

名前	必須	タイプ	説明
承認	True	文字列	例：`Authorization: Bearer {Azure_OpenAI_Auth_Token}` 認証トークンを生成するにはAzure CLI: `az account get-access-token --resource https://cognitiveservices.azure.com` 型: oauth2 認証URL: `https://login.microsoftonline.com/common/oauth2/v2.0/authorize` 範囲: `https://ai.azure.com/.default`
api-key	True	文字列	ここにAzure OpenAI API キーを提供してください

要求本文

コンテンツタイプ: アプリケーション/json

名前	タイプ	説明	必須	既定
高さ	整数	ビデオの高さ。 480x480、854x480、720x720、1280x720、1080x1080、1920x1080 の各寸法が、横向きと縦向きの両方でサポートされています。	はい
モデル	文字列	この要求に使用するデプロイの名前。	はい
n_seconds	整数	ビデオ生成ジョブの期間。 1 ~ 20 秒の間である必要があります。	いいえ	5
n_variants	整数	このジョブのバリエーションとして作成するビデオの数。 1 から 5 の間である必要があります。寸法が小さいほど、より多くのバリアントが可能になります。	いいえ	1
ダイアログを表示する	文字列	このビデオ生成ジョブのプロンプト。	はい
幅	整数	ビデオの幅。 480x480、854x480、720x720、1280x720、1080x1080、1920x1080 の各寸法が、横向きと縦向きの両方でサポートされています。	はい

要求本文

Content-Type: マルチパート/フォームデータ

名前	タイプ	説明	必須	既定
ファイル	アレイ		はい
高さ	整数	ビデオの高さ。 480x480、854x480、720x720、1280x720、1080x1080、1920x1080 の各寸法が、横向きと縦向きの両方でサポートされています。	はい
inpaint_items	アレイ	このビデオ生成ジョブのオプションのインペイント項目。	いいえ
モデル	文字列	この要求に使用するデプロイの名前。	はい
n_seconds	整数	ビデオ生成ジョブの期間。 1 ~ 20 秒の間である必要があります。	いいえ	5
n_variants	整数	このジョブのバリエーションとして作成するビデオの数。 1 から 5 の間である必要があります。寸法が小さいほど、より多くのバリアントが可能になります。	いいえ	1
ダイアログを表示する	文字列	このビデオ生成ジョブのプロンプト。	はい
幅	整数	ビデオの幅。 480x480、854x480、720x720、1280x720、1080x1080、1920x1080 の各寸法が、横向きと縦向きの両方でサポートされています。	はい

応答

ステータスコード: 200

説明: 要求は成功しました。

Content-Type	型	説明
application/json	VideoGenerationJob

ステータスコード: デフォルト

説明: 予期しないエラー応答。

Content-Type	型	説明
application/json	AzureOpenAIVideoGenerationErrorResponse

例

ファイルの例が見つかりません: ./examples/create_video_generation_job_simple.json

ビデオ生成ジョブ - リスト

GET {endpoint}/openai/v1/video/generations/jobs?api-version=preview

ビデオ生成ジョブを一覧表示します。

URI パラメーター

名前	インチ	必須	タイプ	説明
エンドポイント	パス	はい	文字列 Url	OpenAI Azureエンドポイント(プロトコルおよびホスト名、例:`https://aoairesource.openai.azure.com`)に対応しています。「aoairesource」をAzure OpenAIリソース名に置き換えてください。 https://{your-resource-name}.openai.azure.com
api-version	クエリ	いいえ		この要求に使用する明示的な Foundry Models API バージョン。 `v1` それ以外の場合は〗。
以前は	クエリ	いいえ	文字列
後	クエリ	いいえ	文字列
制限	クエリ	はい	整数
ステータス	クエリ	いいえ	アレイ

要求ヘッダー

トークンベースの認証かAPIキーのいずれかを使ってください。トークンベースの認証を用いることが推奨され、より安全です。

名前	必須	タイプ	説明
承認	True	文字列	例：`Authorization: Bearer {Azure_OpenAI_Auth_Token}` 認証トークンを生成するにはAzure CLI: `az account get-access-token --resource https://cognitiveservices.azure.com` 型: oauth2 認証URL: `https://login.microsoftonline.com/common/oauth2/v2.0/authorize` 範囲: `https://ai.azure.com/.default`
api-key	True	文字列	ここにAzure OpenAI API キーを提供してください

応答

ステータスコード: 200

説明: 要求は成功しました。

Content-Type	型	説明
application/json	VideoGenerationJobList

ステータスコード: デフォルト

説明: 予期しないエラー応答。

Content-Type	型	説明
application/json	AzureOpenAIVideoGenerationErrorResponse

例

ファイルの例が見つかりません: ./examples/get_video_generation_job_list.json

ビデオ生成ジョブ - 取得

GET {endpoint}/openai/v1/video/generations/jobs/{job-id}?api-version=preview

ビデオ生成ジョブのプロパティを取得します。

URI パラメーター

名前	インチ	必須	タイプ	説明
エンドポイント	パス	はい	文字列 Url	OpenAI Azureエンドポイント(プロトコルおよびホスト名、例:`https://aoairesource.openai.azure.com`)に対応しています。「aoairesource」をAzure OpenAIリソース名に置き換えてください。 https://{your-resource-name}.openai.azure.com
api-version	クエリ	いいえ		この要求に使用する明示的な Foundry Models API バージョン。 `v1` それ以外の場合は〗。
job-id	パス	はい	文字列	Azure OpenAI 要求に使用するビデオ生成ジョブの ID。

要求ヘッダー

トークンベースの認証かAPIキーのいずれかを使ってください。トークンベースの認証を用いることが推奨され、より安全です。

名前	必須	タイプ	説明
承認	True	文字列	例：`Authorization: Bearer {Azure_OpenAI_Auth_Token}` 認証トークンを生成するにはAzure CLI: `az account get-access-token --resource https://cognitiveservices.azure.com` 型: oauth2 認証URL: `https://login.microsoftonline.com/common/oauth2/v2.0/authorize` 範囲: `https://ai.azure.com/.default`
api-key	True	文字列	ここにAzure OpenAI API キーを提供してください

応答

ステータスコード: 200

説明: 要求は成功しました。

Content-Type	型	説明
application/json	VideoGenerationJob

ステータスコード: デフォルト

説明: 予期しないエラー応答。

Content-Type	型	説明
application/json	AzureOpenAIVideoGenerationErrorResponse

例

ファイルの例が見つかりません: ./examples/get_video_generation_job.json

ビデオ生成ジョブ - 削除

DELETE {endpoint}/openai/v1/video/generations/jobs/{job-id}?api-version=preview

ビデオ生成ジョブを削除します。

URI パラメーター

名前	インチ	必須	タイプ	説明
エンドポイント	パス	はい	文字列 Url	OpenAI Azureエンドポイント(プロトコルおよびホスト名、例:`https://aoairesource.openai.azure.com`)に対応しています。「aoairesource」をAzure OpenAIリソース名に置き換えてください。 https://{your-resource-name}.openai.azure.com
api-version	クエリ	いいえ		この要求に使用する明示的な Foundry Models API バージョン。 `v1` それ以外の場合は〗。
job-id	パス	はい	文字列	Azure OpenAI 要求に使用するビデオ生成ジョブの ID。

要求ヘッダー

トークンベースの認証かAPIキーのいずれかを使ってください。トークンベースの認証を用いることが推奨され、より安全です。

名前	必須	タイプ	説明
承認	True	文字列	例：`Authorization: Bearer {Azure_OpenAI_Auth_Token}` 認証トークンを生成するにはAzure CLI: `az account get-access-token --resource https://cognitiveservices.azure.com` 型: oauth2 認証URL: `https://login.microsoftonline.com/common/oauth2/v2.0/authorize` 範囲: `https://ai.azure.com/.default`
api-key	True	文字列	ここにAzure OpenAI API キーを提供してください

応答

ステータスコード: 204

説明: この要求に送信するコンテンツはありませんが、ヘッダーが役立つ場合があります。

ステータスコード: デフォルト

説明: 予期しないエラー応答。

Content-Type	型	説明
application/json	AzureOpenAIVideoGenerationErrorResponse

ビデオの世代 - 取得

GET {endpoint}/openai/v1/video/generations/{generation-id}?api-version=preview

ID でビデオ生成を取得します。

URI パラメーター

名前	インチ	必須	タイプ	説明
エンドポイント	パス	はい	文字列 Url	OpenAI Azureエンドポイント(プロトコルおよびホスト名、例:`https://aoairesource.openai.azure.com`)に対応しています。「aoairesource」をAzure OpenAIリソース名に置き換えてください。 https://{your-resource-name}.openai.azure.com
api-version	クエリ	いいえ		この要求に使用する明示的な Foundry Models API バージョン。 `v1` それ以外の場合は〗。
generation-id	パス	はい	文字列	Azure OpenAI 要求に使用するビデオ生成の ID。

要求ヘッダー

トークンベースの認証かAPIキーのいずれかを使ってください。トークンベースの認証を用いることが推奨され、より安全です。

名前	必須	タイプ	説明
承認	True	文字列	例：`Authorization: Bearer {Azure_OpenAI_Auth_Token}` 認証トークンを生成するにはAzure CLI: `az account get-access-token --resource https://cognitiveservices.azure.com` 型: oauth2 認証URL: `https://login.microsoftonline.com/common/oauth2/v2.0/authorize` 範囲: `https://ai.azure.com/.default`
api-key	True	文字列	ここにAzure OpenAI API キーを提供してください

応答

ステータスコード: 200

説明: 要求は成功しました。

Content-Type	型	説明
application/json	VideoGeneration

ステータスコード: デフォルト

説明: 予期しないエラー応答。

Content-Type	型	説明
application/json	AzureOpenAIVideoGenerationErrorResponse

例

ファイルの例が見つかりません: ./examples/get_video_generation.json

ビデオの生成 - サムネイルを取得する

GET {endpoint}/openai/v1/video/generations/{generation-id}/content/thumbnail?api-version=preview

生成されたビデオコンテンツのサムネイルを取得します。

URI パラメーター

名前	インチ	必須	タイプ	説明
エンドポイント	パス	はい	文字列 Url	OpenAI Azureエンドポイント(プロトコルおよびホスト名、例:`https://aoairesource.openai.azure.com`)に対応しています。「aoairesource」をAzure OpenAIリソース名に置き換えてください。 https://{your-resource-name}.openai.azure.com
api-version	クエリ	いいえ		この要求に使用する明示的な Foundry Models API バージョン。 `v1` それ以外の場合は〗。
generation-id	パス	はい	文字列	Azure OpenAI 要求に使用するビデオ生成の ID。

要求ヘッダー

トークンベースの認証かAPIキーのいずれかを使ってください。トークンベースの認証を用いることが推奨され、より安全です。

名前	必須	タイプ	説明
承認	True	文字列	例：`Authorization: Bearer {Azure_OpenAI_Auth_Token}` 認証トークンを生成するにはAzure CLI: `az account get-access-token --resource https://cognitiveservices.azure.com` 型: oauth2 認証URL: `https://login.microsoftonline.com/common/oauth2/v2.0/authorize` 範囲: `https://ai.azure.com/.default`
api-key	True	文字列	ここにAzure OpenAI API キーを提供してください

応答

ステータスコード: 200

説明: 要求は成功しました。

Content-Type	型	説明
image/jpg	文字列

ステータスコード: デフォルト

説明: 予期しないエラー応答。

Content-Type	型	説明
application/json	AzureOpenAIVideoGenerationErrorResponse

ビデオ生成 - ビデオコンテンツを取得する

GET {endpoint}/openai/v1/video/generations/{generation-id}/content/video?api-version=preview

生成されたビデオコンテンツを取得します。

URI パラメーター

名前	インチ	必須	タイプ	説明
エンドポイント	パス	はい	文字列 Url	OpenAI Azureエンドポイント(プロトコルおよびホスト名、例:`https://aoairesource.openai.azure.com`)に対応しています。「aoairesource」をAzure OpenAIリソース名に置き換えてください。 https://{your-resource-name}.openai.azure.com
api-version	クエリ	いいえ		この要求に使用する明示的な Foundry Models API バージョン。 `v1` それ以外の場合は〗。
generation-id	パス	はい	文字列	Azure OpenAI 要求に使用するビデオ生成の ID。
品質	クエリ	いいえ

要求ヘッダー

トークンベースの認証かAPIキーのいずれかを使ってください。トークンベースの認証を用いることが推奨され、より安全です。

名前	必須	タイプ	説明
承認	True	文字列	例：`Authorization: Bearer {Azure_OpenAI_Auth_Token}` 認証トークンを生成するにはAzure CLI: `az account get-access-token --resource https://cognitiveservices.azure.com` 型: oauth2 認証URL: `https://login.microsoftonline.com/common/oauth2/v2.0/authorize` 範囲: `https://ai.azure.com/.default`
api-key	True	文字列	ここにAzure OpenAI API キーを提供してください

応答

ステータスコード: 200

説明: 要求は成功しました。

Content-Type	型	説明
video/mp4	文字列

ステータスコード: デフォルト

説明: 予期しないエラー応答。

Content-Type	型	説明
application/json	AzureOpenAIVideoGenerationErrorResponse

ビデオ生成 - videocontent ヘッダーのみを取得する

HEAD {endpoint}/openai/v1/video/generations/{generation-id}/content/video?api-version=preview

生成されたビデオコンテンツのヘッダーを取得します。

URI パラメーター

名前	インチ	必須	タイプ	説明
エンドポイント	パス	はい	文字列 Url	OpenAI Azureエンドポイント(プロトコルおよびホスト名、例:`https://aoairesource.openai.azure.com`)に対応しています。「aoairesource」をAzure OpenAIリソース名に置き換えてください。 https://{your-resource-name}.openai.azure.com
api-version	クエリ	いいえ		この要求に使用する明示的な Foundry Models API バージョン。 `v1` それ以外の場合は〗。
generation-id	パス	はい	文字列	Azure OpenAI 要求に使用するビデオ生成の ID。
品質	クエリ	いいえ

要求ヘッダー

トークンベースの認証かAPIキーのいずれかを使ってください。トークンベースの認証を用いることが推奨され、より安全です。

名前	必須	タイプ	説明
承認	True	文字列	例：`Authorization: Bearer {Azure_OpenAI_Auth_Token}` 認証トークンを生成するにはAzure CLI: `az account get-access-token --resource https://cognitiveservices.azure.com` 型: oauth2 認証URL: `https://login.microsoftonline.com/common/oauth2/v2.0/authorize` 範囲: `https://ai.azure.com/.default`
api-key	True	文字列	ここにAzure OpenAI API キーを提供してください

応答

ステータスコード: 200

説明: 要求は成功しました。

ステータスコード: デフォルト

説明: 予期しないエラー応答。

Content-Type	型	説明
application/json	AzureOpenAIVideoGenerationErrorResponse

コンポーネント

チャット、入力候補、埋め込み、応答、その他のテキスト操作で使用されるスキーマ定義については、OpenAI REST API リファレンスAzureを参照してください。次のスキーマは、このページの画像、オーディオ、ビデオの操作をサポートしています。

AzureAudioTranscriptionResponse

音声を書き込まれたテキストに文字起こしする操作の結果情報。

名前	タイプ	説明	必須
期間	数	付随する文字起こし情報を生成するために処理されたオーディオの合計時間。	いいえ
言語	文字列	文字起こしされたオーディオデータで検出された音声言語。これは、'en' や 'fr' などの 2 文字の ISO-639-1 言語コードとして表されます。	いいえ
セグメント	アレイ	処理された各オーディオセグメントのタイミング、確率、およびその他の詳細に関する情報のコレクション。	いいえ
タスク	オブジェクト	使用可能なオーディオ操作応答に使用できる記述子を定義します。	いいえ
SMS 送信	文字列	指定されたオーディオデータの文字起こしされたテキスト。	はい
言葉	アレイ	処理された各単語のタイミングに関する情報のコレクション。	いいえ

AzureAudioTranslationResponse

音声を書き込みテキストに翻訳した操作の結果情報。

名前	タイプ	説明	必須
期間	数	付随する翻訳情報を生成するために処理されたオーディオの合計期間。	いいえ
言語	文字列	翻訳されたオーディオデータで検出された音声言語。これは、'en' や 'fr' などの 2 文字の ISO-639-1 言語コードとして表されます。	いいえ
セグメント	アレイ	処理された各オーディオセグメントのタイミング、確率、およびその他の詳細に関する情報のコレクション。	いいえ
タスク	オブジェクト	使用可能なオーディオ操作応答に使用できる記述子を定義します。	いいえ
SMS 送信	文字列	指定されたオーディオデータの翻訳されたテキスト。	はい

AzureErrorResponse

名前	タイプ	説明	必須
エラー	オブジェクト	エラーの詳細。	いいえ
└─ コード	文字列	エラーの個別のマシン生成識別子。	いいえ
└─ 内部エラー			いいえ
└─ メッセージ	文字列	エラーに関連付けられた人間が判読できるメッセージ。	いいえ
└─ パラメータ	文字列	該当する場合は、エラーに関連付けられている要求入力パラメーター	いいえ
└─ 型	列挙型	オブジェクトの種類。常に 'error.' です。可能な値: `error`	いいえ

AzureImagesResponse

名前	タイプ	説明	必須
バックグラウンド	列挙型	GPT-image-1 のみ: イメージ生成に使用されるバックグラウンドパラメーター。 `transparent`か`opaque`のどちらかです。可能な値: `transparent`、 `opaque`	いいえ
作成	整数	イメージが作成されたときの Unix タイムスタンプ (秒単位)。	はい
データ	アレイ		いいえ
output_format	列挙型	イメージ生成の出力形式。 `png`、`webp`、または`jpeg`。可能な値: `png`、 `webp`、 `jpeg`	いいえ
品質	列挙型	生成されたイメージの品質。 `low`、`medium`、または`high`。可能な値: `low`、 `medium`、 `high`	いいえ
サイズ	列挙型	生成されたイメージのサイズ。 `1024x1024`、`1024x1536`、または`1536x1024`。可能な値: `1024x1024`、 `1024x1536`、 `1536x1024`	いいえ
使用	オブジェクト	`gpt-image-1` シリーズモデルの場合のみ、イメージ生成のトークン使用状況情報。	いいえ
└─ インプットトークン	整数	入力プロンプトのトークン (イメージとテキスト) の数。	いいえ
└─ 入力トークンの詳細	オブジェクト	入力トークンは、イメージ生成の詳細情報を取得します。	いいえ
└─ 画像トークン	整数	入力プロンプトのイメージトークンの数。	いいえ
└─ テキストトークン	整数	入力プロンプトのテキストトークンの数。	いいえ
└─ 出力トークン	整数	出力イメージ内のイメージトークンの数。	いいえ
└─ 合計トークン	整数	イメージの生成に使用されるトークン (イメージとテキスト) の合計数。	いいえ

AzureOpenAIVideoGenerationErrorResponse

名前	タイプ	説明	必須
コード	文字列	エラーの個別のマシン生成識別子。	いいえ
inner_error	オブジェクト	該当する場合は、このエラーを発生させたアップストリームエラー。	いいえ
└─ コード	列挙型	内部エラーに関連付けられているコード。可能な値: `ResponsibleAIPolicyViolation`	いいえ
└─ エラーの詳細		内部エラーに関連付けられているコンテンツフィルターの結果の詳細。	いいえ
└─ 改訂されたプロンプト	文字列	該当する場合は、生成に使用される変更されたプロンプト。	いいえ
メッセージ	文字列	エラーに関連付けられた人間が判読できるメッセージ。	いいえ
Param	文字列	該当する場合は、エラーに関連付けられている要求入力パラメーター	いいえ
型	文字列	該当する場合は、エラーに関連付けられた入力行番号。	いいえ

VideoGeneration

ビデオ生成の結果。

名前	タイプ	説明	必須
Created_at	整数	ビデオ生成が作成された時刻。	はい
高さ	整数	ビデオの高さ。	はい
Id	文字列	ビデオ生成の ID。	はい
job_id	文字列	このビデオのビデオ生成ジョブの ID。	はい
n_seconds	整数	ビデオ生成の期間。	はい
オブジェクト	列挙型	可能な値: `video.generation`	はい
ダイアログを表示する	文字列	このビデオ生成のプロンプト。	はい
幅	整数	ビデオの幅。	はい

VideoGenerationJob

ビデオ生成ジョブ。

名前	タイプ	説明	必須
Created_at	整数	ジョブが作成された時刻。	はい
expires_at	整数	ジョブがサービスから自動的に削除される時刻。データの損失を防ぐために、ジョブのビデオコンテンツとメタデータは、この日付より前に保存する必要があります。	いいえ
failure_reason	string (以下の有効なモデルを参照)		いいえ
finished_at	整数	ジョブがすべてのビデオ世代で終了した時刻。	いいえ
世代	アレイ	このジョブ用に生成されたビデオ。数値は、特定のn_variantsと世代の作成成功によって異なります。	いいえ
高さ	整数	ビデオの高さ。	はい
Id	文字列	仕事の本質。	はい
inpaint_items	アレイ	このビデオ生成ジョブのオプションのインペイント項目。	いいえ
モデル	文字列	このビデオ生成ジョブに使用するデプロイの名前。	はい
n_seconds	整数	ビデオ生成ジョブの期間。	はい
n_variants	整数	このビデオ生成ジョブのバリエーションとして作成するビデオの数。	はい
オブジェクト	列挙型	可能な値: `video.generation.job`	はい
ダイアログを表示する	文字列	このビデオ生成ジョブのプロンプト。	はい
状態	オブジェクト	ビデオ生成ジョブの状態。	はい
幅	整数	ビデオの高さ。	はい

VideoGenerationJobList

ビデオ生成ジョブの一覧。

名前	タイプ	説明	必須
データ	アレイ	ビデオ生成ジョブの一覧。	はい
first_id	文字列	現在のページの最初のジョブの ID (使用可能な場合)。	いいえ
has_more	ブール	リストの後に使用可能なジョブが増えるかどうかを示すフラグ。	はい
last_id	文字列	現在のページの最後のジョブの ID (使用可能な場合)。	いいえ
オブジェクト	列挙型	可能な値: `list`	はい

次の手順

REST API を使用したモデルと微調整について説明します。 OpenAI をAzureする基になるモデルの詳細について説明します。

フィードバック

このページはお役に立ちましたか?

最終更新: 2026-06-24

Azure OpenAI イメージ、オーディオ、およびビデオ REST API リファレンス (v1 プレビュー)

データプレーン推論

音声を作成する

URI パラメーター

要求ヘッダー

要求本文

応答

例

例

文字起こしを作成する

URI パラメーター

要求ヘッダー

要求本文

応答

例

例

翻訳の作成

URI パラメーター

要求ヘッダー

要求本文

応答

例

例

イメージの編集を作成する

URI パラメーター

要求ヘッダー

要求本文

応答

Createimage

URI パラメーター

要求ヘッダー

要求本文

応答

例

例

ビデオ生成ジョブ - 作成

URI パラメーター

要求ヘッダー

要求本文

要求本文

応答

例

ビデオ生成ジョブ - リスト

URI パラメーター

要求ヘッダー

応答

例

ビデオ生成ジョブ - 取得

URI パラメーター

要求ヘッダー

応答

例

ビデオ生成ジョブ - 削除

URI パラメーター

要求ヘッダー

応答

ビデオの世代 - 取得

URI パラメーター

要求ヘッダー

応答

例

ビデオの生成 - サムネイルを取得する

URI パラメーター

要求ヘッダー

応答

ビデオ生成 - ビデオ コンテンツを取得する

URI パラメーター

要求ヘッダー

応答

ビデオ生成 - videocontent ヘッダーのみを取得する

URI パラメーター

要求ヘッダー

応答

コンポーネント

AzureAudioTranscriptionResponse

AzureAudioTranslationResponse

AzureErrorResponse

AzureImagesResponse

AzureOpenAIVideoGenerationErrorResponse

VideoGeneration

ビデオ生成 - ビデオコンテンツを取得する