RUNWARE

連携方法の比較

Runware vs API:アプリケーションに合う方法を選ぶ

runware vs apiは、プラットフォームとAPIのどちらを選ぶかという問題ではありません。RunwareもAPIアクセスを提供しています。比較すべきは、Runware経由で連携する方法と、各モデルプロバイダーのAPIに直接接続する方法です。最適な方法は、必要なモデルと、どこまで連携作業を自分たちで担いたいかによって決まります。

Runwareサイトの画像

結論から:連携方法を比較する

runware vs apiを検討する際は、アプリケーションに必要なモデル、エンドポイント、利用条件を比較してください。どちらかがすべての項目で優れているわけではありません。今は接続が簡単でも、必要なモデルが変われば別の作業が必要になる場合があります。

Runware経由
プロバイダーのAPIに直接接続

連携対象

Runware経由

Runwareのドキュメントに記載されたAPIと、利用可能なモデル。

プロバイダーのAPIに直接接続

選択したプロバイダーのAPI。そのプロバイダー独自のドキュメントと仕様に従います。

モデルの選択

Runware経由

必要な各モデルがRunwareで利用可能か、また必要な処理に対応しているかを確認します。

プロバイダーのAPIを直接利用

プロバイダーのカタログを直接確認します。通常、2つ目のプロバイダーを追加するには、別の連携が必要です。

リクエスト設計

Runware経由

アプリケーションの入力を、Runwareがサポートするパラメーターとレスポンス処理に対応付けます。

プロバイダーのAPIを直接利用

入力をプロバイダー固有のパラメーターに対応付けます。これにより、他では提供されていない機能を利用できる場合があります。

プロバイダー固有の機能

Runware経由

本番環境で利用する前に、その機能が提供されていることを確認します。

プロバイダーのAPIを直接利用

利用可能な場合は、その機能についてプロバイダーが公開しているインターフェースを使用します。

運用上の責任範囲

Runware経由

アプリケーションの入力検証、エラー処理、監視、ユーザー向けの動作は、引き続きお客様の責任です。

プロバイダーのAPIを直接利用

これらの作業に加え、個別に連携したプロバイダー間で必要な調整もお客様の責任です。

後から切り替える場合

Runware経由

プラットフォームアダプターを使えば、Runware固有のリクエストとレスポンスの詳細を切り離せます。

プロバイダーのAPIを直接利用

プロバイダーアダプターを使えば、そのAPIの詳細を切り離せますが、他のプロバイダーにはそれぞれ独自の対応付けが必要です。

選定時の確認事項

Runware経由

代表的なテストで、対応モデル、利用可能な制御項目、利用条件、実際の出力を確認します。

プロバイダーのAPIに直接接続

プロバイダーのAPIでも同じ要件を確認し、アプリケーション全体の動作フローをテストしてください。

項目別の比較

APIという言葉はインターフェースを指し、競合する製品カテゴリーを指すものではありません。この比較でRunwareを一方の選択肢とするのは、もう一方がモデルプロバイダーへの直接接続を意味する場合に限られます。

Runwareとの連携

1

利用可能なモデルと制御機能が、アプリケーションで行う処理に合っている場合は、この方法を検討してください。

  • 利用する対応モデルごとに個別の接続を設けるよりも、連携先を一つにまとめた方が保守しやすい場合があります。
  • プラットフォーム向けのアダプターを設けることで、リクエスト、レスポンス、エラーを処理する場所をチーム内で明確にできます。
  • 対応しているモデルであれば、同じ連携方法を通じて選択肢を評価できます。
  • すべてのプロバイダーのモデルや機能が利用できるとは限りません。要件ごとに確認してください。
  • プラットフォーム固有のリクエスト項目についても、ドキュメント、テスト、保守が必要です。

プロバイダーのAPIに直接接続

2

特定のプロバイダー固有の機能が製品の中核となる場合は、この方法を検討してください。

  • 対応するパラメーターや動作については、プロバイダー自身のドキュメントが参照元となります。
  • 別のプラットフォームのインターフェースを先に確認することなく、プロバイダー固有の機能を前提に設計できます。
  • 単一のプロバイダーを利用するアプリケーションでは、より広範な連携レイヤーがすぐには必要ない場合があります。
  • 別のプロバイダーを追加すると、異なるスキーマ、エラーの扱い方、運用手順が必要になる場合があります。
  • 内部アダプターを作成しない限り、アプリケーションのコードが一つのプロバイダーに強く依存する可能性があります。

