モデルのエンドポイントを使用すると、使用可能なモデルをプログラムで一覧表示し、サポートされている機能やコンテキストのウィンドウ サイズなどの拡張メタデータを取得できます。詳しくは、モデルガイドをご覧ください。
メソッド: models.get
バージョン番号、トークンの上限、パラメータ、その他のメタデータなど、特定の Model
に関する情報を取得します。詳細なモデル情報については、Gemini モデルガイドをご覧ください。
エンドポイント
<ph type="x-smartling-placeholder"></ph> 入手
https://generativelanguage.googleapis.com/v1beta/{name=models/*}
パスパラメータ
name
string
必須。モデルのリソース名。
この名前は、models.list
メソッドから返されるモデル名と一致する必要があります。
形式: models/{model}
。models/{model}
の形式になります。
リクエスト本文
リクエストの本文は空にする必要があります。
リクエスト例
Python
Shell
レスポンスの本文
成功した場合、レスポンスの本文には Model
のインスタンスが含まれます。
メソッド: models.list
- エンドポイント
- クエリ パラメータ
- リクエストの本文
- レスポンスの本文
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
- 認可スコープ
- リクエストの例
<ph type="x-smartling-placeholder">
- </ph>
- リスト
Gemini API で利用可能な Model
を一覧表示します。
エンドポイント
<ph type="x-smartling-placeholder"></ph> 入手
https://generativelanguage.googleapis.com/v1beta/models
クエリ パラメータ
pageSize
integer
返される Models
の最大数(1 ページあたり)。
指定しない場合は、1 ページあたり 50 個のモデルが返されます。このメソッドは、それより大きい pageSize を渡しても、1 ページあたり最大 1, 000 個のモデルを返します。
pageToken
string
前回の models.list
呼び出しから受け取ったページトークン。
次のページを取得するには、あるリクエストで返された pageToken
を次のリクエストの引数として指定します。
ページ分割を行う場合、models.list
に指定する他のすべてのパラメータは、ページトークンを提供した呼び出しと一致する必要があります。
リクエストの本文
リクエストの本文は空にする必要があります。
リクエスト例
Python
Shell
REST リソース: models
- リソース: Model
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
- メソッド
リソース: Model
生成言語モデルに関する情報。
name
string
必須。Model
のリソース名。使用可能なすべての値については、モデル バリアントをご覧ください。
形式: models/{model}
。{model}
命名規則は次のとおりです。
- 「{baseModelId}-{version}」
例:
models/gemini-1.5-flash-001
baseModelId
string
必須。ベースモデルの名前。これを生成リクエストに渡します。
例:
gemini-1.5-flash
version
string
必須。モデルのバージョン番号。
メジャー バージョン(1.0
または 1.5
)を表します。
displayName
string
人が読める形式のモデル名。例:「Gemini 1.5 Flash」
名前は最大 128 文字で、UTF-8 文字を含めることができます。
description
string
モデルの簡単な説明。
inputTokenLimit
integer
このモデルで許可される入力トークンの最大数。
outputTokenLimit
integer
このモデルで使用できる出力トークンの最大数。
supportedGenerationMethods[]
string
モデルでサポートされている生成方法。
対応する API メソッド名は、generateMessage
や generateContent
などのパスカルケースの文字列として定義されます。
temperature
number
出力のランダム性を制御します。
値の範囲は [0.0,maxTemperature]
以上です。値が大きいほど、レスポンスのばらつきが大きくなります。また、0.0
に近い値ほど、モデルからの予想外のレスポンスが少なくなります。この値は、モデルの呼び出し中にバックエンドによって使用されるデフォルトを指定します。
maxTemperature
number
このモデルで使用できる最高温度。
topP
number
Nucleus サンプリングの場合。
核サンプリングでは、確率合計が topP
以上の最小のトークンセットが考慮されます。この値は、モデルの呼び出し中にバックエンドによって使用されるデフォルトを指定します。
topK
integer
トップ K サンプリングの場合。
トップ K サンプリングでは、最も確率が高い topK
のトークンのセットが考慮されます。この値は、モデルの呼び出し中にバックエンドによって使用されるデフォルトを指定します。空の場合、モデルがトップ K サンプリングを使用せず、topK
を生成パラメータとして使用できないことを示します。
JSON 表現 |
---|
{ "name": string, "baseModelId": string, "version": string, "displayName": string, "description": string, "inputTokenLimit": integer, "outputTokenLimit": integer, "supportedGenerationMethods": [ string ], "temperature": number, "maxTemperature": number, "topP": number, "topK": integer } |