AGTCloud API Docs
ガイドAPIリファレンス連携とリソース更新とヘルプ
動画生成PixVerse

PixVerse 画像アップロード

画像ファイルまたは画像 URL をアップロードし、動画生成と画像テンプレートで共用する画像 ID を取得します。

POST/openapi/v2/image/upload

認証

bearerAuth
認証Bearer <token>

プラットフォームの API Key を Authorization: Bearer your-api-key 形式で使用します。

指定位置: header

ヘッダーパラメーター

Ai-trace-id?string

任意の一意なトレース値。省略時はプラットフォームが生成します。冪等性キーではありません。

Accept-Language?string

任意のリソース API の言語設定。

リクエストボディ

multipart/form-data

レスポンスボディ

application/json

application/json

application/json

application/json

返された結果の使用

image と image_url の一方を指定し、どちらも multipart フォームを使用します。boundary はクライアントに生成させ、手動で組み立てないでください。成功後の Resp.img_id は画像から動画生成、開始・終了フレーム、参照からの生成に使用できます。

同じ Resp.img_id は画像テンプレート生成の img_ids にも使用できます。画像の枚数と順序は選択したテンプレートの要件に従ってください。

PixVerse 画像アップロード — 公式ドキュメント対応する上流プロトコルの定義を確認します。