오디오, 비디오 및 음성
미디어 작업은 생성되는 즉시 실행되며, 서버가 측정한 사용량에 대해 크레딧 가격으로 청구됩니다. 먼저 카탈로그를 확인하십시오; 열려 있는 것으로 표시된 제품만 실행할 수 있습니다.
가격은 크레딧 단위로 직접 표시됩니다:
| 제품 | product | 가격 |
|---|---|---|
| 음성 인식 | asr | 20 크레딧/분; fun-asr 실시간 모델은 30 크레딧/분(밀리초 단위로 과금) |
| 부제목 번역 | subtitle_translation | 60 크레딧/분 |
| 기본 영상 처리(번역된 자막, 원본 오디오) | basic_video | 80 크레딧/분 |
| 전체 영상 처리(번역된 자막 및 더빙) | full_video | 300 크레딧/분 |
| 음성 합성 | tts | 청구 문자 10,000자당 1,500 크레딧 |
| 음성의 첫 성공적 사용 | — | 음성당 300 크레딧, 단 한 번 부과 |
- 음성 인식은 사용되는 인식 모델에 따라 가격이 책정되며, 두 모델의 가격은
credit-catalog의prices(model필드)에 각각 별도로 표시되어 있습니다. - 지속 시간은 밀리초 단위로 계산됩니다. 음성 인식 및 자막 번역은 원본 지속 시간을 기준으로 하며, 동영상은 전송된 동영상의 지속 시간을 기준으로 합니다.
- 음성 합성의 청구 문자 수: 중국어 한자는 2로 계산되며, 그 외 모든 문자(공백 및 구두점 포함)는 1로 계산됩니다.
- 제품에 필요한 인식, 번역, 더빙 등의 모든 단계는 가격에 포함됩니다. 요청이 하위 등급 결과(
allowed_fallback_products)를 허용하고 해당 결과가 제공되는 경우, 제공된 제품의 가격이 적용됩니다. - 비용 = 단가 × 사용량, 0.001 크레딧(1 밀리크레딧)로 반올림합니다.
GET /api/v1/billing/media/credit-catalogPOST /api/v1/billing/media/credit-estimatescredit-catalog는 각 제품의 가격(prices, 밀리크레딧 단위)과 사용 가능 여부를 반환합니다. credit-estimates은 주어진 지속 시간, 텍스트 또는 음성 수에 대해 필요한 크레딧(rounded_millicredits)을 계산합니다. 이는 단순히 표시용으로만 사용되며, 작업을 생성하거나 비용을 청구하지 않습니다.
작업 생성
섹션 제목: “작업 생성”POST /api/v1/media-jobsIdempotency-Key: unique-request-id제품:
product | 목적 |
|---|---|
asr | 음성 인식 |
tts | 음성 합성 |
subtitle_translation | 오디오 및 비디오의 자막 번역 |
basic_video | 기본 영상 처리 |
full_video | 전체 비디오 처리 |
음성 인식 예시:
{ "product": "asr", "document_id": "4q8mx2q9z1k7p6ra", "source_language": "auto", "max_duration_ms": 600000}음성 합성(tts)을 제외한 모든 제품은 max_duration_ms(밀리초, 최대 21600000, 즉 6시간)이 필요합니다.
생성 요청이 202를 반환한 후, 서버는 파일을 확인하고 처리를 시작합니다:
- 시작 전에 잔액만 확인됩니다 : 잔액(부채 차감 후)은 서버가 측정한 기간으로 계산된 비용(음성 합성의 경우, 아직 청구되지 않은 최초 사용 음성 요금을 포함한 청구 문자 수 기준)보다 높아야 하며, 예산이 설정된 API 키의 경우 해당 키의 남은 예산도 이 비용보다 높아야 합니다. 시작 여부는 잔액에 영향을 미치지 않습니다.
- 실제 사용량은 완료 시 청구됩니다 : 제공된 제품 및 사용량에 따라 가격이 책정되고 청구됩니다. 잔액으로 충당되지 않는 부분은 부채로 기록되며, 잔액은 음수로 표시됩니다. 이후 입금되는 크레딧은 먼저 부채를 상환합니다. 잔액이 음수인 동안에는 새로운 작업을 시작할 수 없습니다.
- 실패하거나 취소된 작업에는 비용이 청구되지 않습니다.
잔액이 부족하거나 지속 시간이 맞지 않을 경우, 작업이 시작되지 않으며 요금도 부과되지 않습니다. 음성 합성은 생성 시 검증되며 잔액이 부족할 경우 402를 반환합니다. 다른 제품은 서버가 지속 시간을 측정한 후에 검증되며, 작업은 error_code insufficient_credits(잔액 부족) 또는 media_duration_exceeds_confirmed_cap(실제 지속 시간이 max_duration_ms 초과)로 실패 상태로 종료됩니다.
쿼리 및 취소
섹션 제목: “쿼리 및 취소”GET /api/v1/media-jobs/{operation_id}GET /api/v1/media-jobs?limit=25POST /api/v1/media-jobs/{operation_id}/cancel쿼리 응답에는 작업 상태, 전송된 파일 및 정산 참조가 포함됩니다.
GET /api/v1/media-voicesPOST /api/v1/media-voicesGET /api/v1/media-voices/{asset_id}POST /api/v1/media-voices/{asset_id}/confirmPOST /api/v1/media-voices/{asset_id}/reconcilePOST /api/v1/media-voices/{asset_id}/revokereconcile는 불확실한 원격 결과를 복구하며, 원래 작업만 확인하고 두 번째 음성을 생성하지 않습니다.
음성 생성을 위해서는 해당 녹음에 대한 귀하의 권리를 확인해야 합니다:
{ "document_id": "authorized_recording_document_id", "consent": true, "consent_version": "voice-source-rights-v1"}발신자는 녹음본이 본인 소유이거나 적법한 허가를 받아 사용된 것인지 확인할 책임이 있습니다.