Skip to main content
HappyHorse Tasks API は、HappyHorse Videos API によって作成された動画生成または編集タスクを照会するために使用されます。

​
申請プロセス

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

​
リクエスト例

HappyHorse Tasks API は、HappyHorse Videos 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の配列を渡します：
返される結果には items と count フィールドが含まれ、items はタスク詳細の配列、count は今回マッチしたタスクの数です。