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

{
  "code": 200,
  "data": {
    "id": "task_01KA040M0HP1GJWBJYZMKX1XS1",
    "status": "completed",
    "progress": 100,
    "result": {
      "images": [
        {
          "url": [
            "https://upload.apimart.ai/f/image/9998236911693428-e8d7441f-f7b4-4130-97ad-9ef8a0dde2ce-image_task_01KA0413RT2GGNZJ9GWQ4PXF2F_0.png"
          ],
          "expires_at": 1763174708
        }
      ]
    },
    "created": 1763088289,
    "completed": 1763088308,
    "estimated_time": 60,
    "actual_time": 19
  }
}

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

{
  "code": 200,
  "data": {
    "id": "task_01KA040M0HP1GJWBJYZMKX1XS1",
    "status": "completed",
    "progress": 100,
    "result": {
      "images": [
        {
          "url": [
            "https://upload.apimart.ai/f/image/9998236911693428-e8d7441f-f7b4-4130-97ad-9ef8a0dde2ce-image_task_01KA0413RT2GGNZJ9GWQ4PXF2F_0.png"
          ],
          "expires_at": 1763174708
        }
      ]
    },
    "created": 1763088289,
    "completed": 1763088308,
    "estimated_time": 60,
    "actual_time": 19
  }
}

​
認証

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

​
パスパラメータ

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

​
クエリパラメータ

​
language
string
レスポンスコンテンツの言語、以下の値をサポート：
  • zh - 中国語
  • en - 英語
  • ko - 韓国語
  • ja - 日本語
デフォルトは英語

​
レスポンス

​
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の場合のみ存在）