メインコンテンツへスキップ
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 を記入します。