トークン予測ツール

Autodesk Platform Services（APS）のほとんどの API は無料で使用できますが、プレミアム API と呼ばれる一部の API（Model Derivative API、Design Automation API、Reality Capture API）が Autodesk Flex による従量課金の対象になっています。API 毎の消費トークンは、Usage Analytics ページ：Flex トークン残高と消費量の確認でご案内した Usage Analytics で把握することが出来るようになっています。

ただし、消費トークンは実際に API を使用した後でないと Usage Analytics ページには表示されないため、API の使用前に消費トークン量を理解することが難しい状態でした。今回、API の使用前に消費トークンを推測する Token Estimator -トークン予測ツール（いまのところ英語）が用意されましたので、ここでご紹介しておきたいと思います。

トークン推測ツールへは、価格ページ中段の [トークン予測] ボタンらアクセスすることが出来ます。

トークン予測ツールは、実際の運用を想定した情報を入力して、どれくらいのトークンを購入すべきか判断する意思決定を支援するツールで、プレミアム API に必要な 1 か月間の Flex トークン数を推測、表示します。API 機能の詳細を理解していなくても、このツールを使用して、必要なおおまかなトークン数を簡単に確認できます。

トークン予測ツールには 3 つのアセクションがあり、プレミアム API について、それぞれ消費トークンを算出します。

「I need to view 2D or 3D models or extract metadata（2D または 3D モデルを表示したり、メタデータを抽出する必要がある）」をクリックすると Model Derivative API
「I need to create or modify models（モデルを作成または修正する必要がある）」をクリックすると Design Automation API
「I need to generate mesh from photos/pictures」をクリックすると Reality Capture API

各 API 別にトークン消費量が推測出来れば、ボリュームディスカウントなどを活用して購入する Flex トークン数を調整することが出来て有用です。

Model Derivative API の推測

2D 図面/シートや 3Dモデルを表示したりメタデータを抽出したりする場合、Model Derivative API を使用した変換処理が必要になります。Model Derivative API は、コンプレックスジョブ毎（Revit、IFC、Navisworks ファイルの変換毎）に 0.5 トークン、シンプルジョブ毎（Revit、IFC、Navisworks ファイル以外の変換毎）に 0.1トークンが消費されます。

ただし、モデルの場所が BIM 360 Docs（BIM 360）や Fusion 360 のオートデスクのクラウドサービスストレージに保存されている場合、クラウドサービス自体の機能で表示用の変換処理が実行されるため、APS アプリ側の明示的な変化処理が不要なため、トークン消費は発生しません。

Model location では、変換対象のデザインファイルがどこに保存されているか、Model type でデザインファイルの種類、Number of models で処理するデザインファイルの数、Updates で１か月あたりの変換処理数をそれぞれ指定します。

Design Automation API の推測

デザインファイルを作成または変更する必要がある場合は、Design Automation API を使用します。消費トークンは、クラウド上で実行されるスクリプト（アドイン/プラグイン）の処理時間１時間毎に 2.0 トークンが使用されます。処理に使用する 3 つの Engine（AutoCAD、Revit、Inventor）のうちの 1 つを選択してください。あいにく、トークン予測ツールは、3ds Maxの消費トークン推測には対応していません。

各エンジン使用時の推測では、エンジン毎に既定モデルサイズと指定出来る増減間隔が設定されています。Model size で指定可能なエンジン毎の指定可能サイズの範囲と増減間隔は次のとおりです。

AutoCAD のサイズは KB 単位で、最大 10MBまで 100KB 間隔で増加します。
Revit のサイズは MB 単位で、最大 2.5GB まで 10MB間隔で増加します。
Inventor のサイズは KB 単位で、最大 100MB まで 200KB 間隔で間隔で増加します。

トークン予測には、Model complexity で指定する次のモデルの複雑さの情報も必要になります。

Super Simple（とても単純）：最小
Simple（単純）：中央値
Avrage（平均）
Complex（複雑）：上位 5 パーセント
Super complex（超複雑）：最大

よくわからない場合、あるいは判断が難しい場合には、Simple を選択してみてください。

Script/code execution では、１か月あたりの処理数を指定します。

Design Automation API の消費算出は少し複雑です。詳しい考え方は、Design Automation API の課金とコスト算出についての記事を確認してみてください。

Reality Capture API の推測

写真や画像からメッシュや点群を生成する必要がある場合は、フォトグラメトリーと呼ばれる手法を用いる Reality Capture API を使用します。トークン予測はシンプルです。Number で生成に使用する写真/画像の数と、Updates で１か月あたりの処理回数を選択するだけです。使用する 50 枚の写真/画像毎に 1.0 トークンを消費します。

各 API の予測トークン数は、 Add ボタンで使用推定を追加することが出来ます。また、予測に使用した計算単位は、右側のごみ箱アイコンで削除することが出来ます。すべての合計の１か月の予測値は、ページ右上の Monthly tokens に表示されます。

例えば、ローカルコンピュータ（Local drive）に保存されている Revit プロジェクトファイル（.rvt）10 個を１か月に 6 回、同じく、ローカルコンピュータに保存されている AutoCAD図面（.dwg）30 個を１か月に 5 回、Viewer 表示用に変換、かつ、1 MBの素材ファイルを利用/参照して Inventor エンジンで自動処理を実行すると仮定すると、合計で毎月 45.12 トークンを消費する予測結果が表示されます。