SeeDance Tasks API の接続と使用

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

申請プロセス

SeeDance Video Generation API を使用するには、まず Ace Data Cloud コンソールにアクセスして、API トークンを取得し、保管してください。

まだログインまたは登録していない場合は、自動的にログインページにリダイレクトされ、登録とログインを促されます。完了後、現在のページに自動的に戻ります。 1つの API トークンでプラットフォームのすべてのサービスを呼び出すことができ、各サービスごとに個別に申請する必要はありません。 初回申請時には無料のクレジットが付与され、無料で体験できます。クレジットが不足した場合は、コンソールで一般残高をチャージできます。

📘 完全な文書：SeeDance Video Generation API →

リクエスト例

SeeDance Tasks API は、SeeDance Video Generation API の結果を照会するために使用できます。SeeDance Video Generation API の使用方法については、文書 SeeDance Video Generation API を参照してください。 SeeDance Video Generation API サービスから返されたタスクIDを例に、どのようにこの API を使用するかを示します。タスクID：20068983-0cc9-4c6a-aeb6-9c6a3c668be0 があると仮定し、次にタスクIDを渡す方法を示します。

タスク例の画像

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

Request Headers には以下が含まれます：

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

Request Body には以下が含まれます：

id：アップロードされたタスクID。
action：タスクの操作方法。

設定は以下の図のようになります：

コード例

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

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

CURL

curl -X POST 'https://api.acedata.cloud/seedance/tasks' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "id": "a6e0d456-189b-4c78-9232-2fe72166ab39",
  "action": "retrieve"
}'

レスポンス例

リクエストが成功すると、API はこのタスクの詳細情報を返します。例えば：

{
    "_id": "69480c5cff2676299c7b351d",
    "id": "9462ca25-468b-45a5-9e75-6f516dedcc80",
    "api_id": "44e45d2b-8754-4a93-b793-c63271335f6f",
    "application_id": "1456a4bf-e2f4-4247-9b2d-fb49effc6eca",
    "created_at": 1766329436.091,
    "started_at": 1766329436.151,
    "finished_at": 1766329518.051,
    "elapsed": 81.9,
    "credential_id": "3e20b461-f750-48d3-a1f7-3aea48d15d77",
    "request": {
        "model": "doubao-seedance-1-0-pro-250528",
        "content": [
            {
                "type": "text",
                "text": "複数のショット。一人の探偵が薄暗い部屋に入る。彼はテーブルの上の手がかりを調べ、テーブルの上の何かを手に取る。カメラは彼が考え込んでいるところに切り替わる。 --ratio 16:9"
            }
        ],
        "callback_url": "dummy"
    },
    "trace_id": "24b1b09c-5649-4290-98db-eab23e5efcac",
    "type": "videos",
    "user_id": "ad7afe47-cea9-4cda-980f-2ad8810e51cf",
    "response": {
        "success": true,
        "task_id": "9462ca25-468b-45a5-9e75-6f516dedcc80",
        "trace_id": "24b1b09c-5649-4290-98db-eab23e5efcac",
        "data": {
            "task_id": "cgt-20251221230356-sxgt7",
            "status": "succeeded",
            "video_url": "https://platform.cdn.acedata.cloud/seedance/d1c2e49e-d854-4a2e-b0c0-88e520f82e2e.mp4",
            "last_frame_url": null,
            "model": "doubao-seedance-1-0-pro-250528"
        }
    }
}

返された結果には複数のフィールドがあり、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 は今回のすべてのバッチタスクの具体的な詳細情報を返します。例えば：

