Skip to main content
Gemini Tasks API の主な機能は、Gemini Videos Generation API によって生成されたタスク ID を入力することで、そのタスクの実行状況を照会することです。 この記事では、Gemini Tasks API の対接説明を詳しく紹介し、Gemini Videos Generation API のタスク実行状況を簡単に統合して照会できるようにします。

申請プロセス

Gemini Videos Generation API を使用するには、まず Ace Data Cloud コンソール で API トークンを取得し、保管してください。 まだログインまたは登録していない場合は、自動的にログインページにリダイレクトされ、登録とログインを促されます。完了後、現在のページに自動的に戻ります。 1つの API トークンでプラットフォームのすべてのサービスを呼び出すことができ、各サービスごとに個別に申請する必要はありません。 初回申請時には無料枠が付与され、無料で体験できます。枠が不足した場合は、コンソール で共通残高をチャージできます。
📘 完全なドキュメント:Gemini Videos Generation API →

リクエスト例

Gemini Tasks API は、Gemini Videos Generation API の結果を照会するために使用できます。

リクエストヘッダーとリクエストボディの設定

リクエストヘッダー には以下が含まれます:
  • accept:JSON形式のレスポンス結果を受け取ることを指定し、ここには application/json を記入します。
  • authorization:APIを呼び出すためのキーで、申請後に直接ドロップダウンから選択できます。
リクエストボディ には以下が含まれます:
  • id:照会するタスク ID。
  • action:タスクの操作方法、単一照会の場合は retrieve を記入します。

CURL コード例

レスポンス例

リクエストが成功すると、API はこのタスクの詳細情報を返します。ここでの request フィールドはタスク発起時のリクエストボディ、response フィールドはタスク完了後に返されるレスポンスボディです。例えば:
フィールドの説明は以下の通りです:
  • id:生成タスクの ID、今回の生成タスクを一意に識別するために使用されます。
  • request:タスク内のリクエスト情報。
  • response:タスク内の返却情報。
  • created_at:タスク作成時間、Unix タイムスタンプ(秒、浮動小数点)。
  • started_at:タスク開始実行時間、Unix タイムスタンプ(秒、浮動小数点)。
  • finished_at:タスク完了時間、Unix タイムスタンプ(秒、浮動小数点)。タスクが未完了の場合はこのフィールドは返されません。
  • elapsed:タスク実行にかかった時間、単位は秒(浮動小数点、3桁の小数点以下を保持)。タスクが未完了の場合はこのフィールドは返されません。

バッチ照会操作

複数のタスク ID のタスク詳細を照会する場合は、action を retrieve_batch に設定し、ids でタスク ID の配列を渡します: リクエストボディ には以下が含まれます:
  • ids:照会するタスク ID の配列。
  • action:タスクの操作方法、バッチ照会の場合は retrieve_batch を記入します。