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

​
申請プロセス

Kling Tasks API を使用するには、まず申請ページ Kling Videos Generation API にアクセスして、該当するサービスを申請し、その後、Kling Videos Generation API のタスクIDをコピーします。以下の図のように：

最後に、Tasks API ページ Kling Tasks API にアクセスして、該当するサービスを申請します。ページに入ったら、「Acquire」ボタンをクリックします。以下の図のように： 申請ページ まだログインまたは登録していない場合は、自動的にログインページにリダイレクトされ、登録とログインを促されます。ログインまたは登録後、現在のページに自動的に戻ります。 初回申請時には無料のクレジットが付与され、この API を無料で使用できます。

​
リクエスト例

Kling Tasks API は、Kling Videos Generation API の結果を照会するために使用できます。Kling Videos Generation API の使用方法については、文書 Kling Videos Generation API を参照してください。 Kling Videos 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/kling/tasks' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "id": "20068983-0cc9-4c6a-aeb6-9c6a3c668be0",
  "action": "retrieve"
}'

​
Python

import requests

url = "https://api.acedata.cloud/kling/tasks"

headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json"
}

payload = {
    "id": "20068983-0cc9-4c6a-aeb6-9c6a3c668be0",
    "action": "retrieve"
}

response = requests.post(url, json=payload, headers=headers)
print(response.text)

​
レスポンス例

リクエストが成功すると、API はこのビデオタスクの詳細情報を返します。例えば： 
{
  "_id": "67c5163f550a4144a5b68698",
  "id": "20068983-0cc9-4c6a-aeb6-9c6a3c668be0",
  "api_id": "29187cb2-1acb-43b8-baf5-3f3f709292eb",
  "application_id": "f35762fe-e8a4-4613-bb70-e5c1be4f9fc2",
  "created_at": 1740969535.333,
  "credential_id": "ce81345f-7e2a-4871-b539-aefb5f725220",
  "request": {
    "action": "text2video",
    "model": "kling-v1",
    "prompt": "白いセラミックのコーヒーマグが光沢のある大理石のカウンタートップにあり、朝の窓の光が当たっています。カメラはマグの周りを360度ゆっくり回転し、ハンドルのところで一時停止します。",
    "callback_url": "https://webhook.site/624b2c78-6dbd-4618-9d2b-b32eade6d8c3"
  },
  "trace_id": "0a907f69-4ae2-4a08-b34c-ee15c1c47077",
  "type": "videos",
  "user_id": "ad7afe47-cea9-4cda-980f-2ad8810e51cf",
  "job_id": "CjJzzGfBfqcAAAAAAKdVMQ",
  "response": {
    "success": true,
    "video_id": "030bb06d-98d4-4044-9042-0aa0822e8c8c",
    "video_url": "https://cdn.klingai.com/bs2/upload-kling-api/7822108635/text2video/CjJzzGfBfqcAAAAAAKdVMQ-0_raw_video_1.mp4",
    "duration": "5.1",
    "state": "succeed",
    "task_id": "20068983-0cc9-4c6a-aeb6-9c6a3c668be0"
  },
  "duration": 317.1300001144409,
  "finished_at": 1740969852.463
}
返された結果には複数のフィールドがあり、request フィールドはタスクを開始したときの request body です。また、response フィールドはタスク完了後に返される response body です。フィールドの説明は以下の通りです。
  • id：このビデオタスクを生成するための ID で、今回のビデオ生成タスクを一意に識別します。
  • request：ビデオタスク内のリクエスト情報を照会します。
  • response：ビデオタスク内の返却情報を照会します。

​
バッチ照会操作

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

​
コード例

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

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

​
レスポンス例

