クエリの数え方

計算エンジンへの1回の計算は、外箱1つと荷物の組1つでできています。答えは次の4つのどれかで、どれでも1クエリです。

• 詰められます（SUCCESS）
• 入りきりません（UNABLE）
• 詰め方が見つかりませんでした（FAILED）
• 時間内に詰め方が見つかりませんでした（TIMEOUT）

括弧の中は、APIの応答のstatusです。

同じ荷物の組を、外箱を変えて試すと、外箱1つにつき1回計算します。入らなかった外箱の計算も数えます。

箱詰めアプリでは、試すリストに入れた外箱1つにつき1回計算します。同じ寸法の外箱を2行試せば、それぞれ計算して2クエリです。

荷物の組を変えて送り直すと、送るたびに1回計算します。「どの荷物を減らせば入るか」を計算エンジンが探すことはないので、減らし方を変えて試した回数だけクエリを使います。

同一複数箱箱詰め計算API（同じ外箱を必要なだけ使って詰める）は、1回の要求の中で、外箱1個ぶんずつ計算を繰り返し、入りきらなかった荷物を次の同じ外箱へ回します。数えるのは計算した回数なので、1回の要求で何クエリ使うかは、詰め切るまで分かりません。

• 外箱N個で詰め切れば、Nクエリです。
• どの向きでも外箱に入らない荷物があると1回目で分かれば、外箱0個でも1クエリです。荷物を1個も置けなかった計算も、1クエリと数えます。
• 外箱の数の上限や、使える回数の上限に達して途中で止まれば、それまでに計算した回数だけ数えます。答えがERROR・NOTAUTHORIZED・TIMEOUTでも、それまでの計算は数えます。

数えるもの

• 全部の荷物を詰める詰め方が見つかった計算（SUCCESS）
• 外箱に入らないと分かった計算（UNABLE）
• 試し終えたが、全部を詰める詰め方が見つからなかった計算（FAILED）
• 時間内に詰め方が見つからなかった計算（TIMEOUT）
• 通信が切れて答えを受け取れなかったが、計算は終わっていたもの

数えないもの

• 入力の誤り（形・寸法・IDなど）で、計算の前にエラーを返した要求
• 使える回数の上限や契約の状態で、計算の前に止めた要求（NOTAUTHORIZED）
• 混み合っていて、計算の前にエラーを返した要求
• 計算エンジンの側でエラーになった計算
• 箱詰めアプリで、上限に達したあと送らなかった外箱（「計算しませんでした」と出ます）
• 箱詰め画像生成APIで画像を作る呼び出し

• 使える回数には、組織ごとの上限と、トークンごとの上限があります。1クエリは両方に数え、どちらかに達すると、計算できなくなります。
• ログインせずに使うときの上限は同じIPアドレスごとに、公開APIの上限は試す方全員の合計で数えます。
• 使った回数は、決まった期間ごとに0に戻ります。期間の長さは上限ごとに違います。ご自分の期間は、箱詰めアプリの残り回数や、プランの価格表に出ています。