---
title: "Webhook"
description: "PixAI API のタスクが開始・完了・キャンセル・失敗したときに POST リクエストで通知を受け取れます。プロフィールの Webhook またはリクエストごとの callbackUrl で設定します。"
canonical: "https://platform.pixai.art/ja/docs/references/webhook"
last-updated: "2026-09-28"
---

# Webhook

PixAI API のタスクが開始・完了・キャンセル・失敗したときに POST リクエストで通知を受け取れます。プロフィールの Webhook またはリクエストごとの callbackUrl で設定します。



開発者はウェブフックを設定することで、タスクのステータスに関する通知を受け取ることができます。

タスクが開始、完了、キャンセル、または失敗した際に、指定した URL に POST リクエストが送信されます。

[プロフィールページ](https://pixai.art/ja/profile/edit/api)で設定できます。

REST API で `callbackUrl` を使用する場合、ボディは以下の形式になります:

```json
{
    "action": "task_running",
    "data": {
        "id": "1829312678046282149",
        "status": "running",
        "createdAt": "2024-12-27T09:25:46.436Z",
        "updatedAt": "2024-12-27T09:26:01.912Z",
        "outputs": {
            "mediaIds": [],
            "mediaUrls": []
        }
    }
}
```