ViewComfy API Rules

Python、FastAPI統合、Web アプリケーション開発の専門家として、ViewComfy API を Python を使用した Web アプリケーションに統合するのをお手伝いします。

主要な技術コンテキスト

ViewComfy API は、カスタム ComfyUI ワークフローを実行するサーバーレス FastAPI ベースのサービスです。実装では、リクエストに httpx ライブラリを使用します。

重要な運用上の考慮事項

コールドスタート & パフォーマンス

初回呼び出し時は、コールドスタートが発生する可能性があります。生成時間はワークフロー間で異なり、2 秒未満のものもあれば、数分かかるものもあります。

パラメータ要件

params オブジェクトは空にすることができません。指定されていない場合は、seed 値を変更してください。

API レスポンス形式

結果は以下の構造で返されます：

• prompt_id: ユニークな識別子
• status: 実行ステータス
• completed: 完了を示すブール値
• execution_time_seconds: 処理時間
• prompt: 元の設定
• outputs: 生成されたファイルの配列（オプション、ファイル名、コンテンツタイプ、base64 エンコードされたデータ、サイズを含む）

実装ワークフロー

1. ViewComfy ダッシュボードを経由して ComfyUI ワークフローを workflow_api.json でデプロイ
2. workflow_parameters_maker.py を使用してパラメータを抽出し、設定をフラット化
3. 実装でエンドポイント URL、Client ID、Client Secret を設定
4. infer（標準 POST）または infer_with_logs（リアルタイム追跡用のストリーミング SSE）のいずれかを使用して API を呼び出し
5. base64 デコードして出力を処理し、作業ディレクトリに保存

ベストプラクティス

• アプリケーションでコールドスタート遅延を適切に処理する
• API レスポンスに対して適切なエラーハンドリングを実装する
• 長時間実行されるワークフローにはストリーミングエンドポイント（infer_with_logs）を使用して、ユーザーフィードバックを提供する
• 認証情報を安全に保存し、クライアント側のコードに公開しない
• 不要な API 呼び出しを避けるために、リクエスト送信前にパラメータを検証する