GLB→VRM変換API — 3回の呼び出しで.glbを話せるVRM 1.0に

人型キャラクターの.glbファイル(リグの有無は問いません)をアップロードすると、ボーンがマッピングされ、会話や瞬きをする顔を持つVRM 1.0をダウンロードできます。UnityもBlenderも、人手による作業も一切不要です。

APIキーを取得 モデル1体につき10 APIトークン・.glbは最大100MB、リグの有無は不問

プログラムでGLBをVRMに変換するには、APIキーを使用して.glb(最大100MB)をhttps://app.riggle3d.com/api/v1/conversionsにPOSTし、3~5秒ごとにGET /conversions/{id}をポーリングし、ステータスがsucceededになったらGET /conversions/{id}/vrmをダウンロードします。結果として、人型ボーン、5種類の口パク(viseme)、瞬き、3種類の感情表現、そしてリグに目ボーンがある場合はlookAt機能を持つVRM 1.0が、1~3分で自動的に構築されます。これは、GLBにスケルトンや表情シェイプがない場合でも同様です。料金は10 APIトークン(パックに応じて1.00ドルから1.50ドル)で、変換に失敗した場合はトークンが返却されます。

3つのAPIコール

export RIGGLE_API_KEY=rgl_...
API=https://app.riggle3d.com/api/v1

# 1. start a conversion (10 API tokens)
id=$(curl -s -X POST $API/conversions \
  -H "Authorization: Bearer $RIGGLE_API_KEY" \
  -F file=@character.glb | jq -r .id)

# 2. poll until it is no longer processing
until [ "$(curl -s $API/conversions/$id \
  -H "Authorization: Bearer $RIGGLE_API_KEY" | jq -r .status)" != processing ]
do sleep 4; done

# 3. download the VRM
curl -s -o character.vrm $API/conversions/$id/vrm \
  -H "Authorization: Bearer $RIGGLE_API_KEY"

インテグレーションの全体像は、作成、ポーリング、ダウンロードの3ステップです。各フィールド、変換オブジェクト、すべてのエラーについてはAPIリファレンスで、依存関係のないPythonおよびNodeクライアントはgithub.com/riggle3d/glb-to-vrmでご覧いただけます。

ポーリング中、stageは変換の進捗状況を示します。rigging(GLBにスケルトンがなかった場合のみ)、marking_face、そしてbuilding_vrmの順に進みます。

自社での構築が難しい理由

VRMはglTFに拡張機能を加えたものなので、コンテナを記述すること自体は簡単です。時間がかかるのは、拡張機能が記述するすべての要素です。

  • 人型ボーン。 VRMは、どの関節がhipsでどれがleftUpperArmであるかを知る必要がありますが、Mixamo、Tripo、VRoid、Character Creator、ゲームリグ、あるいは実用的な名前が全くないリグなど、ソースごとにボーンの命名規則や配置が異なります。
  • VRM 1.0の表情。 ファイルにはaa、blink、happyなどが必要です。AIジェネレーターや自動リギングツールで生成されたGLBには、表情シェイプが一つも含まれていないことがほとんどで、名前を付ける対象がありません。
  • 口パク(viseme)には開く口が必要。 口を閉じた状態で作成されたモデルには口の開口部が全くなく、顔の下半分全体を動かすと不自然に見えます。
  • 動作確認。 表情データがファイルに存在していても、画面上では何も動かないことがあります。

本APIは、代わりに完成したファイルを提供します。GLBにスケルトンや表情シェイプがあったかどうかに関わらず、ボーンが正しく設定され、会話、瞬き、感情表現ができる顔を持つVRM 1.0と、それを確認するためのプレビュー動画が手に入ります。

送信するものと取得するもの

入力: 人型キャラクターの.glbファイル1つ(最大100MB)を、マルチパートフィールドfileとして送信。リグの有無は不問。オプションでnameフィールド、およびリトライしたリクエストが二重に課金されないようにするためのIdempotency-Keyヘッダーが利用可能です。

出力: 人型ボーン、口パク(viseme)aa ih ee oh ou、blink、blinkLeft、blinkRight、happy、angry、surprised、そしてリグに目ボーンがある場合はlookAt機能を持つVRM 1.0。すべての表情を再生するpreview.mp4。preview_imagesにリストされた静止画。そしてwarnings。

