ガイド
モデルマーケットと課金
モデルの選択、価格カードの理解、機能と可用性の確認
モデルマーケットと課金
モデルマーケットは、モデルの選択と呼び出し価格の把握のための入口であり、プラットフォームが現在公開提供しているモデルカタログを表示します。実際に呼び出せる範囲は、API Key が属する呼び出しグループとリアルタイムの利用可能状態によって決まります。
モデルの選び方
- 名前で検索するか、モデルブランド、機能、インターフェースタイプでフィルタします；
- 詳細を開き、モデルがサポートするインターフェース、利用可能なグループ、価格タイプを確認します；
GET /v1/modelsでその Key から見えるモデル ID を確認します；- 業務バックエンドで返されたモデル ID を使用してリクエストを送信します。
モデルカタログのフィールド
GET /v1/models は現在の Key で呼び出し可能なモデルを返します。フィールドの説明は次のとおりです：
| フィールド | 型 | 説明 |
|---|---|---|
data[].id | string | モデル ID。リクエスト送信時にそのまま記入します |
data[].object | string | 固定で model |
data[].created | integer | カタログ記録時刻（Unix 秒） |
data[].owned_by | string | モデルの提供元識別子。参考用 |
data[].supported_endpoint_types | string[] | そのモデルで利用可能なインターフェースタイプ |
モデルカタログは「この Key がこのモデルを呼び出せるかどうか」の確認にのみ使用します。具体的なパラメータ制限（参照画像の数、入力動画の仕様、出力の長さと解像度など）は、モデル詳細ページとインターフェースが返すパラメータエラーを基準にしてください。プラットフォームがモデルの代わりにパラメータを推測したり、サポートされていないパラメータで暗黙的にダウングレードしたりすることはありません。
価格カードの読み方
| 表示 | 意味 |
|---|---|
| 入力 / 出力 | 入力と出力の Token ごとに個別に課金され、単位は 1K または 1M Token と表示されます。 |
| キャッシュ入力 / キャッシュ書き込み | プロンプトキャッシュをサポートするモデルでのみ表示されます。 |
| 従量（回数） | 成功したリクエストごとに固定価格で課金されます。 |
| 動画従量課金 | 動画モデルは現在有効な価格で表示されます。価格が提供されていない解像度、長さ、モードは表示されません。 |
価格表示は概算用であり、実際の課金はリクエストの実際の使用量、リクエストが属するグループ、サーバー側の請求記録を基準とします。
動画モデル
doubao-seedance と seedance シリーズは独立した価格マトリクスを表示し、「動画入力の有無」と「出力解像度」で分割されます。サポートされているセルには動画費用が表示され、サポートされていない組み合わせには明確に「非対応」と表示されます。
マトリクスを読む際は、まず今回動画入力を送信するかどうかを決め、次に必要な解像度を選択します。例えばテキストや画像の参照のみをアップロードする場合は「動画入力なし」の列を、動画を入力として送信する場合は「動画入力あり」の列を確認します。隣接する区分から表示されていない価格や機能を推測しないでください。
呼び出し前に次を確認してください：
- モデル ID があなたの
/v1/modelsレスポンスに含まれている； - リクエストがテキストインターフェースではなく動画インターフェース
/v1/video/generationsを使用している； - 参照画像または参照動画がそのモデルの公開パラメータ要件を満たしている；
- 業務側で非同期タスクのために返却されたタスク ID を保存してポーリングしている。
素材参照とモデル
素材の登録はモデルとは無関係です。素材は 1 回登録するだけで済み、プラットフォームが現在のモデルに応じて対応する素材参照を準備します。同じ素材 ID を異なるモデル間でそのまま切り替えて使用でき、モデルを切り替えるにはリクエストの model フィールドを変更するだけです。
どのモデルが同じ素材ライブラリを共有するか、また実写人物素材がどのモデルをサポートするかは、素材ライブラリインターフェースを参照してください。
課金と請求
モデルマーケットに表示されるのは価格の説明であり、最終的な精算金額と同じではありません。テキストモデルは通常、実際の入力、出力、キャッシュ使用量で精算されます。画像、音声、動画モデルは、回数、長さ、またはモデル定義の計量単位で精算される場合があります。
動画などの非同期タスクは完了時に精算されます：送信が成功してもタスクを受け付けるだけで、事前に課金されません。タスク完了後、請求には実際の課金記録が 1 件だけ現れます。送信前に、プラットフォームはアカウント残高（または現在の API Key のクォータ）が今回の見積もりをカバーしているかを検証します。不足している場合は読み取り可能なメッセージを直接返し、タスクは作成されません。タスク完了後は、ウォレットまたは使用量記録でモデル、時刻、リクエスト ID、実際の課金を照合できます。
パラメータ検証の失敗（HTTP 400）はリクエストが受け付けられなかったことを意味し、通常は生成タスクの費用は発生しません。タスク ID が返された後の課金、失敗、返金のルールは、そのモデルとプラットフォームの価格設定に従って処理されます。
可用性の変化
モデルカードが表示されない、または /v1/models に特定のモデルが存在しない場合は、そのモデルが現在その Key の利用可能なカタログに含まれていないことを意味します。同種のモデルに切り替えてください。クライアント側で利用できなくなったモデル名をハードコーディングしないでください。
「利用可能なチャネルなし」「モデルは一時的に利用できません」は、現在の時間帯にそのモデルへルーティングできないことを意味し、API Key の形式エラーではありません。まずモデル一覧を更新するか、同種のモデルに切り替えてください。継続的に利用できない場合は、プラットフォームサポートに連絡し、リクエスト ID を提供してください。