入力 GenerateContentRequest
が与えられたときに、モデルからレスポンスを生成します。
入力機能は、チューニング済みモデルを含め、モデルによって異なります。詳細については、モデルガイドとチューニング ガイドをご覧ください。
HTTP リクエスト
POST https://generativelanguage.googleapis.com/v1beta/{model=models/*}:generateContent
この URL は gRPC Transcoding 構文を使用します。
パスパラメータ
パラメータ | |
---|---|
model |
必須。コンプリーションの生成に使用する 形式: |
リクエスト本文
リクエストの本文には、次の構造のデータが含まれます。
JSON 表現 |
---|
{ "contents": [ { object ( |
フィールド | |
---|---|
contents[] |
必須。モデルとの現在の会話の内容。 シングルターンのクエリの場合、これは単一のインスタンスです。マルチターン クエリの場合、これは会話履歴と最新のリクエストを含む繰り返しフィールドです。 |
tools[] |
省略可。モデルが次のレスポンスを生成するために使用できる
|
toolConfig |
省略可。リクエストで指定された任意の |
safetySettings[] |
省略可。安全でないコンテンツをブロックするための一意の これは |
systemInstruction |
省略可。デベロッパーが設定するシステム指示。現在はテキストのみです。 |
generationConfig |
省略可。モデルの生成と出力の構成オプション。 |
cachedContent |
省略可。予測を提供するコンテキストとして使用される、キャッシュに保存されたコンテンツの名前。注: 明示的キャッシュでのみ使用します。明示的キャッシュでは、ユーザーがキャッシュを制御(キャッシュするコンテンツなど)でき、確実な費用削減を実現できます。形式: |
レスポンスの本文
成功した場合、レスポンスの本文には GenerateContentResponse
のインスタンスが含まれます。
認可スコープ
以下のいずれかの OAuth スコープが必要です。
https://www.googleapis.com/auth/generative-language
https://www.googleapis.com/auth/generative-language.tuning
https://www.googleapis.com/auth/generative-language.tuning.readonly
https://www.googleapis.com/auth/generative-language.retriever
https://www.googleapis.com/auth/generative-language.retriever.readonly
詳細については、認証の概要をご覧ください。