仮想カメラを回転させて、あらゆるファッション画像の新しい視点アングルを生成します。

アングル生成

アングル生成エンドポイントを使用すると、既存の画像を取り込み、仮想カメラの位置を変更して、モデル、衣服、テクスチャ、照明を維持しながら、新しい視点アングル（例：正面、背面、側面プロファイル）を生成できます。

モデル名: angle-generation

ライフサイクル: stable

処理時間: 約10秒～20秒

出力形式: 自動 (JPEGまたはPNG)

配信方法: URL, Base64 (プレビュー)

クレジット: 生成されたアングルごとに1～5 (品質による)

リクエスト

画像と希望のアングルをユニバーサルな /v1/run エンドポイントに送信します。

POSThttps://fititon.app/api/v1/run

リクエスト例

curl -X POST https://fititon.app/api/v1/run \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -d '{
           "model_name": "angle-generation",
           "inputs": {
             "imageUrl": "https://example.com/front-view.jpg",
             "angleIds": ["back", "leftSide"],
             "quality": "2k"
           }
         }'

レスポンス

アングル生成には最大20秒かかる場合があるため、/v1/run エンドポイントは非同期ジョブ id とともに 201 Created ステータスを即座に返します。最終結果を取得するには、GET /v1/status/{id} を使用してステータスAPIをポーリングする必要があります。または、Webhooksを設定して通知を自動的に受信することもできます。当社のWebhookディスパッチャは厳格な15秒のタイムアウトを強制することにご注意ください。サーバーは15秒以内に2xxステータスコードでWebhookを承認する必要があります。そうしないと、失敗と見なされ、後で再試行されます。

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "starting",
  "created_at": "2026-07-18T17:30:00.000Z",
  "error": null,
  "output": null
}

status が "succeeded" に変わると、output フィールドには生成された画像を指すURLの配列が含まれます。画像は、最初のリクエストで提供された angleIds 配列とまったく同じ順序で返されます。

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "succeeded",
  "created_at": "2026-07-18T17:30:00.000Z",
  "error": null,
  "output": [
    "https://cdn.fititon.app/users/123/results/angle-123-0.png",
    "https://cdn.fititon.app/users/123/results/angle-123-1.png"
  ]
}

リクエストパラメータ

必須パラメータ

imageUrlRequiredstring

回転させるソース画像。公開アクセス可能なURLまたはBase64エンコードされた画像文字列を指定できます。

プロのヒント: 正面向きの写真は、最も一貫性のある多角的な結果を生成します。斜めや横向きのソース画像は避けてください。正面ビューはAIに最も多くの情報を提供しますが、斜めショットはAIに欠落している構造の詳細を幻覚させることになります。

フォーマット要件 Base64文字列を送信する場合、標準のデータURIプレフィックス（例：data:image/jpeg;base64,...）を含める必要があります。

angleIdsRequiredarray of strings

生成したいアングル識別子の配列。利用可能なオプションは次のとおりです。

"front": 正面ビュー
"back": 背面ビュー
"leftSide": 左側面 (90°)
"rightSide": 右側面 (90°)
"left45": 左45°
"right45": 右45°

オプションパラメータ

quality'1k' | '2k' | '4k'

出力解像度ティア。 デフォルト: 1k

ratiostring

アスペクト比のオーバーライド（例：16:9、3:4）。空の場合、システムは元の画像のアスペクト比をデフォルトとします。

サポートされる値: '1:1', '3:4', '4:3', '9:16', '16:9', '2:3', '3:2', '4:5', '5:4', '21:9'。

ランタイムエラー

この機能のランタイムエラーは、エラー処理に記載されている共通のセットを使用します。処理中にエラーが発生した場合、status は "error" に更新され、error フィールドには具体的な失敗理由が含まれます。

クレジットコスト

開発者APIリクエストの場合、コストはリクエストされたアングルの数に比例して増加し、選択された出力 quality ティアによって異なります。

計算式: コスト = 品質クレジット × アングルの数

品質ティア	アングルあたりのクレジット
1k (デフォルト)	1
2k	3
4k	5

例: 1k 品質で ["back", "leftSide", "rightSide"] をリクエストすると、合計3クレジットかかります。同じ3つのアングルを 4k 品質でリクエストすると、合計15クレジットかかります。

Angle Generation