2025年12月8日のビジネスモデルの導入で、消費トークンが変更されています。改訂されたトークン数は、API レート シート ページでご案内しています。
Automation API への課金は、Model Derivative API とは異なり、（変換の）回数ではなく、処理時間（Processing Minutes）が計測の単位になっています。
計測方法は？
それでは、この課金方法となるコアエンジンの「処理時間（Processing Minutes）」とは、具体的にどのように計測しているのでしょうか？
Automation API への課金時間は、処理時に実行されることになる WorkItem（ワークアイテム）の成功時の処理時間（秒数）に基づいて算出されています。 WorkItem の処理が完了すると、onComplete コールバック、または、GET Workitem のレスポインスに開始時刻と終了時刻が次のようにレポートとして記されます。
“timeQueued”: “2019-11-13T20:22:26.1972643Z”,
“timeDownloadStarted”: “2019-11-13T20:22:25.587368Z”,
“timeInstructionsStarted”: “2019-11-13T20:24:01.3217437Z”,
“timeInstructionsEnded”: “2019-11-13T20:24:35.4545907Z”,
“timeUploadEnded”: “2019-11-13T20:26:03.3608278Z”,
コストの算出に必要な数値は、timeDownloadStarted と timeUploadEnded の値です。 この例では、合計時間は 217 秒になり、この時間に相当するトークンが、お手持ちのトークン残高から減算されることになります。
AutoCAD Automation API の場合、12分間（720,000ミリ秒）で1トークン消費されるため、720,000ミリ秒に達しないと1トークン消費にカウントされない点にご注意ください。（無料サブスクリプション利用時のように、毎月リセットされることはありません。）
処理時間は計測システムに蓄積されていますので、総処理時間が720,000ミリ秒に達すると、1トークンの消費が 概要 タブのトークンの使用状況に反映されることになります。
- ご参考：APS 使用状況レポート
ファイルのダウンロード時間とアップロード時間？
レポートには、ファイルのダウンロードやアップロードにかかった正確な時間も表示されるはずです。ここで注意していただきたいのは、AppBundle（アプリバンドル ＝ コアエンジンにロード・実行させるアドイン パッケージ）が、WorkItem が実行時に使用する 素材ファイルのダウンロードと、成果ファイルのアップロードにかかる時間もカウントされる点です。
素材ファイルのダウンロードと成果ファイルのアップロードには、任意に用意したクラウド ストレージを利用することになりますが、どのストレージをどのように選択するかによって、課金対象となる WorkItem の処理時間に影響を与える可能性があります。
オートデスクがテストした限りでは、主要な AWS S3、Azure Blob Storage、OSS（Forma Data Management でも使用）では、大きな違いはありませんでした。世界中のさまざまな地域にホストされているファイルでテストしましたが、結果は同様です。ただし、インターネットトラフィックによる変動が大きくなっています。例えば、400MBファイルのテストでは、ファイルを Automation API サーバーにダウンロードするのに約 30 〜 40 秒かかり、ファイルを開いて操作を開始するのに 3 〜 4 秒かかりました。
オンプレミスなサーバーとともにファイルのダウンロードやアップロードをおこなう場合や、非常に大きなファイルを扱う場合などは、さらに時間を要することが予想されます。出来れば、より高可用性なストレージの利用をご検討いただくことをお勧めします。
もう一点、考慮すべき点があります。ストレージ サービス利用時のファイル転送のコストです。 少なくとも、ファイルが OSS Bucket や Forma Data Management、Fusion などにホストされている場合には、それらのアクセス（ダウンロード/アップロード）に費用はかかりません。
実行に 1 時間必要なアドイン アプリケーションの単一処理というのは、一般的に、あまり多くない印象がありますが、WorkItem 内でクラウドストレージからの素材ファイルのダウンロードと成果物となるファイルの保存（アップロード）に要する時間も、トークンによる課金対象となっていますのでご承知おきください。
By Toshiaki Isezaki
You must be logged in to post a comment.