この記事では、2025-04-01-preview リリースの Azure OpenAI の画像生成と音声 (音声) データ プレーン推論 REST API 操作について説明します。 チャットの完了、埋め込み、アシスタント、応答、ベクター ストア、その他すべての操作については、OpenAI REST API リファレンスAzure公式を参照してください。
API 仕様
Azure OpenAIモデルやリソースの管理とやり取りは、主に3つのAPIサーフェスに分かれています。
- コントロール プレーン
- データプレーン - オーサリング
- データプレーン - 推論
各APIサーフェス/仕様は異なるAzure OpenAIの機能セットをカプセル化しています。 各APIは独自のプレビューおよび安定版/一般公開版(GA)APIリリースを持っています。 プレビューリリースは現在、月次のリリースリズムに従う傾向があります。
Important
現在、新しいプレビュー推論APIが登場しました。 API ライフサイクルガイドで詳しくご覧ください。
| API | 最新プレビューリリース | 最新のGAリリース | Specifications | 説明 |
|---|---|---|---|---|
| コントロール プレーン | 2025-07-01-preview |
2025-06-01 |
仕様書ファイル | コントロールプレーンAPIは 、リソースの作成、 モデル展開、その他の高レベルのリソース管理タスクなどの操作に使用されます。 コントロールプレーンはまた、Azure Resource Manager、Bicep、Terraform、Azure CLIなどの機能で何が可能かも管理しています。 |
| データ プレーン | v1 preview |
v1 |
仕様書ファイル | データプレーンAPIは推論およびオーサリング操作を制御します。 |
認証
Azure OpenAIは認証のために2つの方法を提供しています。 APIキーかMicrosoft Entra IDのどちらかを使うことができます。
APIキー認証:この種の認証では、すべてのAPIリクエストに
api-keyHTTPヘッダーにAPIキーを含める必要があります。 クイックスタートは、この種の認証で通話する方法についてのガイダンスを提供します。Microsoft Entra ID authentication:Microsoft Entraトークンを使ってAPI呼び出しを認証できます。 認証トークンはリクエストの中には
Authorizationヘッダーとして含まれています。 提供されるトークンの前にBearerが必ず付き、例えばBearer YOUR_AUTH_TOKEN。 Microsoft Entra ID<>でのauthenticating の使い方ガイドをお読みいただけます。
REST API バージョン管理
サービスAPIは api-version クエリパラメータを用いてバージョン管理されています。 すべてのバージョンはYYYY-MM-DD 日付構造に従っています。 例えば次が挙げられます。
POST https://YOUR_RESOURCE_NAME.openai.azure.com/openai/deployments/YOUR_DEPLOYMENT_NAME/chat/completions?api-version=2024-06-01
データプレーン推論
この記事の残りの部分では、Azure OpenAI データ プレーン推論仕様の 2025-04-01-preview プレビュー リリースの画像とオーディオの操作について説明します。
GA イメージとオーディオの操作については、 GA イメージとオーディオ REST API リファレンスを参照してください。
書き起こし - 作成
POST https://{endpoint}/openai/deployments/{deployment-id}/audio/transcriptions?api-version=2025-04-01-preview
音声を入力言語に書き起こします。
URI パラメーター
| 名前 | In | 必須 | タイプ | 説明 |
|---|---|---|---|---|
| エンドポイント | パス | はい | 文字列 URL | OpenAI Azureエンドポイント(プロトコルおよびホスト名、例:https://aoairesource.openai.azure.com)に対応しています。「aoairesource」をAzure OpenAIリソース名に置き換えてください。 https://{your-resource-name}.openai.azure.com |
| デプロイメント ID | パス | はい | 文字列 | |
| api-version | クエリ | はい | 文字列 |
リクエストヘッダー
トークンベースの認証かAPIキーのいずれかを使ってください。 トークンベースの認証を用いることが推奨され、より安全です。
| 名前 | 必須 | タイプ | 説明 |
|---|---|---|---|
| Authorization | 正しい | 文字列 |
例: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キー | 正しい | 文字列 | ここにAzure OpenAI API キーを提供してください |
リクエストボディ
Content-Type: マルチパート/フォームデータ
| 名前 | タイプ | 説明 | 必須 | デフォルト |
|---|---|---|---|---|
| モデル | 文字列 | 使用するモデルのIDです。 選択肢は gpt-4o-transcribe、 gpt-4o-mini-transcribe、 gpt-4o-mini-transcribe-2025-12-15、 whisper-1、 gpt-4o-transcribe-diarizeです。 |
はい | |
| ファイル | 文字列 | 音声ファイルオブジェクトを文字起こしします。 | はい | |
| 言語 | 文字列 | 入力音声の言語。 入力言語をISO-639-1形式で提供することで、精度と遅延が向上します。 | いいえ | |
| ダイアログを表示する | 文字列 | モデルのスタイルをガイドしたり、前の音声セグメントを続けるためのオプションテキスト。 プロンプトは音声言語に合っているべきです。 | いいえ | |
| response_format | audioResponseFormat | 出力のフォーマットを定義します。 | いいえ | |
| 温度 | number | サンプリング温度は0から1の間です。 0.8のような高い値は出力をよりランダムにし、0.2のように低い値はより集中して決定的になります。 0に設定された場合、モデルは対数確率を用いて特定の閾値に達するまで自動的に温度を上げます。 | いいえ | 0 |
| timestamp_granularities[] | アレイ | この文字起こしのために入力するタイムスタンプの細さ。
response_format タイムスタンプの粒度を使わせるように verbose_json 設定する必要があります。 これらの選択肢のいずれか、または両方がサポートされています: wordまたは segment。 注:セグメントタイムスタンプに追加の遅延はありませんが、ワードタイムスタンプを生成すると追加の遅延が発生します。 |
いいえ | ['segment'] |
Responses
ステータスコード: 200
説明: OK
| Content-Type(コンテンツの種類) | Type | 説明 |
|---|---|---|
| application/json | オブジェクト | |
| text/plain | 文字列 | 出力形式で文字起こしされたテキスト(response_formatが text、 vtt 、または srtのいずれかだった場合)。 |
Examples
例
提供された音声データから文字起こしテキストと関連メタデータを取得します。
POST https://{endpoint}/openai/deployments/{deployment-id}/audio/transcriptions?api-version=2025-04-01-preview
回答:ステータスコード:200
{
"body": {
"text": "A structured object when requesting json or verbose_json"
}
}
例
提供された音声データから文字起こしテキストと関連メタデータを取得します。
POST https://{endpoint}/openai/deployments/{deployment-id}/audio/transcriptions?api-version=2025-04-01-preview
"---multipart-boundary\nContent-Disposition: form-data; name=\"file\"; filename=\"file.wav\"\nContent-Type: application/octet-stream\n\nRIFF..audio.data.omitted\n---multipart-boundary--"
回答:ステータスコード:200
{
"type": "string",
"example": "plain text when requesting text, srt, or vtt"
}
翻訳 - 作成
POST https://{endpoint}/openai/deployments/{deployment-id}/audio/translations?api-version=2025-04-01-preview
入力された音声を英語テキストに書き起こし・翻訳します。
URI パラメーター
| 名前 | In | 必須 | タイプ | 説明 |
|---|---|---|---|---|
| エンドポイント | パス | はい | 文字列 URL | OpenAI Azureエンドポイント(プロトコルおよびホスト名、例:https://aoairesource.openai.azure.com)に対応しています。「aoairesource」をAzure OpenAIリソース名に置き換えてください。 https://{your-resource-name}.openai.azure.com |
| デプロイメント ID | パス | はい | 文字列 | |
| api-version | クエリ | はい | 文字列 |
リクエストヘッダー
トークンベースの認証かAPIキーのいずれかを使ってください。 トークンベースの認証を用いることが推奨され、より安全です。
| 名前 | 必須 | タイプ | 説明 |
|---|---|---|---|
| Authorization | 正しい | 文字列 |
例: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キー | 正しい | 文字列 | ここにAzure OpenAI API キーを提供してください |
リクエストボディ
Content-Type: マルチパート/フォームデータ
| 名前 | タイプ | 説明 | 必須 | デフォルト |
|---|---|---|---|---|
| ファイル | 文字列 | 翻訳用の音声ファイル。 | はい | |
| ダイアログを表示する | 文字列 | モデルのスタイルをガイドしたり、前の音声セグメントを続けるためのオプションテキスト。 プロンプトは英語で書かれるべきです。 | いいえ | |
| response_format | audioResponseFormat | 出力のフォーマットを定義します。 | いいえ | |
| 温度 | number | サンプリング温度は0から1の間です。 0.8のような高い値は出力をよりランダムにし、0.2のように低い値はより集中して決定的になります。 0に設定された場合、モデルは対数確率を用いて特定の閾値に達するまで自動的に温度を上げます。 | いいえ | 0 |
Responses
ステータスコード: 200
説明: OK
| Content-Type(コンテンツの種類) | Type | 説明 |
|---|---|---|
| application/json | オブジェクト | |
| text/plain | 文字列 | テキストがテキスト、vtt、srtのいずれかであった場合response_format出力形式で文字起こしされました。 |
Examples
例
提供された音声データから英語の文字起こしテキストと関連するメタデータを取得します。
POST https://{endpoint}/openai/deployments/{deployment-id}/audio/translations?api-version=2025-04-01-preview
"---multipart-boundary\nContent-Disposition: form-data; name=\"file\"; filename=\"file.wav\"\nContent-Type: application/octet-stream\n\nRIFF..audio.data.omitted\n---multipart-boundary--"
回答:ステータスコード:200
{
"body": {
"text": "A structured object when requesting json or verbose_json"
}
}
例
提供された音声データから英語の文字起こしテキストと関連するメタデータを取得します。
POST https://{endpoint}/openai/deployments/{deployment-id}/audio/translations?api-version=2025-04-01-preview
"---multipart-boundary\nContent-Disposition: form-data; name=\"file\"; filename=\"file.wav\"\nContent-Type: application/octet-stream\n\nRIFF..audio.data.omitted\n---multipart-boundary--"
回答:ステータスコード:200
{
"type": "string",
"example": "plain text when requesting text, srt, or vtt"
}
スピーチ - 作成
POST https://{endpoint}/openai/deployments/{deployment-id}/audio/speech?api-version=2025-04-01-preview
入力テキストから音声を生成します。
URI パラメーター
| 名前 | In | 必須 | タイプ | 説明 |
|---|---|---|---|---|
| エンドポイント | パス | はい | 文字列 URL | OpenAI Azureエンドポイント(プロトコルおよびホスト名、例:https://aoairesource.openai.azure.com)に対応しています。「aoairesource」をAzure OpenAIリソース名に置き換えてください。 https://{your-resource-name}.openai.azure.com |
| デプロイメント ID | パス | はい | 文字列 | |
| api-version | クエリ | はい | 文字列 |
リクエストヘッダー
トークンベースの認証かAPIキーのいずれかを使ってください。 トークンベースの認証を用いることが推奨され、より安全です。
| 名前 | 必須 | タイプ | 説明 |
|---|---|---|---|
| Authorization | 正しい | 文字列 |
例: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キー | 正しい | 文字列 | ここにAzure OpenAI API キーを提供してください |
リクエストボディ
Content-Type: マルチパート/フォームデータ
| 名前 | タイプ | 説明 | 必須 | デフォルト |
|---|---|---|---|---|
| 入力 | 文字列 | 音声合成のためのテキスト。 最大文字数は4,096文字です。 | はい | |
| response_format | 列挙型 | 音声を合成するためのフォーマット。 可能な値: mp3、 opus、 aac、 flac、 wav、 pcm |
いいえ | |
| 速度 | number | 合成音声の速度。
0.25から4.0の中から値を選びます。
1.0 はデフォルトです。 |
いいえ | 1.0 |
| 音声 | 列挙型 | 音声合成に使う声。 可能な値: alloy、 echo、 fable、 onyx、 nova、 shimmer |
はい |
Responses
ステータスコード: 200
説明: OK
| Content-Type(コンテンツの種類) | Type | 説明 |
|---|---|---|
| application/octet-stream | 文字列 |
Examples
例
提供されたテキストから音声を合成します。
POST https://{endpoint}/openai/deployments/{deployment-id}/audio/speech?api-version=2025-04-01-preview
{
"input": "Hi! What are you going to make?",
"voice": "fable",
"response_format": "mp3"
}
回答:ステータスコード:200
{
"body": "101010101"
}
画像生成 - 作成
POST https://{endpoint}/openai/deployments/{deployment-id}/images/generations?api-version=2025-04-01-preview
与えられた画像生成モデルの展開において、テキストキャプションから画像の一括を生成する
URI パラメーター
| 名前 | In | 必須 | タイプ | 説明 |
|---|---|---|---|---|
| エンドポイント | パス | はい | 文字列 URL | OpenAI Azureエンドポイント(プロトコルおよびホスト名、例:https://aoairesource.openai.azure.com)に対応しています。「aoairesource」をAzure OpenAIリソース名に置き換えてください。 https://{your-resource-name}.openai.azure.com |
| デプロイメント ID | パス | はい | 文字列 | |
| api-version | クエリ | はい | 文字列 |
リクエストヘッダー
トークンベースの認証かAPIキーのいずれかを使ってください。 トークンベースの認証を用いることが推奨され、より安全です。
| 名前 | 必須 | タイプ | 説明 |
|---|---|---|---|
| Authorization | 正しい | 文字列 |
例: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キー | 正しい | 文字列 | ここにAzure OpenAI API キーを提供してください |
リクエストボディ
コンテンツ タイプ: アプリケーション/json
| 名前 | タイプ | 説明 | 必須 | デフォルト |
|---|---|---|---|---|
| バックグラウンド | imageBackground | 生成画像の背景の透明度設定が可能です。 このパラメータはGPT-image-1シリーズモデルのみでサポートされています。 | いいえ | 自動 |
| n | 整数 | 生成すべき画像の数。 dall-e-3 では、n=1 のみがサポートされます。 | いいえ | 1 |
| 出力圧縮 | 整数 | 生成画像の圧縮レベル(0-100%)です。 このパラメータはjpeg出力フォーマットのgpt-image-1シリーズモデルのみに対応しています。 | いいえ | 100 |
| 出力形式 (output_format) | imagesOutputFormat | 生成された画像が返されるファイル形式。 GPT-image-1シリーズモデルのみに対応しています。 | いいえ | png |
| ダイアログを表示する | 文字列 | 目的の画像のテキスト説明。 GPT-image-1シリーズの最大長さは32,000文字、dall-e-3では4,000文字です | はい | |
| 部分的な画像 | 整数 | 生成すべき部分画像の数。 このパラメータは部分的な画像を返すストリーミング応答に使用されます。 値は0から3の間でなければなりません。 0に設定すると、1つのストリーミングイベントで送信される単一の画像が応答します。 完全な画像がより速く生成される場合、最終画像が部分画像の全数が生成される前に送信される可能性があることに注意してください。 | 0 | |
| ストリーミング | boolean | ストリーミングモードで画像を編集してください。 | いいえ | false |
| 品質 | imageQuality | 生成される画像の品質。 | いいえ | 自動 |
| response_format | imagesResponseFormat | 生成された画像が返される形式。 このパラメータは、常にbase64エンコード画像を返す gpt-image-1シリーズモデルにはサポートされていません。可能な値: url、 b64_json。 |
いいえ | url |
| size | imageSize | 生成される画像のサイズ。 | いいえ | 自動 |
| スタイル | imageStyle | 生成された画像のスタイル。 dall-e-3のみ対応しています。 | いいえ | vivid |
| ユーザー | 文字列 | エンドユーザーを表す一意の識別子であり、悪用の監視や検出に役立ちます。 | いいえ |
Responses
ステータスコード: 200
説明: OK
| Content-Type(コンテンツの種類) | Type | 説明 |
|---|---|---|
| application/json | generateImagesResponse |
ステータスコード: デフォルト
説明:エラーが発生しました。
| Content-Type(コンテンツの種類) | Type | 説明 |
|---|---|---|
| application/json | dalleErrorResponse |
Examples
例
プロンプトを与えられた画像を作成します。
POST https://{endpoint}/openai/deployments/{deployment-id}/images/generations?api-version=2025-04-01-preview
{
"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 https://{endpoint}/openai/deployments/{deployment-id}/images/edits?api-version=2025-04-01-preview
与えられたGPT-image-1モデル展開上のテキストキャプションから画像を編集します
URI パラメーター
| 名前 | In | 必須 | タイプ | 説明 |
|---|---|---|---|---|
| エンドポイント | パス | はい | 文字列 URL | OpenAI Azureエンドポイント(プロトコルおよびホスト名、例:https://aoairesource.openai.azure.com)に対応しています。「aoairesource」をAzure OpenAIリソース名に置き換えてください。 https://{your-resource-name}.openai.azure.com |
| デプロイメント ID | パス | はい | 文字列 | |
| api-version | クエリ | はい | 文字列 |
リクエストヘッダー
トークンベースの認証かAPIキーのいずれかを使ってください。 トークンベースの認証を用いることが推奨され、より安全です。
| 名前 | 必須 | タイプ | 説明 |
|---|---|---|---|
| Authorization | 正しい | 文字列 |
例: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キー | 正しい | 文字列 | ここにAzure OpenAI API キーを提供してください |
リクエストボディ
Content-Type: マルチパート/フォームデータ
| 名前 | タイプ | 説明 | 必須 | デフォルト |
|---|---|---|---|---|
| イメージ | 文字列または配列 | 編集する画像。 サポートされている画像ファイルまたは画像の配列でなければなりません。 各画像はpngファイルかjpgファイルで、50MB未満であるべきです。 | はい | |
| 入力忠実度 | 文字列 | モデルが入力画像のスタイルや特徴、特に顔の特徴にどれだけ努力をかけるかをコントロールします。 このパラメータはGPT-image-1シリーズモデルのみでサポートされています。 サポートは high と low。 |
いいえ |
low。 |
| マスク | 文字列 | 完全に透明な領域(例:アルファがゼロ)で編集すべき場所を示す追加の画像があります。 複数の画像が提供されている場合、マスクは最初の画像に適用されます。 有効なPNGファイルで、4MB未満で、画像と同じサイズでなければなりません。 | いいえ | |
| n | 整数 | 生成すべき画像の数。 1から10の間でなければなりません。 | いいえ | 1 |
| ダイアログを表示する | 文字列 | 目的の画像のテキスト説明。 最大文字数は32000文字です。 | はい | |
| 品質 | imageQuality | 生成される画像の品質。 | いいえ | 自動 |
| 部分的な画像 | 生成すべき部分画像の数。 このパラメータは部分的な画像を返すストリーミング応答に使用されます。 値は0から3の間でなければなりません。 0に設定すると、1つのストリーミングイベントで送信される単一の画像が応答します。 完全な画像がより速く生成される場合、最終画像が部分画像の全数が生成される前に送信される可能性があることに注意してください。 | |||
| ストリーミング | boolean | ストリーミングモードで画像を編集してください。 | いいえ | false |
| response_format | imagesResponseFormat | 生成された画像が返される形式。 | いいえ | url |
| size | imageSize | 生成される画像のサイズ。 | いいえ | 自動 |
| ユーザー | 文字列 | エンドユーザーを表す一意の識別子であり、悪用の監視や検出に役立ちます。 | いいえ |
Responses
ステータスコード: 200
説明: OK
| Content-Type(コンテンツの種類) | Type | 説明 |
|---|---|---|
| application/json | generateImagesResponse |
ステータスコード: デフォルト
説明:エラーが発生しました。
| Content-Type(コンテンツの種類) | Type | 説明 |
|---|---|---|
| application/json | dalleErrorResponse |
Components
チャット、入力候補、埋め込み、応答、その他のテキスト操作で使用されるスキーマ定義については、OpenAI REST API リファレンスAzureを参照してください。 次のスキーマは、このページでの画像とオーディオの操作をサポートしています。
innerErrorCode
内側のエラーオブジェクトのエラーコード。
| Property | 価値 |
|---|---|
| 説明 | 内側のエラーオブジェクトのエラーコード。 |
| Type | 文字列 |
| 値 | ResponsibleAIPolicyViolation |
dalleErrorResponse
| 名前 | タイプ | 説明 | 必須 | デフォルト |
|---|---|---|---|---|
| エラー | dalleError | いいえ |
dalleError
| 名前 | タイプ | 説明 | 必須 | デフォルト |
|---|---|---|---|---|
| inner_error | dalleInnerError | 内部の誤りに追加の詳細を加えた。 | いいえ | |
| param | 文字列 | いいえ | ||
| 型 | 文字列 | いいえ |
dalleInnerError
内部の誤りに追加の詳細を加えた。
| 名前 | タイプ | 説明 | 必須 | デフォルト |
|---|---|---|---|---|
| コード | innerErrorCode | 内側のエラーオブジェクトのエラーコード。 | いいえ | |
| content_filter_results | dalleFilterResults | コンテンツフィルタリングのカテゴリ(ヘイト、性的、暴力、self_harm)、検出されたかどうか、そして有害なコンテンツの強度やリスクレベルを決定する重症度レベル(very_low、低、中、高)およびフィルタリングの有無に関する情報。 脱獄コンテンツや罵り言葉に関する情報、検出されたかどうか、フィルタリングされているかどうか。 顧客ブロックリストの情報(フィルタリング済みか)やIDも含めて。 | いいえ | |
| 修正版プロンプト | 文字列 | 画像を生成するために使われたプロンプト、もしプロンプトに修正があったなら。 | いいえ |
contentFilterSeverityResult
| 名前 | タイプ | 説明 | 必須 | デフォルト |
|---|---|---|---|---|
| filtered | boolean | はい | ||
| severity | 文字列 | いいえ |
contentFilterDetectedResult
| 名前 | タイプ | 説明 | 必須 | デフォルト |
|---|---|---|---|---|
| detected | boolean | いいえ | ||
| filtered | boolean | はい |
contentFilterDetailedResults
コンテンツフィルタリングは、フィルタリングされたセグメントのコンテンツフィルターIDの詳細を表示します。
| 名前 | タイプ | 説明 | 必須 | デフォルト |
|---|---|---|---|---|
| details | アレイ | いいえ | ||
| filtered | boolean | はい |
dalleFilterResults
コンテンツフィルタリングのカテゴリ(ヘイト、性的、暴力、self_harm)、検出されたかどうか、そして有害なコンテンツの強度やリスクレベルを決定する重症度レベル(very_low、低、中、高)およびフィルタリングの有無に関する情報。 脱獄コンテンツや罵り言葉に関する情報、検出されたかどうか、フィルタリングされているかどうか。 顧客ブロックリストの情報(フィルタリング済みか)やIDも含めて。
| 名前 | タイプ | 説明 | 必須 | デフォルト |
|---|---|---|---|---|
| custom_blocklists | contentFilterDetailedResults | コンテンツフィルタリングは、フィルタリングされたセグメントのコンテンツフィルターIDの詳細を表示します。 | いいえ | |
| hate | contentFilterSeverityResult | いいえ | ||
| 脱獄 | contentFilterDetectedResult | いいえ | ||
| profanity | contentFilterDetectedResult | いいえ | ||
| self_harm | contentFilterSeverityResult | いいえ | ||
| 性的 | contentFilterSeverityResult | いいえ | ||
| violence | contentFilterSeverityResult | いいえ |
audioResponseFormat
出力のフォーマットを定義します。
| Property | 価値 |
|---|---|
| 説明 | 出力のフォーマットを定義します。 |
| Type | 文字列 |
| 値 | jsontextsrtverbose_jsonvtt |
imageQuality
生成される画像の品質。
| Property | 価値 |
|---|---|
| 説明 | 生成される画像の品質。 |
| Type | 文字列 |
| デフォルト | 自動 |
| 値 | autohighmediumlowhdstandard |
imagesResponseFormat
生成された画像が返される形式。
| Property | 価値 |
|---|---|
| 説明 | 生成された画像が返される形式。 |
| Type | 文字列 |
| デフォルト | url |
| 値 | urlb64_json |
imagesOutputFormat
生成された画像が返されるファイル形式。 シリーズモデルのみ対応。
| Property | 価値 |
|---|---|
| 説明 | 生成された画像が返されるファイル形式。 GPT-image-1シリーズモデルのみに対応しています。 |
| Type | 文字列 |
| デフォルト | png |
| 値 | pngjpeg |
imageSize
生成される画像のサイズ。
| Property | 価値 |
|---|---|
| 説明 | 生成される画像のサイズ。 |
| Type | 文字列 |
| デフォルト | 自動 |
| 値 | auto1792x10241024x17921024x10241024x15361536x1024 |
imageStyle
生成された画像のスタイル。 dall-e-3のみ対応しています。
| Property | 価値 |
|---|---|
| 説明 | 生成された画像のスタイル。 dall-e-3のみ対応しています。 |
| Type | 文字列 |
| デフォルト | vivid |
| 値 | vividnatural |
imageBackground
生成画像の背景の透明度設定が可能です。 このパラメータはGPT-image-1シリーズモデルのみでサポートされています。
| Property | 価値 |
|---|---|
| 説明 | 生成画像の背景の透明度設定が可能です。 このパラメータはGPT-image-1シリーズモデルのみでサポートされています。 |
| Type | 文字列 |
| デフォルト | 自動 |
| 値 | transparentopaqueauto |
generateImagesResponse
| 名前 | タイプ | 説明 | 必須 | デフォルト |
|---|---|---|---|---|
| created | 整数 | 操作が作られたUnixのタイムスタンプ。 | はい | |
| データ | アレイ | 成功した場合の操作結果データ | はい | |
| 使用 | imageGenerationsUsage | 画像生成リクエストのためのトークン使用情報を表します。 GPT-image-1シリーズモデルのみです。 | いいえ |
imageGenerationsUsage
画像生成リクエストのためのトークン使用情報を表します。 GPT-image-1シリーズモデルのみです。
| 名前 | タイプ | 説明 | 必須 | デフォルト |
|---|---|---|---|---|
| input_tokens | 整数 | 入力トークンの数。 | いいえ | |
| input_tokens_details | オブジェクト | 入力トークンの詳細な内訳です。 | いいえ | |
| └─ 画像トークン | 整数 | 画像トークンの数。 | いいえ | |
| └─ テキストトークン | 整数 | テキストトークンの数。 | いいえ | |
| output_tokens | 整数 | 出力トークンの数。 | いいえ | |
| total_tokens | 整数 | 使用されたトークンの総数。 | いいえ |
次のステップ
REST API を使用したモデルと微調整について説明します。 OpenAI をAzureする基になるモデルの詳細について説明します。