PixAI Platform
API v2 ドキュメント動画

参照動画生成タスクの作成

参照画像に基づいて動画を生成します。モデルによっては参照動画と参照音声も使用できます。

受け付ける参照はモデルごとに異なります:

  • tbkv1.0.1、tbkv1.0（Tsubaki）: 画像 1〜6、動画不可、音声クリップ最大 3、duration 5〜15。
  • v4.0、v4.0.1（Seedance 2、Seedance 2 Fast）: 画像最大 9、動画最大 3、音声クリップ最大 3、duration 4〜15。
  • v4.0.3（Seedance 2.5）: 画像最大 30、動画最大 10、音声クリップ最大 10、duration 4〜30。
  • v3.3（Vidu）: 画像 1〜7、動画・音声不可、duration 3〜16。

どのモデルでも画像または動画が 1 つ以上必要です。ただし v4.0.3 は音声のみでも受け付けます。

参照ファイルは次の制限を満たす必要があります:

  • 動画: MP4 または MOV、H.264 または HEVC、24〜60 fps、1 クリップ 2〜15 秒・合計 15 秒（v4.0.3 では 30 秒）、最大 50 MB（v4.0.3 では 200 MB）。
  • 音声: WAV または MP3、1 クリップ 2〜15 秒・合計 15 秒（v4.0.3 では 30 秒）、15 MiB 未満。

送信前に GET /v2/media/{mediaId}/info でファイルを確認してください。v4.0 と v4.0.1 では、数やクリップの長さはタスクの課金後にチェックされます。制限に違反したタスクは拒否されずに失敗します。

クレジットはタスク作成時に消費されます。結果は GET /v2/task/{id} をポーリングして取得します。完了したタスクの動画は outputs.videoMediaId です。

POST
/reference-video/create

Authorization

bearerAuth
AuthorizationBearer <token>

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

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST https://api.pixai.art/v2/reference-video/create \  -H "Authorization: Bearer $PIXAI_API_KEY" \  -H "Content-Type: application/json" \  -d '{    "model": "tbkv1.0.1",    "prompt": "the girl walks through the city at night",    "referenceImageMediaIds": ["1943547603237249965"],    "ratio": "9:16",    "duration": 5  }'
{
  "id": "string",
  "status": "waiting",
  "createdAt": "2019-08-24T14:15:22Z",
  "updatedAt": "2019-08-24T14:15:22Z",
  "startedAt": "2019-08-24T14:15:22Z",
  "endAt": "2019-08-24T14:15:22Z",
  "taskKind": "string",
  "paidQuota": 0,
  "taskStatusMsgI18n": {
    "key": "string",
    "defaultMessage": "string"
  },
  "outputs": {
    "videoMediaId": "string",
    "seed": "string",
    "mediaIds": [
      "string"
    ],
    "mediaUrls": [
      "string"
    ]
  }
}
{
  "code": "string",
  "status": 0,
  "message": "string",
  "data": {},
  "defined": true
}
{
  "code": "string",
  "status": 0,
  "message": "string",
  "data": {},
  "defined": true
}
{
  "code": "string",
  "status": 0,
  "message": "string",
  "data": {},
  "defined": true
}
{
  "code": "string",
  "status": 0,
  "message": "string",
  "data": {},
  "defined": true
}
{
  "code": "string",
  "status": 0,
  "message": "string",
  "data": {},
  "defined": true
}

画像から動画を生成するタスクの作成 POST

PixAI の Tsubaki 動画モデルで画像を動画にします。動画は `firstFrameMediaId` から始まり、`lastFrameMediaId` を指定した場合はその画像で終わります。出力は最初のフレームのアスペクト比を維持します。

タスクの取得 GET

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