API リファレンス

POST

/api/projects

プロジェクト作成

フレーム生成前にプロジェクトを作成します。以降のエンドポイントで使う projectId を返します。

{
  "title": "Product teaser",
  "textPrompt": "Hero stands on cliff at dawn",
  "description": "Keep outfit consistent with uploaded still"
}

POST

/api/projects/generate/first-frame

AI 生成を開始します。projectId と（任意で）参照画像パスが必要です。

{
  "projectId": "<projectId>",
  "referenceImagePath": "projects/ref.png"
}

GET

/api/projects/generate/:step?predictionId=<id>&projectId=<id>

予測結果をポーリングします。ステップ：first-frame、last-frame、video。

ダッシュボードで Webhook URL を設定します。イベントは回転可能な HMAC シークレットで署名されます。

generation.succeeded

フレームまたは動画の処理が完了しました。

generation.failed

Replicate または内部キューでエラーが発生しました。payload.error を確認して再試行してください。

project.created

メタデータが Supabase に保存されたことの確認。CRM 連携に便利です。