APIリファレンス

このリファレンスでは、開発者や自動化エージェントが、Weydub APIエンドポイント、アクセス確認、リクエスト形式、非同期動作、課金と保持に関するルール、トラブルシューティングの手がかりを1か所で簡潔に確認できます。

リクエストの基本

一部の公開デモアセットや古いアカウントパスには、従来のインフラストラクチャ名が引き続き表示される場合があります。このWeydub APIドキュメントを、現行製品の対外的な契約仕様として扱ってください。

呼び出す前の確認

認証

ほとんどのリクエストでは、次のヘッダーを使用します：

Content-Type: application/json
AppKey: $WEYDUB_APP_KEY
AppSign: md5(md5(request_body) + $WEYDUB_APP_SECRET)

送信する正確かつコンパクトな JSON本文に署名します。認証と署名を読んでから、署名エラーのデバッグを行ってください。

署名不要の例外:

POST /v-w-c/enum/query2

enumクエリエンドポイントは、動的な言語/ステータス一覧に使用され、署名は不要です。

エンドポイント一覧

動画タスクの作成

POST /v-w-c/gateway/ve/work/free

このエンドポイントを使用する一般的なワークフロー:

最小構成のリクエスト:

{
  "urls": ["https://example.com/demo.mp4"],
  "needChineseOcclude": 1,
  "videoInpaintLang": "all",
  "callback": "https://your-domain.example/webhooks/weydub"
}

一般的な作成レスポンスのフィールド:

動画タスクのステータス照会

POST /v-w-c/gateway/ve/work/status

{
  "idWorks": [488026661]
}

ステータス値:

正常に完了した動画タスクには、videoUrl、coverUrl、srcSrtUrl、tgtSrtUrl、sourceVideoUrl、ttsMetaResult、wyVoiceParam、およびタスクのメタデータが含まれる場合があります。

画像タスク

現在公開されている作成エンドポイント:

POST /v-w-c/gateway/ve/image/translate

再実行エンドポイント:

POST /v-w-c/gateway/ve/image/translate/redo

画像翻訳リクエスト:

{
  "srcLang": "en",
  "tgtLang": "es",
  "translateOn": 1,
  "synthesisOn": 1,
  "commodityFilterOn": 0,
  "downloadInfo": "{\"url\":\"https://example.com/product.png\",\"fileName\":\"product.png\",\"id\":12345,\"materialName\":\"product.png\"}",
  "app": "WD"
}

画像内テキスト削除リクエスト:

{
  "srcLang": "en",
  "tgtLang": "en",
  "translateOn": 0,
  "synthesisOn": 1,
  "commodityFilterOn": 0,
  "downloadInfo": "{\"url\":\"https://example.com/banner.png\",\"fileName\":\"banner.png\",\"id\":12346,\"materialName\":\"banner.png\"}",
  "app": "WD"
}

画像ジョブを実装する前に画像翻訳をお読みください。downloadInfo、downloadInfos、および再実行時のresultでは、ドキュメントに記載された文字列形式を維持する必要があります。

Enumクエリ

POST /v-w-c/enum/query2

このエンドポイントではAppSignは必要ありません。

{
  "text": "Lang"
}

一般的なEnum名:

課金、制限、保持

コールバックの概要

対応している場合は、作成リクエストにcallback URLを渡します。Weydubは、ポーリング応答で使用される外側のcode / msg / bodyラッパーを使用せずに、完了した作業項目を直接お使いのサーバーに送信します。

コールバック処理のルール：

• 生のコールバックリクエスト本文とAppSecretを使用して、Callback-Signを検証します。
• 永続ストレージへの保存が成功した後に限り、HTTP 200と空でない本文を返します。
• ワーク／タスクID単位でハンドラーを冪等にします。
• 過去24時間以内に作成されたタスクへの失敗したコールバックは、約30分ごとに再試行されます。
• やり直しによって動画または画像の内容が変わると、出力URLが変わる可能性があるため、最新の結果のURLを保存します。

詳細については、非同期タスクモデルを参照してください。

トラブルシューティング

エージェント契約

自動化エージェントは次のことを行う必要があります：

• llms.txt と Weydub API スキル を読み込む。
• 顧客メディアを使用する前に、デモシナリオを使用する。
• 認証情報を環境変数またはシークレットマネージャーに保管する。
• 成功したことをユーザーに報告する前に、ID を永続化する。
• ジョブを submitted -> processing -> succeeded | failed | timed_out としてモデル化する。
• AppSecret を決して公開せず、有効化済みのエンドポイントを捏造しない。