Skip to main content
Nano Banana Tasks API の主な機能は、Nano Banana Images API によって生成されたタスク ID を入力することで、そのタスクの実行状況を照会することです。 この文書では、Nano Banana Tasks API の接続説明を詳しく紹介し、簡単に統合し、この API の強力な機能を十分に活用できるようにします。Nano Banana Tasks API を使用することで、Nano Banana Images API のタスク実行状況を簡単に照会できます。

​
リクエスト例

Nano Banana Tasks API は、Nano Banana Images API の結果を照会するために使用できます。Nano Banana Images API の使用方法については、文書 Nano Banana Images API を参照してください。 Nano Banana Images API サービスから返されたタスク ID を例に、どのようにこの API を使用するかを示します。タスク ID が「4d320ead-4af4-4a55-8f3e-f2afebdf4fd0」であると仮定し、次にタスク ID を渡す方法を示します。

​
タスク例の画像

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

Request Headers には以下が含まれます：
  • accept：JSON形式のレスポンス結果を受け取ることを指定し、ここには application/json を記入します。
  • authorization：API を呼び出すためのキーで、申請後に直接選択できます。
Request Body には以下が含まれます：
  • id：アップロードされたタスク ID。
  • action：タスクの操作方法。
設定は以下の図のようになります：

​
コード例

ページの右側には、さまざまな言語のコードが自動生成されていることがわかります。以下の図のように：

一部のコード例は以下の通りです：

​
CURL

​
Python

​
レスポンス例

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

​
バッチ照会操作

これは複数のタスク ID に対してタスクの詳細を照会するもので、上記とは異なり、action を retrieve_batch に設定する必要があります。 Request Body には以下が含まれます：
  • ids：アップロードされたタスク ID の配列。
  • action：タスクの操作方法。
例は以下の通りです：

​
レスポンス例

リクエストが成功すると、API は今回のすべてのバッチタスクの具体的な詳細情報を返します。例えば：
エラー処理 APIを呼び出す際にエラーが発生した場合、APIは対応するエラーコードと情報を返します。例えば：
  • 400 token_mismatched：不正なリクエスト、パラメータが不足しているか無効である可能性があります。
  • 400 api_not_implemented：不正なリクエスト、パラメータが不足しているか無効である可能性があります。
  • 401 invalid_token：未承認、無効または不足している認証トークン。
  • 429 too_many_requests：リクエストが多すぎます、レート制限を超えました。
  • 403 forbidden：提供者のネイティブセキュリティポリシーがリクエストまたは生成結果を拒否しました；すべての生成呼び出しが拒否された場合、タスクは失敗状態で保存され、画像は含まれず、料金は発生しません。複数画像リクエストの他の成功した呼び出しは、実際の枚数に基づいて返され、料金が発生します。
  • 500 api_error：内部サーバーエラー、サーバーで何かがうまくいきませんでした。

​
エラー応答の例

​
結論

この文書を通じて、Nano Banana Tasks APIを使用して単一またはバッチタスクのすべての具体的な詳細情報を照会する方法を理解しました。この文書がAPIの接続と使用に役立つことを願っています。ご不明な点がございましたら、いつでも技術サポートチームにお問い合わせください。