Pixverse Edit API

Pixverse Edit について

Six video transformations in one model: prompt editing, restyling, subject swap, motion transfer, upscaling, and generated sound effects.

Pixverse Edit の仕様

モデルID

pixverse-edit

プロバイダー

PixVerse

カテゴリ

ビデオ生成

リリース

-

入力

テキスト動画画像

出力

動画

エンドポイント

POST/v1/videos/generations

代替モデルID

pixverse/edit

Pixverse Edit API の料金

EmpirioLabs カタログのライブ従量課金料金です。使った分だけの支払いで、月額最低料金はありません。

Pixverse Edit API の呼び出し方

Pixverse Edit は POST /v1/videos/generations で動作します。リクエストはすぐに job_id を返すので、ジョブが完了するまで GET /v1/jobs/{job_id} をポーリングし、結果から出力 URL を読み取ってください。 EmpirioLabs ダッシュボードで API キーを取得してください。

curl https://api.empiriolabs.ai/v1/videos/generations \
  -H "Authorization: Bearer $EMPIRIOLABS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "pixverse-edit",
    "prompt": "Describe what you want Pixverse Edit to generate."
  }'

curl https://api.empiriolabs.ai/v1/jobs/JOB_ID \
  -H "Authorization: Bearer $EMPIRIOLABS_API_KEY"

import requests

response = requests.post(
    "https://api.empiriolabs.ai/v1/videos/generations",
    headers={"Authorization": "Bearer YOUR_EMPIRIOLABS_API_KEY"},
    json={
        "model": "pixverse-edit",
        "prompt": "Describe what you want Pixverse Edit to generate.",
    },
)
job = response.json()

# Generation runs as an async job. Poll until it completes.
import time
while True:
    status = requests.get(
        f"https://api.empiriolabs.ai/v1/jobs/{job['job_id']}",
        headers={"Authorization": "Bearer YOUR_EMPIRIOLABS_API_KEY"},
    ).json()
    if status.get("status") in ("completed", "failed"):
        print(status)
        break
    time.sleep(5)

Pixverse Edit API のパラメーター

EmpirioLabs 上の Pixverse Edit API が対応するリクエストパラメーターです。フィールドを省略した場合はデフォルト値が適用されます。

知っておくと便利

Six transformations that take an existing video and return a new one, selected with mode.

Modes

• modify: edit the content of a clip from a text prompt, optionally guided by up to 3 reference images.
• restyle: change the visual style while preserving motion and composition. Pass a restyle_prompt or a restyle_id.
• swap: replace a subject in the clip with an uploaded image. The model detects the subjects in the chosen keyframe; use swap_target to name which one, otherwise the first detected subject is used.
• mimic: transfer the motion of the source video onto a subject image.
• upscale: raise the resolution of the clip.
• sound_effect: generate a synchronized sound bed. Leave the prompt empty to have it derived from the video, and set original_sound_switch to keep the existing audio.

出力

• modify, mimic and swap output 360p, 540p or 720p. restyle, upscale and sound_effect follow the source clip.

Billing

• Billed per second of the source video at the rate for the mode and resolution. swap also includes a small one-off subject-detection charge, which is folded into the billed seconds for that request.

Input limits

• Video: MP4, MOV or WebM, up to 1920px on the long edge and 30 seconds. Up to 100MB for modify, mimic, swap and upscale, and 50MB for restyle and sound effects. Swap requires H.264 or H.265.
• Images: PNG, JPEG or WebP, up to 20MB and 10000px on the long edge.

Pixverse Edit API: よくある質問

Pixverse Edit API の料金はいくらですか?

EmpirioLabs では Pixverse Edit は従量課金です: Modify 360p $0.16 per second; Modify 540p $0.20 per second; Modify 720p $0.24 per second。このページのライブ料金表は常に API の請求額と一致します。

Pixverse Edit はどのエンドポイントを使いますか?

Pixverse Edit は api.empiriolabs.ai 上の POST /v1/videos/generations で提供され、標準的な Bearer トークン認証を使用します。

統合する前にブラウザで Pixverse Edit を試せますか?

はい。EmpirioLabs プレイグラウンドでは API と同じパラメーターで Pixverse Edit をブラウザ上で実行できるので、コードを書く前にプロンプトを試せます。

Pixverse Edit の API キーはどうやって取得しますか?

EmpirioLabs アカウントを作成し、ダッシュボードの API Keysでキーを生成してください。課金は従量制クレジットなので、実行したリクエストの分だけ支払います。