동영상 생성 견적
POST /video-generations/quote의 인증, 필드, 응답, 오류, 안전한 운영을 원본에서 생성한 레퍼런스입니다.
이 페이지의 내용
작업
POST /video-generations/quote
operationId: quote_video_generation_v1_video_generations_quote_post
제작·크레딧 사용 없이 의도한 작업의 비용을 추정합니다. 가격 고정이나 지출 승인이 아닙니다. 생성 시 현재 금액을 재계산하므로 제출 전에 확인하세요. 이후 요청과 가격 관련 설정을 일치시키세요.
인증 및 부수 효과
서버 측 Bearer API 키를 사용하세요. 필요한 권한: animations:write
유료 생성을 시작하지 않습니다. 다른 상태 변경은 위 설명을 확인하세요.
매개변수
경로·쿼리·작업별 헤더 매개변수가 없습니다.
요청 본문 (application/json)
본문 필수: 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
요청 예제
{
"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. |
응답 예제
{
"breakdown": {},
"credits": 1,
"object": "quote"
}
관련 가이드
이 문서가 도움이 되었나요?
검색어, 코드 또는 자유 입력 텍스트는 수집하지 않습니다. 이 설정은 문서 상호작용 이벤트만 제어합니다. 개인정보 처리방침