それぞれの方法が適しているケース

一方のAPIが優れているという一般論ではなく、具体的な処理内容に基づいて選んでください。実装を比較する前に、必要なモデル、制御機能、障害時の動作を書き出しましょう。

この方法を選ぶ場合

複数の対応モデルを評価する予定があり、アプリケーション側の連携窓口を一つにまとめたい場合。

まずはRunware経由の方法をテストしてください。

小さなアダプターを作成し、実際に必要なモデルで代表的なプロンプトを実行してください。モデルが利用可能というだけで適合すると判断せず、出力品質、パラメーターへの対応、エラー処理を確認してください。

この方法を選ぶ場合

特定のモデルプロバイダー固有の機能が、ユーザー体験に不可欠な場合。

そのプロバイダーのAPIを直接テストしてください。

その機能を使う実際のリクエストから始め、文書化されている制限とレスポンスの動作を確認します。直接連携すれば、別のインターフェースが同じ制御項目を公開しているかどうかに依存せずに済みます。

次の場合に選択

チームには既存のプロバイダー連携があるものの、後で別の接続経路を追加する可能性がある場合。

切り替え前に、現在の接続を維持しながら内部アダプターを導入してください。

アプリケーションの入出力を、プロバイダー固有のフィールドから切り離します。そうすれば、すべての呼び出し元を一度に移行させることなく、同じテストケースで実装を比較できます。

移行経路の背景情報

連携を変更する前に、Runwareとは何かを確認し、モデルに関する疑問を調べ、実装ガイドを確認してください。これらの関連ページは判断の参考になりますが、最終的な選択は独自のテストに基づいて行ってください。

移行経路

接続経路を変更する前にワークロードをテストする

実際のアプリケーションタスクを1つ選び、プロバイダーに依存しないリクエストを定義します。そのうえで、現在のAPIと評価したい接続経路それぞれにアダプターを作成します。同じ入力を使い、出力、利用可能な制御項目、エラー、運用上の要件を比較してください。選択肢を検討する中で別のプラットフォームも比較したい場合、このリンクからモデルAPIを開けます。モデルAPIの/v1/predictionsエンドポイントでは、x-api-keyと{model, input}形式のボディを使用します。導入前に、モデル固有の要件と料金を確認してください。

AIモデルを探す
  • 各アダプターをテストする間、アプリケーション側の入力を変更しないでください。
  • サポートされていない制御項目は、黙って省略せずに記録してください。
  • 本番トラフィックの切り替えは、独自のエンドツーエンドチェックを終えてから行ってください。

比較に関するよくある質問

RunwareはAPIアクセスを提供しているため、この2つは対立する説明ではありません。ここで比較する代替手段は、個々のモデルプロバイダーのAPIに直接接続する方法です。アプリケーションに必要な具体的なエンドポイントと機能を比較してください。

必要なモデルと制御項目がRunwareのインターフェースで利用でき、その連携方法がアプリケーションに適している場合は、Runwareを検討してください。決定する前に、実際のリクエストでテストしましょう。特定のプロバイダーだけが提供する機能が不可欠な場合は、そのプロバイダー固有のAPIのほうが適している可能性があります。

そうとは限りません。2つのルートで同じモデルを利用できても、リクエストのフィールド、対応する設定、レスポンス、エラーは異なる場合があります。内部アダプターを使うと、アプリケーションの共通入力を各ルートのドキュメントで定められた形式に変換できます。

アプリケーションの代表的なタスクを選び、必要な出力を定義します。同じ入力を使って各ルートで小規模なテストを実装し、結果、対応するパラメーター、失敗時の処理を確認してください。評価の一環として、最新のドキュメントと利用規約も確認しましょう。

いいえ。アプリケーションでは引き続き入力を検証し、正常に処理されなかったレスポンスに対処し、エラーをユーザーに伝える必要があります。どちらのルートを選ぶ場合も、最初のレスポンスだけで連携全体を判断せず、生成が成功するケースと併せてこれらの動作をテストしてください。

始める
始める