88API88API
使用ガイドAIアプリケーションAPIリファレンスヘルプとサポート
APIモジュールガイド

タスクセンターモジュール

機能説明

インターフェースのプレフィックスは https://88api.ai です。

現在のアカウントの非同期タスク(動画生成タスクなど)を照会し、タスクのステータス、進捗、消費量、結果を確認できます。

🔐 ユーザー認証

自分のタスクを取得

  • インターフェース名:自分のタスクを取得
  • HTTP メソッド:GET
  • パス:/api/task/self
  • 認証要件:ユーザー
  • 機能概要:ページネーションで現在のユーザーのタスクリストを取得します。プラットフォーム、タスク ID、ステータスなどの条件によるフィルタリングをサポートします。

💡 リクエスト例:

const response = await fetch('/api/task/self?p=1&page_size=20&task_id=cgt-20261014093000-x7k2m&status=SUCCESS&action=textGenerate&start_timestamp=1640908800&end_timestamp=1640995200', {
  method: 'GET',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer your_user_token',
    'New-Api-User': 'your_user_id'
  }
});
const data = await response.json();

✅ 成功レスポンス例:

{
  "success": true,
  "message": "",
  "data": {
    "items": [
      {
        "id": 1,
        "created_at": 1640908800,
        "updated_at": 1640909000,
        "task_id": "cgt-20261014093000-x7k2m",
        "platform": "54",
        "user_id": 1,
        "quota": 1000,
        "action": "textGenerate",
        "status": "SUCCESS",
        "fail_reason": "",
        "submit_time": 1640908800,
        "start_time": 1640908900,
        "finish_time": 1640909000,
        "progress": "100%",
        "properties": {},
        "data": {}
      }
    ],
    "total": 25,
    "page": 1,
    "page_size": 20
  }
}

❗ 失敗レスポンス例:

{
  "success": false,
  "message": "获取任务列表失败"
}

🧾 フィールド説明(リクエストパラメータ):

  • p (数値): ページ番号、デフォルトは 1
  • page_size (数値): 1ページあたりの件数、デフォルトは 20
  • platform (文字列): タスクプラットフォーム番号、オプション(通常は指定不要)
  • task_id (文字列): タスク ID によるフィルタリング、オプション
  • status (文字列): タスクステータスによるフィルタリング、オプション値:"NOT_START"、"SUBMITTED"、"QUEUED"、"IN_PROGRESS"、"FAILURE"、"SUCCESS"、"UNKNOWN"
  • action (文字列): タスクタイプによるフィルタリング、例:"textGenerate"(テキストから動画)、"generate"(画像から動画)など
  • start_timestamp (数値): 開始タイムスタンプ、オプション
  • end_timestamp (数値): 終了タイムスタンプ、オプション

🧾 返却フィールド説明:

  • id (数値): レコード ID
  • task_id (文字列): タスク ID
  • platform (文字列): タスクプラットフォームの内部番号(無視して構いません)
  • user_id (数値): ユーザー ID
  • quota (数値): 消費されたクォータ
  • action (文字列): タスクタイプ
  • status (文字列): タスクステータス
  • fail_reason (文字列): 失敗理由
  • submit_time (数値): 送信タイムスタンプ
  • start_time (数値): 開始タイムスタンプ
  • finish_time (数値): 完了タイムスタンプ
  • progress (文字列): 進捗率 (パーセンテージ)
  • properties (オブジェクト): タスクプロパティ
  • data (オブジェクト): タスク結果データ
  • total (数値): 条件に一致するタスクの総レコード数
  • page (数値): 現在返却されているページ番号
  • page_size (数値): 1ページに表示されるタスクレコード数