PixAI Platform
API v2 ドキュメントメディア

ID によるメディア URL の取得

最大 100 件のメディア ID を URL に解決します。完了したタスクの outputs.mediaIds や outputs.videoMediaId などに使います。公開メディアの場合、認証は不要です。

存在しない ID は結果から除外され、結果の順序も保証されないため、各アイテムは id で照合してください。

GET
/media/batch

Authorization

bearerAuth
AuthorizationBearer <token>

認証が必要なすべてのリクエストでは、HTTP ヘッダーに次を追加してください

In: header

Query Parameters

ids*|array<>

カンマ区切りのメディア ID（1〜100 件）です。例: ?ids=1,2,3。パラメータを繰り返す形式（?ids=1&ids=2）も使えます。

Response Body

application/json

curl -X GET "https://api.pixai.art/v2/media/batch?ids=string"
[
  {
    "id": "string",
    "type": "IMAGE",
    "urls": [
      {
        "variant": "PUBLIC",
        "url": "string"
      }
    ],
    "width": 0,
    "height": 0,
    "fileUrl": "string",
    "hlsUrl": "string",
    "thumbnailUrl": "string",
    "duration": 0
  }
]

タスクの取得 GET

任意の v2 エンドポイントで作成したタスクを取得します。`status` が `completed`、`failed`、`cancelled` のいずれかになるまで、数秒ごとにポーリングしてください。

音声ファイルのアップロード URL の取得 POST

`POST /v2/reference-video/create` の `referenceAudioMediaIds` に使う音声クリップをアップロードする手順のステップ 1 です。流れは画像と同じです。ファイルの `Content-Type`（`audio/mpeg` または `audio/wav`）を付けてバイトを `uploadUrl` に `PUT` し、その後 `POST /v2/media/audio/register` を呼び出します。