開発者向けドキュメント
メディアのローカライズ、人間の開発者、自動化エージェント向けのWeydub API。
署名付きリクエストを1つ送るところから始め、字幕やテキストの削除、動画翻訳、字幕抽出、画像翻訳、コールバック、自動化の本番ワークフローへ進みます。ログイン済みのWeydubユーザーは、マイアカウントから無料でAPIアクセスを有効にできます。
開発者プラットフォームのように始める
認証情報を取得し、署名付きの呼び出しを1回実行して、ステータスを確認したら、ワークフローページを選びます。これにより、人間による操作をスムーズに進めながら、エージェントが安全に構築できるだけの構造も確保できます。
- アクセス権を取得サインインし、「マイアカウント」からAPIアクセスを無料で有効にして、アカウントに対象ワークフローの利用権限があることを確認します。
- リファレンスを見るエンドポイント、リクエスト形式、ステータスフィールド、トラブルシューティング情報を確認します。
- クイックスタートを試す環境変数とコンパクトなJSONを使った署名で、デモタスクを1件作成します。
- 結果を確認ステータスをポーリングするかコールバックを受け取り、出力URLとエラーを永続保存します。
主要なワークフロー
APIホームは、動画からテキストを除去する、動画を翻訳する、字幕ファイルを抽出する、画像を翻訳するという4つの本番向けジョブを中心に構成されています。
字幕とテキストを削除
動画に焼き付けられた字幕、キャプション、透かし、ローワーサード、ロゴ、筋書きの手がかり、登録番号、その他の表示テキストをきれいに除去します。
- エンドポイント:
/v-w-c/gateway/ve/work/free - Basic:
needChineseOcclude: 1|2|3 - Lite/Pro:
advanced_lite、advanced_large_box、advanced_full - マスク:
videoInpaintMasks - CRF:
extraOptions.write_options.crf有効にした場合
動画を翻訳
翻訳字幕、オプションのAI吹き替え、レンダリング済みのローカライズ動画アセットを作成します。
- エンドポイント：
/v-w-c/gateway/ve/work/free - 吹き替え：
needWanyin: 1、wyTaskType: FULL - フレーム内テキスト：
needChineseOcclude: 11 - 感情の強さ：
/voice/incorporate
字幕を抽出
OCRで表示字幕から、またはASRで音声の発話からSRT/VTTを生成します。
- OCR：
needChineseOcclude: 14 - OCRマスク：
type: trans_only_ocr - ASR：
wyTaskType: ONLY_ASR、wyNeedText: 0
画像を翻訳
商品画像、スクリーンショット、コミックのコマ、アプリUIのキャプチャ、クリエイティブアセットをローカライズします。
- エンドポイント：
/v-w-c/gateway/ve/image/translate - 翻訳：
translateOn: 1、synthesisOn: 1 - テキストを消去：
translateOn: 0、synthesisOn: 1
まずWeydubで試す
実装前に出力品質を確認したいユーザーには、対応するWeydubのワークフローを案内します。オートメーション、署名、コールバック、本番環境での動作については、APIドキュメントをここで確認できます。
本番環境のルール
これらのルールはAPIページに取り込まれているため、開発者やエージェントは実装時にローカルのWeydubドキュメントを参照できます。
対象読者は2種類
このドキュメントは、AIコーディングツールを使う人と、簡潔で信頼できる仕様を必要とする自動化エージェントに向けて作成されています。
順番に読む
まず5つの主要チュートリアルを読んでください。AIコーディングツールや社内ボットが実装を行う場合は、エージェント用ファイルを使用してください。
統合の手順
スクリプト、バックエンドサービス、ノーコード連携、キューワーカー、AI-で生成されたクライアントの実装チェックリストとして使用してください。
- 無料アクセス「マイアカウント」からAPIアクセスを有効にし、アカウントに対象ワークフローの利用権限があることを確認します。
- シークレットを保存使用
WEYDUB_APP_KEYおよびWEYDUB_APP_SECRETまたはシークレットマネージャー。 - 厳密に署名コンパクトなJSON、二重MD5署名の順で処理し、同じボディバイト列を送信します。
- タスクを作成メディアURLを送信し、返されたプロジェクトID、ワークID、タスクIDを保存します。
- 安全に待機本番環境ではコールバックを使用し、フォールバックとしてポーリングを使用します。
- 結果を保存出力URL、SRTリンク、画像アセット、ステータス、エラーを保存します。
- デモを実行顧客のメディアを接続する前に、公式アセットで確認します。
- ユーザーを保護再試行を冪等にし、AppSecretを決して漏らさないでください。
最小限の呼び出し形式
認証情報には環境変数を使用してください。AppSecretをフロントエンドコード、公開リポジトリ、スクリーンショット、ログ、または保持される可能性のあるプロンプトに保存しないでください。
POST https://api.zhaoli.com/v-w-c/gateway/ve/work/free
Headers:
Content-Type: application/json
AppKey: $WEYDUB_APP_KEY
AppSign: md5(md5(request_body) + $WEYDUB_APP_SECRET)
Body:
{
"urls": ["https://example.com/demo.mp4"],
"needChineseOcclude": 1,
"videoInpaintLang": "all"
}デモシナリオ
顧客のメディアを接続する前に、これらの公開アセットを使ってAPI連携を検証してください。ボットやコーディングツールが最も頻繁に呼び出すとWeydubが想定しているワークフローをカバーしています。
高度なテキスト除去
Advanced Proの全画面モデルで、英語のハードサブタイトル付き動画を送信します。
シナリオ2動画翻訳
英語のデモ動画を、字幕とAI吹き替え付きでスペイン語に翻訳します。
シナリオ3感情豊かなクローン
中国語の動画と対応するJSONを使って、ショートドラマを中国語から英語に吹き替えます。
- 英語の動画：
http://gc9.cdn.izhaoli.cn/ghostcut_demo/TextRemoval_Dubbing_Eng.mp4 - 中国語の動画：
http://gc9.cdn.izhaoli.cn/ghostcut_demo/HighEmotion_Dubbing_cn2en.mp4 - 中国語のJSON：
http://gc9.cdn.izhaoli.cn/ghostcut_demo/HighEmotion_Dubbing_cn2en.json
Markdownとしてコピー
このブロックは、 index.mdにある概要を反映したものなので、人間はこれをAIコーディングセッションに貼り付け、エージェントはプレーンMarkdownとして解析できます。
AIコーディングツール向け
アシスタントにクイックスタート、認証、字幕除去、動画翻訳、字幕抽出、Weydub API Skillを提供してください。その後、認証情報は環境変数を通じてのみ渡してください。これがCodex、Cursor、Claude Code、社内ボット、自動化エージェントで想定される利用方法です。
ヘルプとチュートリアル
ローカルのAPIページが実装上の正式な情報源です。製品ワークフローについては、ローカルのWeydubヘルプセンターを利用してください。