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(数値): ページ番号、デフォルトは 1page_size(数値): 1ページあたりの件数、デフォルトは 20platform(文字列): タスクプラットフォーム番号、オプション(通常は指定不要)task_id(文字列): タスク ID によるフィルタリング、オプションstatus(文字列): タスクステータスによるフィルタリング、オプション値:"NOT_START"、"SUBMITTED"、"QUEUED"、"IN_PROGRESS"、"FAILURE"、"SUCCESS"、"UNKNOWN"action(文字列): タスクタイプによるフィルタリング、例:"textGenerate"(テキストから動画)、"generate"(画像から動画)などstart_timestamp(数値): 開始タイムスタンプ、オプションend_timestamp(数値): 終了タイムスタンプ、オプション
🧾 返却フィールド説明:
id(数値): レコード IDtask_id(文字列): タスク IDplatform(文字列): タスクプラットフォームの内部番号(無視して構いません)user_id(数値): ユーザー IDquota(数値): 消費されたクォータaction(文字列): タスクタイプstatus(文字列): タスクステータスfail_reason(文字列): 失敗理由submit_time(数値): 送信タイムスタンプstart_time(数値): 開始タイムスタンプfinish_time(数値): 完了タイムスタンプprogress(文字列): 進捗率 (パーセンテージ)properties(オブジェクト): タスクプロパティdata(オブジェクト): タスク結果データtotal(数値): 条件に一致するタスクの総レコード数page(数値): 現在返却されているページ番号page_size(数値): 1ページに表示されるタスクレコード数