動画生成を見積もる

POST /video-generations/quoteの認証、フィールド、応答、エラー、安全な運用をソースから生成した参考資料です。

公開ベータAPI v1 · 1.4.0最終確認 2026-09-15

このページの目次

操作

POST /video-generations/quote

operationId: quote_video_generation_v1_video_generations_quote_post

制作やクレジット消費を始めずに、意図した操作の費用を見積もります。価格固定でも支出承認でもありません。作成時に現在の額が再計算されるため、送信前に確認してください。後のリクエストと価格に関係する設定を一致させます。

サーバー側のBearer APIキーを使います。必要な権限：animations:write

有料生成は始めません。ほかの状態変更は上記を確認してください。

パス、クエリ、操作固有のヘッダーパラメータはありません。

本文必須：true

フィールド	型	必須	既定値	制約	説明
`has_last_frame`	`boolean`	いいえ	`false`	—	Whether the planned request includes a last frame.
`reference_image_count`	`integer`	いいえ	`0`	`minimum`: `0`; `maximum`: `8`	Number of additional references, excluding the first frame.
`video`	VideoOptions	いいえ	`{"duration_seconds":null,"input_canvas":null,"model":null,"ratio":null,"resolution":null,"seed":null,"style_preset":null,"transparency":{"key_color":null,"key_selection":"auto","mode":"standard"},"watermark":null}`	—	Generation options to estimate; must match the later create.

入れ子の全スキーマ：VideoGenerationQuoteRequest

json

{
  "has_last_frame": false,
  "reference_image_count": 0,
  "video": {}
}

HTTP	本文	説明
`200`	QuoteResponse	Successful public response. Example values are illustrative.
`400`	APIErrorEnvelope	Invalid input; correct the request before retrying.
`401`	APIErrorEnvelope	Missing, expired, or revoked API key.
`402`	APIErrorEnvelope	Insufficient credits; do not automatically purchase.
`403`	APIErrorEnvelope	Account eligibility, account status, or key scope does not allow this operation.
`404`	APIErrorEnvelope	Resource is unavailable, not owned, or its signature is invalid/expired.
`413`	APIErrorEnvelope	Request or decoded image exceeds the configured limit.
`415`	APIErrorEnvelope	Use supported image media types.
`422`	APIErrorEnvelope	Decoded image dimensions exceed the allowed size.
`429`	APIErrorEnvelope	Account-wide rate or queue limit; wait for Retry-After.
`500`	APIErrorEnvelope	Internal failure; preserve the task/key and retry only when marked retryable.
`503`	APIErrorEnvelope	Service/provider unavailable; retry only when error.retryable is true.

HTTP	ヘッダー	型	説明
`429`	`Retry-After`	`integer`	Suggested wait in seconds; respect the server value and an overall deadline.
`503`	`Retry-After`	`integer`	Suggested wait in seconds; respect the server value and an overall deadline.

json

{
  "breakdown": {},
  "credits": 1,
  "object": "quote"
}

ドキュメントの利用状況解析を許可

検索語句、コード、自由記述は収集しません。この設定はドキュメントの操作イベントのみを制御します。プライバシーポリシー