3行でいうと
- Webで使うには、vidu.comの「sign in」からメール、Google、Apple(日本語ヘルプはメールとGoogle)でアカウントを作ります。インストールは要りません。
- エージェントやコマンドから使うには、Webにログインしたあと、アカウントメニューの「Vidu Token」でトークンを取り、環境変数
VIDU_TOKENに入れます。海外ではVIDU_BASE_URLに https://service.vidu.com を入れる、と公式は書いています。 - コマンドラインの道具 vidu-cli は、npm(またはcargo)で入れます。Nodeの版は、READMEによって「14以上」と書かれていたり、書かれていなかったりします。
- アプリ(Vidu App)の入手先、API Platformでのキーの取り方は、読めたページでは確認できていません。確認できた範囲と、できていない範囲を分けて書きます。
この記事は、公式の資料を2026年10月25日に読んでまとめたものです。この記事は、実際に使って確かめた記録ではありません。
先に結論
- 入れるものは、使い方で3通りに分かれます。 ①Webだけ:入れるものなし。②エージェントやコマンドから:Node.js(npm)、vidu-cli、スキル、トークン。③自分のプログラムから:API Platformのキー(取り方は下の「段階9」で、読めた範囲を書きます)。
- 手順のうち、公式の文書から読み取れたものと、読めなかったものがあります。 ヘルプ(アカウント作成)、vidu-skillsとvidu-cliのREADME(導入、環境変数、トークンの取り方)、API文書の一部(認証ヘッダーの形)は読めました。アプリのストア掲載、APIキーの発行画面、チュートリアル本文は読めていません。
- 環境変数の書き方は、公式は
exportの形だけを載せています。 WindowsのPowerShellなどでの書き方は、公式の資料では確認できていません。この記事の案として別に書きますが、動作は確かめていません。 - 何を送るかの全体像は、07で扱います。 先に知りたい人向けに一言だけ書くと、vidu-skillsのREADMEは、プロンプトと、手元の画像・動画・音声がViduのサーバーに送られる、と書いています。
前提:用語をそろえる
- Vidu(Web版):www.vidu.comで、ブラウザから使うサービスです。01で説明しました。
- Vidu Token:vidu-skillsのREADMEが「Vidu API token」と呼ぶ合言葉です。Webにログインした状態で、アカウントメニューから取ります。人に見せてはいけません。
- API キー:API Platform(platform.vidu.com)から自分のプログラムが呼ぶときの合言葉です。公式のAPI文書では
Authorization: Token {your api key}のように使います。Vidu Tokenと同じものか別のものかは、公式の資料では確認できていません。 - API Platform:企業や開発者向けの入口(platform.vidu.com)です。
- ターミナル:文字で命令する画面です。macOSでは「ターミナル」アプリ、WindowsではPowerShellなどが、この画面にあたります(Viduの資料ではなく一般的な説明です)。
- CLI(コマンドライン):ターミナルから使う道具です。ここではvidu-cliを指します。
- Node.js / npm:vidu-cliを入れるのに使うプログラムの実行環境と、その入れ物(パッケージ管理)です。
- 環境変数:ターミナルの中で、プログラムに渡す設定値です。
VIDU_TOKENなどがあります。 - スキル:エージェントに「この道具の使い方」を教える手引きのファイル一式です。
- OpenClaw / ClawHub:Vidu Agentのページが「Vidu Agentの土台」と呼ぶ公開の枠組みと、そのスキルの置き場です。READMEの導入手順にClawHubが出てきます。
どれを入れるか:入口の一覧
| 入口 | 入れるもの | 公式で読めたこと | 読めていないこと |
|---|---|---|---|
| Web(vidu.com) | なし。アカウントだけ | ヘルプ「How to set up my account?」に作り方 | 日本語の生成画面の表記 |
| Vidu App | 不明 | トップページに「Get App」の表示がある | 入手先のリンク、対応OS、年齢区分 |
| vidu-cli | Node.js(npm)、またはRustのcargo | READMEに npm install -g vidu-cli@latest と cargo install vidu-cli |
Nodeの版(READMEにより記述が違う) |
| vidu-skills(エージェント用) | npx skills の仕組み、vidu-cli、トークン |
READMEに導入のコマンド | スキルが置かれる場所(フォルダ)の記載 |
| API Platform | APIキー | 文書にヘッダーの形、呼び出し先 | キーの発行画面、料金の数字 |
| Vidu S2のサンプル(vidu-s1-api) | Node.js 20以上、Chrome/Edge、APIキー、マイク | READMEに手順 | 詳細はAPI文書の「Streaming」(取得できず) |
段階1:Webでアカウントを作る
公式ヘルプ「How to set up my account?」の内容に沿った手順です。英語のヘルプと日本語のヘルプで、書かれているログイン方法が違います。
| ページ | 書かれていること |
|---|---|
| 英語のヘルプセンター(www.vidu.com/help-center) | vidu.comで「sign in」をクリックし、メール、Google、Appleのいずれかで登録する |
| 日本語のヘルプセンター(www.vidu.com/ja/help-center) | vidu.comで「ログイン」をクリックし、メールアドレスまたはGoogleアカウントでログインして、画面の案内に従う |
手順
- ブラウザで https://www.vidu.com/ を開きます(日本語のページは https://www.vidu.com/ja)。
- 「sign in」(日本語ページでは「ログイン」)を押します。ボタンの位置は、公式の資料では確認できていません。手元の画面と照らしてください。
- メール、Google、Appleのうち、画面に出ているものを選びます。Appleは、日本語のヘルプには出てきません。画面に出るかどうかは、手元の画面で確かめてください。
- 画面の案内に従って登録を終えます。メールで登録する場合の確認メールの有無や、パスワードの条件は、読んだ範囲では書かれていません。
- 登録後に、ヘッダーに「Home」「Assets」「Create」「Agent」「Tools」などが並ぶ画面(公式のRefHubのページで読み取れた表示)に入れるか確かめます。
登録後に知っておくこと(ヘルプの記載)
- 登録したメールアドレスの変更は、今は対応しておらず、今後対応予定です(英語・日本語のヘルプとも同じ)。
- アカウントが止まる理由として、不審な行為、規約違反、セキュリティ上の問題が挙がっています。間違いだと思うときは support@vidu.com に連絡する、との案内です。
- 年齢の条件、日本からの利用可否は、ヘルプには書かれていません。利用規約の本文は読めていません(01参照)。
段階2:アプリ(Vidu App)
公式トップページとVidu Q4のページに「Get App」の表示があります。僕らが読んだ範囲では、App StoreやGoogle Playへのリンク、対応OS、アプリの画面の言語、年齢区分は書かれていませんでした。トップページはViduのアプリを「An all-in-one collaborative creation app」と紹介しています。
- 手順は書けません。 アプリの入手手順は、公式の資料では確認できていません。入手するときは、vidu.comの「Get App」から案内される先を、公式サイトの上で確かめてください。
段階3:Vidu Tokenを取る(コマンド・エージェントから使う場合)
vidu-skillsのREADMEが書いている取り方です。READMEには画面の写真がありますが、取得できたのは文章だけです。
手順
- 段階1で作ったアカウントで、vidu.com(海外向け)にログインします。中国本土向けのvidu.cnでは手順が別にあります(この記事は海外向けのvidu.comだけを扱います)。
- 画面左のサイドバーにある、アカウントのアイコン(アバター)からメニューを開きます。READMEは「avatar in the left sidebar」と書いています。
- メニューの「Vidu Token」を選びます。
- 表示されたトークンを控えます。人に見せたり、公開の場所に貼ったりしないでください。 READMEは、できれば権限の小さいトークンを使い、本番用や強い権限のトークンは最初の試しには使わないよう書いています。権限の小さいトークンを作る方法は、読んだ範囲では書かれていません。
- Vidu Agentのページは、同じトークンを「Get Vidu TOKEN」のリンクから取る、と案内しています。リンク先のアドレスは取得できませんでした。
トークンの失効(取り消し)や再発行の手順は、記載が見つかりませんでした。
段階4:ターミナルを開く
ここは、Viduの資料ではなく一般的な説明です。
| OS | ターミナルの例 |
|---|---|
| macOS | 「ターミナル」アプリ |
| Windows | PowerShell、またはコマンドプロンプト |
| Linux | お使いのディストリビューションのターミナル |
Viduの資料は、OSごとの違いを書いていません。以降のコマンドは、READMEの書き方のまま載せます。
段階5:Node.jsとvidu-cliを入れる
Nodeの版について(資料によって書き方が違う)
| 資料 | 書かれていること |
|---|---|
| vidu-skillsのREADME | vidu-cliを入れるにはNode.js 14以上が必要 |
| vidu-skillsのSKILL.md(メタ情報) | node と npm が必要。npmで入れる。Node.js 14以上。postinstallの段階でGitHubからプラットフォーム用のバイナリを取ってくる(表が崩れて読めた範囲) |
| vidu-cliのREADME | Nodeの版やほかの実行環境は書かれていない。npmとCargo(Rust)の2つの入れ方だけ書かれている |
| vidu-s1-apiのREADME(S2のサンプル用) | Node.js 20以上 |
どれを守るべきかは、書き分けません。使う道具に近い資料(vidu-cliなら、vidu-skillsのREADMEの「14以上」)を見たうえで、新しい版が入っているかを手元で確かめてください。Node.jsの入れ方そのものは、Nodeの公式の資料にあり、Viduの資料にはありません。
手順(npmで入れる場合)
- ターミナルで、Nodeが入っているか確かめます(この記事の案。Viduの手順ではありません)。
node --version
npm --version
- READMEのコマンドで入れます。
npm install -g vidu-cli@latest
- もう1つの入れ方として、vidu-cliのREADMEはCargoを挙げています。
cargo install vidu-cli
- READMEは、入れた後の確認コマンドを書いていません。この記事の案として、使える状態かを確かめる方法を「段階8」に書きます。
気をつけること
- READMEの
npm install -gは、グローバルに入れる指定です。権限のエラーが出たときの直し方は、Viduの資料には書かれていません。 - vidu-cliのライセンスはMITです(README)。
段階6:環境変数を設定する
READMEが書いている変数は次の3つです。
| 変数 | 必須 | 意味(READMEの記載) |
|---|---|---|
VIDU_TOKEN |
はい | 段階3で取ったトークン |
VIDU_BASE_URL |
いいえ | 呼び出し先。vidu-skillsのREADMEの既定は https://service.vidu.cn。海外は https://service.vidu.com |
VIDU_DEBUG |
いいえ | 1 にすると、返ってきた中身の全文を標準エラーに出す |
vidu-cliのREADMEは、VIDU_BASE_URL について「China: service.vidu.cn, Global: service.vidu.com」と書いています。Vidu Agentのページも、中国本土以外では https://service.vidu.com を使うよう書いています。
手順(macOS、Linuxのターミナル。READMEの export の形に合わせた組み立て例)
- 次の2行を実行します。
your_tokenの部分を、段階3のトークンに置き換えます。この2行は、vidu-cliのREADMEのexportの形(READMEの例はexport VIDU_TOKEN=your_api_token)に合わせ、海外向けの値にした、この記事で組んだ例です(動作は確かめていません)。READMEのVIDU_BASE_URLの例の行は service.vidu.cn で、vidu-skillsのREADMEにはexportの行がありません。
export VIDU_TOKEN=your_token
export VIDU_BASE_URL=https://service.vidu.com
- これは、いま開いているターミナルの中だけで有効、というのが
exportの一般的な動きです(Viduの資料の記述ではありません)。ターミナルを閉じると消えるので、そのつど設定するか、自分の環境の設定ファイルに書くか、は自分で決めます。トークンを設定ファイルに書く場合は、そのファイルを人に見せない・公開のリポジトリに入れない、ことに注意してください。
Windowsでの書き方
公式の資料では確認できていません。READMEは export の形だけです。この記事の案として、PowerShellの一般的な書き方を載せます。Viduの手順ではなく、動作は確かめていません。
$env:VIDU_TOKEN = "your_token"
$env:VIDU_BASE_URL = "https://service.vidu.com"
段階7:エージェント用スキルを入れる
vidu-skillsのREADMEは、次のどちらかで入れる、と書いています。
| 入れ方 | コマンド(READMEのまま) | READMEの説明 |
|---|---|---|
npx skills |
npx skills add shengshu-ai/vidu-skills |
Claude Code、Cursor、Copilotなど40以上のエージェントに対応、と書かれている。READMEは「recommended」と書いている |
| ClawHub(OpenClawの仲間) | clawhub install github:shengshu-ai/vidu-skills |
OpenClawの環境向け |
- Vidu Agentのページには、「Install this Skills」の1文にGitHubのアドレスを添えた書き方が載っています。どこに入れる文かの説明は、読んだ範囲では確認できていません。連携の詳細は07で扱います。
- スキルがどのフォルダに置かれるか、削除の方法は、読んだ範囲では書かれていませんでした。
- スキルを入れただけでは動きません。vidu-cli(段階5)とトークン(段階3、6)が要ります。READMEの流れは「スキルを入れる → vidu-cliを入れる → VIDU_TOKENを設定する」です。
段階8:動作の確かめ方
READMEは、導入が終わったかどうかを確かめる専用のコマンドを書いていません。READMEに載っているコマンドの中で、動画を作らずに情報を返すものがあります。これを「確かめ」に使うのは、この記事の案です。
| コマンド(READMEのまま) | READMEの説明 | 期待される結果(公式の記載) |
|---|---|---|
vidu-cli quota credit |
ユーザーのクレジット残高を調べる | 出力の形は、読んだ範囲では書かれていない |
vidu-cli quota pass |
claw-passの1日の枠を調べる | 同上。claw-passが何かは、READMEに説明がない |
vidu-cli task cost --type text2video --model-version 3.2 --duration 8 |
動画のクレジット費用の見積り | 同上 |
- 失敗の形について、
references/errors_and_retry.mdは「CLIok: false」の見出しの下で、4xxのときはerror.type、code、messageを見るよう書いています。JSONの全体の形はこのファイルには書かれておらず、parameters.mdに委ねています(JSONの例は、読んだ範囲では見つかりませんでした)。トークンが間違っているときの出方も、例は確認できていません。 - クレジット残高は、Webの画面でも確かめられるはずですが、その画面の場所は、公式の資料では確認できていません。
段階9:API Platform(自分のプログラムから呼ぶ場合)
API Platform(platform.vidu.com)の文書で読めたことです。
- キーの発行画面。 文書のページ(Quickstart、キーのページ、料金)は、タイトルとナビゲーションしか取得できず、発行の手順は読めていません。vidu-s1-apiのREADMEは、キーの取得先として海外向けに https://platform.vidu.com/api-keys を挙げています(中国向けは platform.vidu.cn)。READMEは、キーと呼び出し先(ホスト)は同じ地域のものにそろえるよう書いています。
- 呼び出し先。 動画の文書では https://api.vidu.com/ent/v2/ から始まるアドレスです(例:
POST https://api.vidu.com/ent/v2/img2video)。 - 認証の書き方。 動画(画像から)とテキストからの音響効果の文書は
Authorization: Token {your api key}です。参照から動画の文書は、作る側の例はToken <YOUR_API_KEY>、結果を取る側の例はBearer <YOUR_API_KEY>と、違う書き方になっています。画像生成の文書は、Token{your api key}(空白なし)とToken {your api key}の両方が出てきます。ページはこの違いを説明していません。どれが正しいかは、公式で確認できていません。 実際の応答で確かめることになります。 - ホストの違い。 文書の例は
api.vidu.com、vidu-cliのVIDU_BASE_URLはservice.vidu.com(中国向けはservice.vidu.cn)、vidu-s1-apiのVIDU_HOSTはapi.vidu.com(中国向けはapi.vidu.cn)です。同じトークンやキーがどのホストにも通るかは、公式の資料では確認できていません。 - VIDU Token と API キーの関係。 公式の資料では確認できていません。
- S2(リアルタイム)のサンプル。 vidu-s1-apiのREADMEは、Node.js 20以上、ChromeまたはEdge、APIキー、マイクが要る、と書いています。手順は07で扱います。
たとえ話
引っ越しにたとえると、Webで使うのは「公共の施設を会員証1枚で使う」ようなもの、vidu-cliとトークンは「自分の家に専用の窓口を引いて、合鍵(トークン)で出入りする」ようなものです。合鍵を人に渡すと、その人が自分の名前で使えてしまうので、置き場所に気をつける、と考えると分かりやすくなります。これは僕らのたとえで、公式の説明ではありません。
つまずいたときの確認点
次の表のうち「公式の記載」の列は、公式のREADMEや文書に書かれていることです。「この記事の案」の列は、公式に書かれていない確認点です。
| 症状 | 公式の記載 | この記事の案 |
|---|---|---|
vidu-cli が見つからない |
READMEに記載なし | 入れたあとにターミナルを開き直す。npm install -g が成功したかを見る |
| 4xxで失敗する | errors_and_retry.md:4xxは error.type、code、message を見て、パラメータかトークンを直す。繰り返し再試行はしない |
トークンの貼り間違い(前後の空白)を疑う |
| 5xxや接続エラー | 同:1秒、2秒、4秒の間隔で最大3回まで再試行し、だめなら報告 | 回線やプロキシの設定も確かめる |
| 海外から繋がらない・認証が通らない | READMEの既定は中国向け(service.vidu.cn)。海外は service.vidu.com | VIDU_BASE_URL の値を確かめる。トークンを取ったサイト(.com か .cn)と合わせる |
Required: --voice-id |
音声合成に声のIDがない。vidu-cli task tts-voices で一覧を見て、IDを指定する |
|
ClawPassExplicitModeRequired |
--schedule-mode を省略したときに、自動で選ばれた枠を使い切った場合。自動では再試行せず、クレジットを使ってよいときだけ --schedule-mode normal |
クレジットを使うかは自分で決める |
| ログインできない・アカウントが止まった | ヘルプ:support@vidu.com に連絡 | |
| アプリが見つからない | 記載が見つからない | 公式サイトの「Get App」から探す |
気をつけること
- この記事は、実際に使って確かめた記録ではありません。コマンドは、READMEやSKILL.mdの記載を並べたものです。
- 取得したページは要約で返ってくることがあります。コマンドの文字が崩れて読めた箇所は、この記事では組み直して「公式の写し」とは書いていません。コマンドを実行する前に、各リポジトリのREADMEの原文と照らしてください。
- 読めなかったページ:API Platformの文書の入口(Quickstart)とAPIキーのページ(タイトルとメニューのみ)、API Platformの料金、モデル一覧、Vidu Agentの入口(www.vidu.com/claw、メタ情報のみ)、チュートリアル(www.vidu.com/home/tutorial、メニューのみ)、コールバック署名のページ(「Document not found」)、ストリーミング文書(メタ情報のみ)。これらは「書かれていない」ではなく「読めていない」です。
- 画面の表記は変わります。手元の画面と照らしてください。
- 無料の枠、料金、年齢などは01と04を参照してください。この記事では数字は書いていません。
- トークンとAPIキーは、パスワードと同じように扱ってください。READMEは、トークンを権限の小さいものにする、本番用を最初に使わない、と書いています。
出典
- Vidu ヘルプセンター(Vidu、確認日 2026-10-25)
- Vidu ヘルプセンター 日本語(Vidu、確認日 2026-10-25)
- vidu-skills README(GitHub shengshu-ai、確認日 2026-10-25)
- vidu-skills SKILL.md(GitHub shengshu-ai、確認日 2026-10-25)
- vidu-skills errors_and_retry.md(GitHub shengshu-ai、確認日 2026-10-25)
- vidu-skills parameters.md(GitHub shengshu-ai、確認日 2026-10-25)
- vidu-cli README(GitHub shengshu-ai、確認日 2026-10-25)
- vidu-s1-api README(GitHub shengshu-ai、確認日 2026-10-25)
- Vidu Agent(Vidu、確認日 2026-10-25)
- Vidu Q4(Vidu、確認日 2026-10-25)
- Vidu API 文書:Quickstart(入口。メニューのみ取得、Vidu、確認日 2026-10-25)
- Vidu API 文書:Image to Video(Vidu、確認日 2026-10-25)
- Vidu API 文書:Reference to Video(Vidu、確認日 2026-10-25)
- Vidu API 文書:Image Generation(Vidu、確認日 2026-10-25)
- Vidu API 文書:Audio Generation(Vidu、確認日 2026-10-25)