VisionEngine：モジュールの選択方法と結果の読み取り方

要約

• ドキュメントに記載されたチャレンジ内容と画像レイアウトに合わせて、適切な VisionEngine モジュールを選択する。
• 画像入力を用意する前に、モジュール固有のリクエスト例を確認する。
• 認識結果は createTask のレスポンスから読み取る。
• アプリケーションに結果を渡す前に、期待される solution フィールドを検証する。

VisionEngine クライアントは、2 つの決定を組み合わせて行う必要があります。選択したモジュールによって、リクエストがどの画像を記述するか、そしてアプリケーションがどのような結果を期待すべきかが決まります。すべての画像タスクがテキストを返すと想定したパーサーは、有効な回転（rotation）や距離（distance）の結果を破棄してしまいます。

CapSolver は、このガイドで扱うリクエストおよびレスポンスのフィールドを文書化しています。

画像レイアウトにモジュールを対応させる

まずは公式のモジュール一覧表にあるスクリーンショットとリクエスト例から確認します。rotate_1 の例に一致する回転レイアウトの場合、ドキュメントにあるリクエストには前景画像と背景画像が含まれます。slider_1 の例にも両方のフィールドが含まれますが、その出力は距離を表します。キャプチャした各画像は、元の役割と関連付けたままにしてください。VisionEngine API リファレンス

一般的なパラメータ一覧表を、すべてのモジュールに共通のリクエストスキーマとして扱う前に、必ず対象モジュール固有の例を確認してください。テスト対象として認可されたチャレンジで要求されている画像だけを用意します。Base64 フィールドを用意する際は、データ URL のプレフィックスと改行を削除してください。

元のレスポンスから結果を読み取る

VisionEngine のリファレンスでは、createTask に対する同期レスポンスが文書化されています。solution を読む前に、まず error フィールドを確認してください。そのうえで、送信したモジュールに照らして solution の形を確認します。rotate_1 の公開例には angle が含まれています。slider_1 には distance が含まれます。アプリケーションコードに結果を渡す際は、フィールド名とモジュールを必ずセットで扱ってください。タスク作成リファレンス

CapSolver ボーナスコードを利用する

自動化予算を今すぐブーストしましょう！
チャージ時にボーナスコード CAP26 を使用すると、すべてのリチャージで追加 5% ボーナス を無制限に獲得できます。
今すぐ CapSolver ダッシュボード で引き換えてください。

認識処理とアプリケーション側のチェックを分離する

モジュール、レスポンスステータス、および期待される solution フィールドが存在したかどうかを記録してください。フィールドが存在しない場合、パーサーを変更する前に、送信したモジュールと画像レイアウトがリファレンスの例と一致しているかを確認します。自前のテスト環境では、アプリケーションによる受け入れ可否は、認識結果とは別に記録します。サービスエラーについては、まずドキュメントにあるエラーコードを出発点として調査してください。API エラーコード

CapSolver を、ドキュメント化されたリクエスト仕様どおりに利用し、アプリケーション側の結果判定は別々に行ってください。

FAQ

Q: VisionEngine では getTaskResult をポーリングするべきですか？

VisionEngine のドキュメントでは、結果は createTask レスポンスの一部として返されると説明されています。

Q: すべてのモジュールで同じ結果パーサーを使えますか？

エラーハンドリングは共通化できますが、solution の形はサポートする各モジュールごとに個別に検証してください。

Q: 結果がおかしく見えるとき、まず何を確認すべきですか？

チャレンジレイアウト、選択したモジュール、および画像の役割を、対応する公式サンプルと見比べてください。