アニメーションを見積もる

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

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

このページの目次

操作

POST /animations/quote

operationId: quote_one_click_animation_v1_animations_quote_post

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

認証と副作用

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

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

パラメータ

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

リクエスト本文 (application/json)

本文必須：true

フィールド	型	必須	既定値	制約	説明
`export`	ExportOptions	いいえ	`{"fps":null,"frame_count":24,"output_formats":["spritesheet"],"output_height":512,"output_width":512,"transparent":{"enabled":false},"unity":{"pivot":"bottom_center","pixels_per_unit":100}}`	—	Export after video generation. Alpha-bearing formats require an alpha_key source; compatible formats automatically enable its transparent export.
`input`	GenerationInput	はい	—	—	Images owned by the caller or supplied for this generation.
`metadata`	`object`	いいえ	`{}`	—	Caller metadata: simple string/number/boolean/null values, at most 4 KiB JSON. Do not store secrets.
`negative_prompt`	`string`	いいえ	`""`	`maxLength`: `4000`	Optional exclusions, only when the model supports negative prompts.
`prompt`	`string`	いいえ	`""`	`maxLength`: `8000`	Motion instruction; nonempty when the model requires a prompt. Keep private prompts out of logs.
`selection`	Selection	いいえ	`{"duration_seconds":null,"mode":"full","start_seconds":0}`	—	Interval selected after generation; full by default.
`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}`	—	Model-compatible generation settings.

入れ子の全スキーマ：AnimationCreateRequest

リクエスト例

json

{
  "export": {
    "frame_count": 24,
    "output_formats": [
      "frames_zip"
    ],
    "output_height": 512,
    "output_width": 512
  },
  "input": {
    "first_frame": {
      "file_id": "00000000-0000-4000-8000-000000000001",
      "type": "file"
    }
  },
  "prompt": "A character runs in place, side view, fixed camera.",
  "selection": {
    "mode": "full"
  }
}

応答

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"
}

この記事は役に立ちましたか？

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

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

お困りですか？サポートへ

ドキュメントを検索