warningsを必ず確認してください。リストが空の場合は、特に問題は見つからなかったことを意味します。警告がある場合は、アバターは構築されたものの、プレビューを確認すべきことを示します。例えば、顔の検出の信頼度が低い、あるいは口パクの動きがほとんどない、といったケースです。口の品質はモデルに依存します。口を開いた状態でモデリングされたキャラクターは、最も自然な口の形になります。口を閉じたモデルでは、動きがよりソフトになります。

料金

パックAPIトークン数価格GLB変換あたりの料金
スターター100$15$1.50
ビルダー500$60$1.20
スケール2,500$250$1.00

GLBからVRMへの変換1回につき、10 APIトークンを消費します。ポーリング、VRMのダウンロード、プレビュー、削除は無料です。トークンに有効期限はなく、変換に失敗した場合は自動的に返却されます。無料のAPIトークンはありません。APIキーはパックを購入すると有効になります。

対象となるお客様

  • AIアバターおよびコンパニオンアプリ。 ユーザーが持ち込んだ、あるいは生成したキャラクターを、アプリでTTS(テキスト読み上げ)に合わせてリップシンクさせる必要があります。GLBを送信し、VRMを保存し、音声からaa ih ee oh ouを駆動させます。
  • VTuber向けツール。 インポート時にあらゆる人型のGLBを受け入れ、すでに瞬きや会話ができるアバターをユーザーに提供できます。
  • ゲームおよびキャラクターパイプライン。 キャラクターのライブラリをVRM 1.0に一括変換できます。1アカウントあたり同時に3つまで処理可能です。
  • 3Dジェネレーター。 すでにGLBを生成している場合、1回のリクエストでその横に「VRMとしてエクスポート」ボタンを追加できます。

手動で1つのモデルを変換したい場合は、ブラウザで同じ処理ができるGLB to VRM コンバーターをご利用ください。モデルではなく画像から始めたい場合は、Image to VRM APIをご覧ください。すでに顔が動かないVRMをお持ちの場合は、API経由で口パクと瞬きを追加する方法をご覧ください。

APIで最初のGLBを変換する

キーを作成してパックを購入しましょう。料金はモデル1体につき10 APIトークンで、変換に失敗した場合は返却されます。

APIキーを取得

クリエイターからよくある質問

GLBにリグは必要ですか?

いいえ。スケルトンがないGLBでも動作します。Riggleがスケルトンを追加し、その間stageはriggingと表示されます。料金は同じく10 APIトークンです。

私のGLBにはブレンドシェイプがありません。それでもVRMは会話できますか?

はい、本APIはそのようなケースのために構築されています。VRMは口パク、瞬き、感情表現付きで返されるため、GLB自体に表情シェイプは必要ありません。

変換にはどのくらい時間がかかりますか?

リグ付きモデルの場合、1~3分です。3~5秒ごとにGET /conversions/{id}をポーリングしてください。Webhookはありません。

モデル1体あたりの料金はいくらですか?

10 APIトークンです。スターターパック(100トークンで15ドル)では1.50ドル、ビルダーパック(500トークンで60ドル)では1.20ドル、スケールパック(2,500トークンで250ドル)では1.00ドルになります。変換に失敗した場合はトークンが返却されます。

.gltf、FBX、またはURLを送信できますか?

いいえ。APIが受け付けるのは、リクエストでアップロードされた単一の.glbまたは.vrmファイルのみです。送信前に、.gltfを.binやテクスチャと一緒に1つの.glbにパックし、FBXは.glbにエクスポートしてください。

VRM 0.x形式で出力できますか?

いいえ、VRM 1.0のみです。

変換に失敗した場合はどうなりますか?

変換のステータスがfailedになり、error.codeがconversion_failed、そしてメッセージが表示されます。消費された10トークンは自動的に返却されます(refundedがtrueになります)。

一度に多くのGLBを変換できますか?

1アカウントあたり同時に最大3つの変換を実行できます。残りは貴社側でキューに入れ、1つが完了したら次を開始してください。4つ目のリクエストは429 too_many_activeエラーになります。

クライアントライブラリはありますか?

パッケージとしてはありません。github.com/riggle3d/glb-to-vrmに、プロジェクトにコピーして使える依存関係のないPythonクライアントとNodeクライアント、およびcurlの例があります。

ガイド