アニメーション書き出しを見積もる
POST /animation-exports/quoteの認証、フィールド、応答、エラー、安全な運用をソースから生成した参考資料です。
このページの目次
操作
POST /animation-exports/quote
operationId: quote_animation_export_v1_animation_exports_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}} |
— | Output formats and processing settings. |
metadata |
object |
いいえ | {} |
— | Simple scalar/null metadata; at most 4 KiB JSON, no credentials. |
selection |
Selection | いいえ | {"duration_seconds":null,"mode":"full","start_seconds":0} |
— | Source interval to export. |
source_video_asset_id |
string |
はい | — | format: uuid |
Owned source video asset ID, not a task ID. Reuse an existing video to avoid generating motion again. |
入れ子の全スキーマ：AnimationExportCreateRequest
リクエスト例
{
"export": {
"fps": 12,
"output_formats": [
"spritesheet",
"spritesheet_json"
],
"output_height": 512,
"output_width": 512
},
"selection": {
"duration_seconds": 2,
"mode": "range",
"start_seconds": 1
},
"source_video_asset_id": "00000000-0000-4000-8000-000000000003"
}
リクエスト例
{
"export": {
"frame_count": 24,
"output_formats": [
"frames_zip"
],
"output_height": 512,
"output_width": 512
},
"selection": {
"mode": "full"
},
"source_video_asset_id": "00000000-0000-4000-8000-000000000003"
}
応答
| 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. |
応答例
{
"breakdown": {},
"credits": 1,
"object": "quote"
}
関連ガイド
この記事は役に立ちましたか？
検索語句、コード、自由記述は収集しません。この設定はドキュメントの操作イベントのみを制御します。 プライバシーポリシー