> ## Documentation Index
> Fetch the complete documentation index at: https://docs.acedata.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# HappyHorse Tasks API の接続と使用

> HappyHorse Video API guide - Ace Data Cloud

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

## 申請プロセス

HappyHorse Videos API を使用するには、まず [Ace Data Cloud コンソール](https://platform.acedata.cloud/console/applications) で API トークンを取得し、保管してください。

![](https://cdn.acedata.cloud/dvc3cg.jpg)

まだログインまたは登録していない場合は、自動的にログインページにリダイレクトされ、登録とログインを促されます。完了後、現在のページに自動的に戻ります。

**1つの API トークンでプラットフォームのすべてのサービスを呼び出すことができ、各サービスごとに個別に申請する必要はありません。** 初回申請時には無料のクレジットが付与され、無料で体験できます。クレジットが不足した場合は、[コンソール](https://platform.acedata.cloud/console/coin) で共通残高をチャージできます。

> 📘 完全なドキュメント：[HappyHorse Videos API →](https://platform.acedata.cloud/documents/happyhorse-videos)

## リクエスト例

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

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

**リクエストヘッダー** には以下が含まれます：

* `accept`：JSON形式のレスポンス結果を受け取ることを指定し、ここには `application/json` を記入します。
* `authorization`：APIを呼び出すためのキーで、申請後に直接ドロップダウンから選択できます。

**リクエストボディ** には以下が含まれます：

* `id`：照会するタスクのID。
* `action`：タスクの操作方法、単一の照会の場合は `retrieve` を記入します。

### CURL コード例

```bash theme={null}
curl -X POST 'https://api.acedata.cloud/happyhorse/tasks' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "id": "b8976e18-32dc-4718-9ed8-1ea090fcb6ea",
  "action": "retrieve"
}'
```

### レスポンス例

リクエストが成功すると、API はそのタスクの詳細を返します。`request` フィールドはタスク作成時のリクエストボディで、`response` フィールドはタスク完了後に返されるレスポンスボディです。例えば：

```json theme={null}
{
  "id": "b8976e18-32dc-4718-9ed8-1ea090fcb6ea",
  "started_at": 1769262721.823,
  "finished_at": 1769262774.423,
  "elapsed": 52.6,
  "request": {
    "action": "generate",
    "model": "happyhorse-1.1-t2v",
    "prompt": "月明かりのビーチを走る白馬のシネマティックショット",
    "resolution": "720P",
    "duration": 5
  },
  "type": "videos",
  "response": {
    "success": true,
    "task_id": "b8976e18-32dc-4718-9ed8-1ea090fcb6ea",
    "trace_id": "fb751e1e-4705-49ea-9fd4-5024b7865ea2",
    "data": [
      {
        "id": "1469cfc3-3004-4d9e-ab10-xxxxxx",
        "video_url": "https://cdn.acedata.cloud/happyhorse/c8cbf53aa0.mp4",
        "state": "succeeded",
        "duration": 5,
        "resolution": "720P",
        "ratio": "16:9"
      }
    ]
  }
}
```

フィールドの説明は以下の通りです：

* `id`：生成タスクのIDで、今回の生成タスクを一意に識別します。
* `request`：タスク作成時のリクエスト情報。
* `response`：タスクの現在または最終的な返答情報。
* `created_at`：タスク作成時間、Unix タイムスタンプ（秒、浮動小数点）。
* `started_at`：タスク開始実行時間、Unix タイムスタンプ（秒、浮動小数点）。
* `finished_at`：タスク完了時間、Unix タイムスタンプ（秒、浮動小数点）。タスクが未完了の場合はこのフィールドは返されません。
* `elapsed`：タスク実行にかかった時間、単位は秒（浮動小数点、3桁の小数点以下）。タスクが未完了の場合はこのフィールドは返されません。

## バッチ照会操作

複数のタスクIDのタスク詳細を照会する場合、`action` を `retrieve_batch` に設定し、`ids` でタスクIDの配列を渡します：

```bash theme={null}
curl -X POST 'https://api.acedata.cloud/happyhorse/tasks' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "ids": ["b8976e18-32dc-4718-9ed8-1ea090fcb6ea"],
  "action": "retrieve_batch"
}'
```

返される結果には `items` と `count` フィールドが含まれ、`items` はタスク詳細の配列、`count` は今回マッチしたタスクの数です。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.