PixVerse Image のパラメーターと API の違い
PixVerse 画像テンプレートの選択と非同期生成の仕組みを確認します。
API の構造は 画像を作成 と タスクを取得 を参照してください。
画像テンプレート生成
| 項目 | 説明 |
|---|---|
| サービス名 | pixverse-image-template は画像テンプレート生成機能です。リクエスト本文に model を指定する必要はありません。 |
| テンプレートの選択 | エフェクトテンプレート一覧を取得 を type=2 で呼び出し、名前、効果のプレビュー、入力要件で画像テンプレートを選択します。利用可能なテンプレートは一覧の更新に伴って変わります。 |
| 入力素材 | 画像をアップロード で画像 ID を取得します。画像の枚数と入力順序はテンプレートによって決まります。動画テンプレートを画像生成に直接使用することはできません。 |
| 生成方式 | 選択したテンプレートで画像を処理します。現在の作成 API では、自由なプロンプト、サイズ、モデルバージョンの指定はできません。 |
| 結果の取得 | 作成時はタスク情報のみを返します。その後、画像タスクを照会し、成功時に画像 URL を取得します。 |
ID の対応関係
| フィールド | 取得元と用途 |
|---|---|
img_id | アップロードした素材の ID。順序どおりに作成リクエストの img_ids に指定します。 |
template_id | 一覧で返された画像テンプレート ID。生成効果と入力要件を決定します。 |
image_id | 作成時に返された画像タスク ID。照会 API の task_id に指定します。 |
ID の読み取りと受け渡しでは、精度の損失を避けるため全桁を保持してください。素材、テンプレート、タスクの ID は相互に置き換えられません。