---
title: "最初のAPIリクエスト"
description: "タスクの送信、ステータスの確認、画像のダウンロードまで、PixAI API への最初のリクエストをステップごとに説明します。"
canonical: "https://platform.pixai.art/ja/docs/quick-start/first-api-call"
last-updated: "2026-11-17"
---

# 最初のAPIリクエスト

タスクの送信、ステータスの確認、画像のダウンロードまで、PixAI API への最初のリクエストをステップごとに説明します。





ベースURL: `https://api.pixai.art/v2`

認証: すべてのリクエストに `Authorization: Bearer YOUR_API_KEY` ヘッダーを追加してください。APIキーの取得方法は[PixAI APIを使用するには？](/ja/docs/quick-start/enroll-in-api)をご参照ください。

手順 [#手順]

<div className="fd-steps">
  <div className="fd-step">
    タスクを送信する [#タスクを送信する-step]

    `POST /image/create` を送信します。必須フィールドは `modelVersionId` と `prompt` です。

    ```bash
    curl -X POST https://api.pixai.art/v2/image/create \
      -H "Authorization: Bearer $PIXAI_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{
        "modelVersionId": "2024383379556065549",
        "prompt": "An anime girl with long green hair in a white sundress, standing in a sunflower field at golden hour and holding a straw hat, with summer clouds and a seaside town behind her, cinematic lighting, detailed background",
        "aspectRatio": "3:5"
      }'
    ```

    レスポンス:

    ```json
    {
      "id": "TASK_ID",
      "status": "waiting",
      "createdAt": "2026-03-04T04:32:10.635Z",
      "updatedAt": "2026-03-04T04:32:10.635Z",
      "outputs": {
        "mediaIds": [],
        "mediaUrls": []
      }
    }
    ```

    レスポンス内の `id` を控えておいてください。これが次のステップで使用する `TASK_ID` です。

    <Callout type="info">
      `modelVersionId` は PixAI のモデルバージョン URL（`https://pixai.art/model/<id>/<modelVersionId>`）の最後のセグメントです。推奨モデルは[モデル一覧](/ja/docs/references/models#recommended-models)をご参照ください。
    </Callout>
  </div>

  <div className="fd-step">
    ステータスを確認する [#ステータスを確認する-step]

    `status` が終了状態になるまで繰り返します。作成直後は一時的に `404` が返ることがありますが、そのままポーリングを続けてください。

    ```bash
    curl https://api.pixai.art/v2/task/TASK_ID \
      -H "Authorization: Bearer $PIXAI_API_KEY"
    ```

    | ステータス       | 意味           |
    | :---------- | :----------- |
    | `waiting`   | タスクはキュー待ち中   |
    | `running`   | 生成処理中        |
    | `completed` | 完了、出力が利用可能   |
    | `failed`    | 生成に失敗        |
    | `cancelled` | タスクがキャンセルされた |

    `completed` の場合、`outputs.mediaUrls` に画像 URL が含まれます。

    ```json
    {
      "id": "TASK_ID",
      "status": "completed",
      "taskKind": "t2i",
      "createdAt": "2026-03-04T04:32:10.635Z",
      "updatedAt": "2026-03-04T04:32:41.902Z",
      "outputs": {
        "seed": "12345",
        "mediaIds": ["MEDIA_ID"],
        "mediaUrls": ["MEDIA_URL"]
      }
    }
    ```

    <Callout type="warn">
      ポーリングは **1.5秒** に1回以下にしてください。再試行時はエクスポネンシャル・バックオフを使用してください。各アカウントでは `waiting` 状態のタスクを同時に最大10件まで持てます（`running` のタスクは数えません）。詳細は[制限事項](/ja/docs/quick-start/limits)をご参照ください。
    </Callout>
  </div>

  <div className="fd-step">
    画像をダウンロードする [#画像をダウンロードする-step]

    ```bash
    curl -L "MEDIA_URL" -o output.webp
    # またはメディア ID から URL を取得（画像は `urls` の `PUBLIC`、動画は `fileUrl`）:
    curl "https://api.pixai.art/v2/media/batch?ids=MEDIA_ID"
    ```

    <Callout type="warn">
      生成された画像は **永続的に保存されません**。タスクが完了したらすぐにダウンロードしてください。
    </Callout>
  </div>
</div>

まとめて実行するスクリプト [#まとめて実行するスクリプト]

作成・ポーリング・保存を Python で行う例です。`requests` をインストールし、API キーを `PIXAI_API_KEY` に設定してください。

```python
import os
import time

import requests

API = "https://api.pixai.art/v2"
HEADERS = {"Authorization": f"Bearer {os.environ['PIXAI_API_KEY']}"}

resp = requests.post(
    f"{API}/image/create",
    headers=HEADERS,
    json={
        "modelVersionId": "2024383379556065549",  # Tsubaki.3
        "prompt": (
            "An anime girl with long green hair in a white sundress, standing in a sunflower field "
            "at golden hour and holding a straw hat, with summer clouds and a seaside town behind her, "
            "cinematic lighting, detailed background"
        ),
        "aspectRatio": "3:5",
    },
)
resp.raise_for_status()
task = resp.json()

while task["status"] in ("waiting", "running"):
    time.sleep(2)
    resp = requests.get(f"{API}/task/{task['id']}", headers=HEADERS)
    if resp.status_code == 404:  # 作成直後のタスクは一時的に 404 を返すことがあります。ポーリングを続けます。
        continue
    resp.raise_for_status()
    task = resp.json()

if task["status"] != "completed":
    raise SystemExit(f"Task ended as {task['status']}: {task.get('taskStatusMsgI18n')}")

for i, url in enumerate(task["outputs"]["mediaUrls"]):
    if url:
        image = requests.get(url)
        image.raise_for_status()
        with open(f"output-{i}.webp", "wb") as f:
            f.write(image.content)
```

次のステップ [#次のステップ]

* [モデル](/ja/docs/references/models) — 利用可能なモデルを確認
* [Webhook](/ja/docs/references/webhook) — ポーリングなしでタスクの更新を受け取る
* [使用例](/ja/docs/quick-start#steps) — 画像から動画の生成、キャラクターの一貫性、インペイント、LoRA の完全なスクリプト