{
    "items": [
        {
            "_id": "69480c5cff2676299c7b351d",
            "id": "9462ca25-468b-45a5-9e75-6f516dedcc80",
            "api_id": "44e45d2b-8754-4a93-b793-c63271335f6f",
            "application_id": "1456a4bf-e2f4-4247-9b2d-fb49effc6eca",
            "created_at": 1766329436.091,
            "started_at": 1766329436.151,
            "finished_at": 1766329518.051,
            "elapsed": 81.9,
            "credential_id": "3e20b461-f750-48d3-a1f7-3aea48d15d77",
            "request": {
                "model": "doubao-seedance-1-0-pro-250528",
                "content": [
                    {
                        "type": "text",
                        "text": "複数のショット。探偵が薄暗い部屋に入る。彼はテーブルの手がかりを調べ、テーブルの上の物を手に取る。カメラは彼が考え込んでいる様子に切り替わる。 --ratio 16:9"
                    }
                ],
                "callback_url": "dummy"
            },
            "trace_id": "24b1b09c-5649-4290-98db-eab23e5efcac",
            "type": "videos",
            "user_id": "ad7afe47-cea9-4cda-980f-2ad8810e51cf",
            "response": {
                "success": true,
                "task_id": "9462ca25-468b-45a5-9e75-6f516dedcc80",
                "trace_id": "24b1b09c-5649-4290-98db-eab23e5efcac",
                "data": {
                    "task_id": "cgt-20251221230356-sxgt7",
                    "status": "succeeded",
                    "video_url": "https://platform.cdn.acedata.cloud/seedance/d1c2e49e-d854-4a2e-b0c0-88e520f82e2e.mp4",
                    "last_frame_url": null,
                    "model": "doubao-seedance-1-0-pro-250528"
                }
            }
        },
        {
            "_id": "69480e0dff2676299c7cb98b",
            "id": "d9e576bd-ca14-4c6f-a541-f4734e941dbe",
            "api_id": "44e45d2b-8754-4a93-b793-c63271335f6f",
            "application_id": "1456a4bf-e2f4-4247-9b2d-fb49effc6eca",
            "created_at": 1766329436.091,
            "started_at": 1766329436.151,
            "finished_at": 1766329518.051,
            "elapsed": 81.9,
            "credential_id": "3e20b461-f750-48d3-a1f7-3aea48d15d77",
            "request": {
                "model": "doubao-seedance-1-0-pro-250528",
                "content": [
                    {
                        "type": "text",
                        "text": "複数のショット。探偵が薄暗い部屋に入る。彼はテーブルの手がかりを調べ、テーブルの上の物を手に取る。カメラは彼が考え込んでいる様子に切り替わる。 --ratio 16:9"
                    }
                ],
                "callback_url": "dummy"
            },
            "trace_id": "e3da01aa-5026-4653-8d07-c68c4fcf466a",
            "type": "videos",
            "user_id": "ad7afe47-cea9-4cda-980f-2ad8810e51cf",
            "response": {
                "success": true,
                "task_id": "d9e576bd-ca14-4c6f-a541-f4734e941dbe",
                "trace_id": "e3da01aa-5026-4653-8d07-c68c4fcf466a",
                "data": {
                    "task_id": "cgt-20251221231109-cnkhp",
                    "status": "succeeded",
                    "video_url": "https://platform.cdn.acedata.cloud/seedance/eb99ba03-178c-4616-8d19-e625fee2e884.mp4",
                    "last_frame_url": null,
                    "model": "doubao-seedance-1-0-pro-250528"
                }
            }
        }
    ],
    "count": 2
}

返却結果には複数のフィールドが含まれており、itemsはバッチタスクの具体的な詳細情報を含んでいます。各タスクの具体的な情報は上記のフィールドと同じです。

items、バッチタスクのすべての具体的な詳細情報。これは配列であり、各配列の要素は上記の単一タスクの返却結果の形式と同じです。
count、ここでのバッチクエリタスクの数。

CURL

curl -X POST 'https://api.acedata.cloud/seedance/tasks' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "ids": ["9462ca25-468b-45a5-9e75-6f516dedcc80","d9e576bd-ca14-4c6f-a541-f4734e941dbe"],
  "action": "retrieve_batch"
}'

エラーハンドリング

APIを呼び出す際にエラーが発生した場合、APIは対応するエラーコードと情報を返します。例えば：

400 token_mismatched：不正なリクエスト、パラメータが不足しているか無効である可能性があります。
400 api_not_implemented：不正なリクエスト、パラメータが不足しているか無効である可能性があります。
401 invalid_token：未認証、無効または不足している認証トークン。
429 too_many_requests：リクエストが多すぎます、レート制限を超えました。
500 api_error：内部サーバーエラー、サーバーで何かがうまくいきませんでした。

エラー応答の例

{
  "success": false,
  "error": {
    "code": "api_error",
    "message": "fetch failed"
  },
  "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}

結論

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

はじめに

AIチャット

AI画像

AI動画

AIオーディオ

ウェブ＆データ

CAPTCHA

アイデンティティ

プロキシ

上級

Coding

SeeDance Tasks API の接続と使用

申請プロセス

リクエスト例

タスク例の画像

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

コード例

CURL

レスポンス例

バッチ照会操作

コード例

レスポンス例

CURL

エラーハンドリング

エラー応答の例

結論

​申請プロセス

​リクエスト例

​タスク例の画像

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

​コード例

​CURL

​レスポンス例

​バッチ照会操作

​コード例

​レスポンス例

​CURL

​エラーハンドリング

​エラー応答の例

​結論

申請プロセス

リクエスト例

タスク例の画像

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

コード例

CURL

レスポンス例

バッチ照会操作

コード例

レスポンス例

CURL

エラーハンドリング

エラー応答の例

結論