課金と請求

LocoPal の残高、プラン、消費、請求はすべて LocoPal Ai のアカウントに集約されています。Creation は個別に課金されることはなく、その消費は同じアカウントにまとめて計上されます。

課金方式

モデルによって課金方式は異なります。詳細はモデルマーケットの詳細ページに表示される内容を基準にしてください。

動画モデル（doubao-seedance、seedance シリーズなど）は独立した価格マトリクスを表示し、 「動画入力の有無」と「出力解像度」で区分されます。読む際は、今回動画入力を送信するかどうかを先に確定し、 そのうえで必要な解像度を選択してください：

• テキストまたは画像の参照のみをアップロードする → 「動画入力なし」の列を確認する；
• 入力として動画を送信する → 「動画入力あり」の列を確認する；
• サポートされていない組み合わせには「非対応」と明記されます。表示されていない区分を隣接する区分から推測しないでください。

精算のタイミング

ここが最も誤解を招きやすい点です。同期インターフェースと非同期タスクを区別してください。

非同期タスクの重要な動作：

• 送信前に、プラットフォームはアカウント残高（または現在の Key のクォータ）が今回の推定消費をカバーできるか検証します。 不足している場合は読み取り可能なメッセージを直接返し、タスクは作成しません；
• タスクの実行中に中間的な課金は発生しません；
• タスク状態の照会では費用は発生せず、課金されるのはタスク作成時のみです；
• 失敗したタスクの課金は、そのモデルとプラットフォームの価格設定に従って処理されます。

残高と検証

• 呼び出し前に、プラットフォームは残高が推定消費をカバーできるか検証します。不足している場合はタスクを作成せずにメッセージを返します；
• テキストモデルの推定は入力長に基づいて見積もられ、実際の値はレスポンス内の usage を基準とします；
• 画像、動画などは回数または時間単位で課金され、推定値と実際の値は通常モデルのサポート範囲内で一致します；
• 業務のバックエンド側で残高不足に対する事前判定と分かりやすいメッセージを実装し、残高の検証を完全にプラットフォームが返すエラーに任せないことをおすすめします。

どこで照合するか

ウォレットはチャージ、プラン、特典の交換を提供し、モデルマーケットは推定価格を提供し、請求は最終的な精算を提供します。3 つの用途は異なり、 価格表示は最終的な課金と同一ではありません。

異常な課金の照合

以下の順序で特定してください。感覚で判断しないでください：

1. 期間を確定する：まず問題が発生した期間に絞り込む；
2. タスクまたはリクエストの識別子を見つける：非同期タスクはタスク ID、同期呼び出しはリクエスト ID を使用する；
3. モデルを確認する：表示名ではなくモデル ID で、どのモデルによるものかを確認する；
4. 使用量と単価を照合する：テキストは usage の入力・出力 Token を比較し、動画は解像度、長さ、入力タイプを比較する；
5. 重複送信がないか確認する：非同期タスクで最も多い異常は、単価の誤りではなくタスクを 1 回多く作成してしまうことです。

上記の特定を完了したうえで、これらの情報を添えてプラットフォームサポートに連絡してください。完全なキーは提供しないでください。

消費の抑制

• アプリケーションごとに Key を分ける：本番サービス、テスト環境、顧客向けアプリケーションをそれぞれ作成し、消費の発生元を特定しやすくする；
• Key にクォータと有効期限を設定する：異常な消費の影響範囲を限定する；
• 適切なモデルを選ぶ：同じタスクでもより小さなモデルを使うと、コストを大幅に削減できることが多い；
• 重複送信を避ける：非同期タスクはタスク ID を保存し、再作成ではなく照会で進捗を追跡する；
• 結果を速やかに保存する：画像や動画の返却アドレスは短期間で失効する可能性があり、失効後は再生成が必要です。

よくある誤解