リクエストが成功すると、API は今回のすべてのバッチビデオタスクの具体的な詳細情報を返します。例えば： 
{
  "items": [
    {
      "_id": "67c5163f550a4144a5b68698",
      "id": "20068983-0cc9-4c6a-aeb6-9c6a3c668be0",
      "api_id": "29187cb2-1acb-43b8-baf5-3f3f709292eb",
      "application_id": "f35762fe-e8a4-4613-bb70-e5c1be4f9fc2",
      "created_at": 1740969535.333,
      "credential_id": "ce81345f-7e2a-4871-b539-aefb5f725220",
      "request": {
        "action": "text2video",
        "model": "kling-v1",
        "prompt": "光沢のある大理石のカウンタートップに置かれた白いセラミックのコーヒーマグ。カメラはマグの周りを360度ゆっくり回転し、ハンドルのところで一時停止します。",
        "callback_url": "https://webhook.site/624b2c78-6dbd-4618-9d2b-b32eade6d8c3"
      },
      "trace_id": "0a907f69-4ae2-4a08-b34c-ee15c1c47077",
      "type": "videos",
      "user_id": "ad7afe47-cea9-4cda-980f-2ad8810e51cf",
      "job_id": "CjJzzGfBfqcAAAAAAKdVMQ",
      "response": {
        "success": true,
        "video_id": "030bb06d-98d4-4044-9042-0aa0822e8c8c",
        "video_url": "https://cdn.klingai.com/bs2/upload-kling-api/7822108635/text2video/CjJzzGfBfqcAAAAAAKdVMQ-0_raw_video_1.mp4",
        "duration": "5.1",
        "state": "succeed",
        "task_id": "20068983-0cc9-4c6a-aeb6-9c6a3c668be0"
      },
      "duration": 317.1300001144409,
      "finished_at": 1740969852.463
    },
    {
      "_id": "67c51415550a4144a5b442a5",
      "id": "e3a575aa-a4bd-49c8-9b12-cde38d5462e0",
      "api_id": "29187cb2-1acb-43b8-baf5-3f3f709292eb",
      "application_id": "f35762fe-e8a4-4613-bb70-e5c1be4f9fc2",
      "created_at": 1740968981.619,
      "credential_id": "ce81345f-7e2a-4871-b539-aefb5f725220",
      "request": {
        "action": "text2video",
        "model": "kling-v1",
        "prompt": "光沢のある大理石のカウンタートップに置かれた白いセラミックのコーヒーマグ。カメラはマグの周りを360度ゆっくり回転し、ハンドルのところで一時停止します。"
      },
      "trace_id": "4f32ba2d-8846-4ea9-9253-997ec0b2e052",
      "type": "videos",
      "user_id": "ad7afe47-cea9-4cda-980f-2ad8810e51cf",
      "job_id": "Cjil4mfBfs0AAAAAAKbMQQ",
      "response": {
        "success": true,
        "video_id": "af9a1af0-9aa0-4638-81c1-d41d6143c508",
        "video_url": "https://cdn.klingai.com/bs2/upload-kling-api/7485378259/text2video/Cjil4mfBfs0AAAAAAKbMQQ-0_raw_video_1.mp4",
        "duration": "5.1",
        "state": "succeed",
        "task_id": "e3a575aa-a4bd-49c8-9b12-cde38d5462e0"
      },
      "duration": 316.3180000782013,
      "finished_at": 1740969297.937
    }
  ],
  "count": 2
}
返却結果には複数のフィールドが含まれており、itemsはバッチ動画タスクの具体的な詳細情報を含んでいます。各動画タスクの具体的な情報は上記のフィールドと同じです。
  • items、バッチ動画タスクのすべての具体的な詳細情報。これは配列であり、各配列の要素は上記の単一タスクの返却結果の形式と同じです。
  • count、ここでバッチクエリ動画タスクの数。

​
CURL

curl -X POST 'https://api.acedata.cloud/kling/tasks' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "ids": ["e3a575aa-a4bd-49c8-9b12-cde38d5462e0","20068983-0cc9-4c6a-aeb6-9c6a3c668be0"],
  "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"
}

​
結論

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