メインコンテンツへスキップ
GET
/
v1
/
tasks
/
{task_id}
curl --request GET \
  --url https://api.apimart.ai/v1/tasks/task-unified-1757156493-imcg5zqt \
  --header 'Authorization: Bearer <token>'

{
  "code": 200,
  "data": {
    "id": "task-unified-1757156493-k9m2xpvw",
    "status": "completed",
    "progress": 100,
    "result": {
      "images": [
        {
          "url": "https://example.com/generated-image.png",
          "expires_at": 1757242893
        }
      ]
    },
    "created": 1757156493,
    "completed": 1757156593,
    "estimated_time": 100,
    "actual_time": 100
  }
}

curl --request GET \
  --url https://api.apimart.ai/v1/tasks/task-unified-1757156493-imcg5zqt \
  --header 'Authorization: Bearer <token>'

{
  "code": 200,
  "data": {
    "id": "task-unified-1757156493-k9m2xpvw",
    "status": "completed",
    "progress": 100,
    "result": {
      "images": [
        {
          "url": "https://example.com/generated-image.png",
          "expires_at": 1757242893
        }
      ]
    },
    "created": 1757156493,
    "completed": 1757156593,
    "estimated_time": 100,
    "actual_time": 100
  }
}

​
認証

​
Authorization
string
required
すべてのAPIエンドポイントにはBearer Token認証が必要ですAPIキーの取得:APIキー管理ページにアクセスしてAPIキーを取得してくださいリクエストヘッダーに追加:
Authorization: Bearer YOUR_API_KEY

​
パスパラメータ

​
task_id
string
required
生成APIから返されたタスクID

​
レスポンス

​
id
string
一意のタスク識別子
​
status
string
タスクステータスの値:
  • pending - 処理待ち
  • processing - 処理中
  • completed - 正常に完了
  • failed - 失敗
  • cancelled - ユーザーによってキャンセル
​
progress
integer
タスク進捗率 (0–100)
​
result
object
タスクの結果、ステータスがcompletedの場合のみ返されます
​
created
integer
タスク作成タイムスタンプ
​
completed
integer
タスク完了タイムスタンプ（完了時のみ存在）
​
estimated_time
integer
推定完了時間（秒）
​
actual_time
integer
実際の完了時間（秒）（完了時のみ存在）
​
error
object
エラー詳細（ステータスがfailedの場合のみ存在）