크레딧 및 사용
청구 가능한 서비스는 계정 크레딧으로 정산됩니다. 금액은 밀리크레딧(millicredits) 단위로 표시되며, 1000 밀리크레딧은 1 크레딧과 같습니다. 요청에 포함하는 금액은 정수여야 하며, 잔액 및 기록에 표시되는 금액은 소수점 한 자리(0.1 밀리크레딧)까지 허용됩니다. 응답에서의 credit_precision 값은 4이며, 이는 크레딧으로 변환된 후 최대 소수점 네 자리까지 표시됨을 의미합니다.
잔액 확인
섹션 제목: “잔액 확인”GET /api/v1/billing/credits/balancecurl https://omnidoc.top/api/v1/billing/credits/balance \ -H "X-API-Key: $OMNIDOC_API_KEY"주요 필드:
| 필드 | 의미 |
|---|---|
available | 부채를 갚은 후 현재 사용 가능한 밀리크레딧; 부채가 있을 경우 음수 |
debt | 밀리크레딧 기준 부채: 완료된 작업의 실제 비용 중 잔액을 초과한 부분입니다. 이후에 입금되는 크레딧(충전금, 일일 지원금, 교환 코드, 환불 등)은 먼저 부채를 상환합니다. |
spent | 총 정산된 밀리크레딧 |
expired | 만료되었거나 회수된 밀리크레딧 |
today_charged | 오늘 정산된 밀리크레딧 |
lots | 현재 유효한 크레딧 로트 및 만료일 |
크레딧 팩
섹션 제목: “크레딧 팩”GET /api/v1/billing/credits/plans로그인 없이 사용할 수 있으며 판매 중인 팩(purchase_plans, 플랜 코드 기준)을 반환하는 공용 엔드포인트입니다. 현재 판매 중:
| 플랜 코드 | 크레딧 | 가격 | 보너스 |
|---|---|---|---|
credits_3000_v4 | 3,000 | ¥9.90 | — |
credits_10000_v4 | 10,000 | ¥29.90 | — |
credits_25000_v4 | 25,000 | ¥69 | 8% |
credits_50000_v4 (권장) | 50,000 | ¥129 | 16% |
credits_125000_v4 | 125,000 | ¥299 | 25% |
credits_450000_v4 | 450,000 | ¥999 | 35% |
- “보너스”는 ¥29.90에 대한 10,000 크레딧 가격을 기준으로 계산되며
bonus_percent필드입니다. 권장 팩에는recommended: true이 있습니다. 설정되지 않은 경우 두 필드 모두 표시되지 않습니다. price_fen(분, 1/100 위안)은 가격 기준으로 권위를 가지며,total_millicredits(밀리크레딧)은 크레딧 기준으로 권위를 가집니다. 구매한 크레딧은 만료되지 않으며, 팩은 다시 구매할 수 있고 매번 한 번에 도착합니다.
충전 수명 주기
섹션 제목: “충전 수명 주기”- 작업이 시작되기 전에 잔액이 임계값과 비교됩니다 : 부채를 제외한 잔액은 작업의 임계값을 초과해야 하며, 예를 들어 PDF 번역의 경우 “페이지 수 × 2 크레딧”, 다른 파일의 경우 원본 텍스트 길이(최소 2 크레딧), 그리고 오디오, 비디오 및 음성의 경우 서버가 측정한 지속 시간 또는 문자 수로 계산된 비용( 오디오, 비디오 및 음성 에서의 가격)입니다. 예산이 설정된 API 키의 경우, 해당 키의 남은 예산도 임계값을 넘어야 합니다. 그렇지 않으면 응답은
402이며(quota_exceeded=true와 함께 파일 번역 작업이 실패로 종료되고,error_code=insufficient_credits과 함께 미디어 작업이 종료됨) 비용은 청구되지 않습니다. 작업을 시작해도 잔액에는 영향을 주지 않습니다. - 실제 사용량은 작업 완료 시 청구됩니다 : 파일 번역(이미지 포함), 배치 리치 텍스트, 문서 작업, 오디오, 비디오 및 음성은 작업 완료 시 실제 사용량에 대해 전액 청구됩니다. API 키의 예산은 시작 전 확인에만 적용되며 완료된 작업에 대한 요금을 감면하지 않습니다. 키의 사용 예산이 한도를 초과하면, 한도가 상향 조정될 때까지 해당 키로 새로운 작업을 시작할 수 없습니다. 실패하거나 취소된 작업에는 요금이 부과되지 않습니다.
- 잔액이 마이너스로 전환될 수 있습니다 : 실제 비용 중 잔액을 초과하는 부분은 부채로 기록되며, 이때 잔액은 음수로 표시됩니다. 이후 입금되는 크레딧은 먼저 부채를 상환합니다. 잔액이 음수인 동안에는 새로운 작업을 시작할 수 없으며, 잔액을 충전해야 합니다.
클라이언트는 “얼마를 청구해야 하는지”를 제출하지 않으며, 서버는 제공된 내용을 기반으로 정산 금액을 계산합니다.
작업 및 기록
섹션 제목: “작업 및 기록”GET /api/v1/billing/credits/operations?limit=20GET /api/v1/billing/credits/operations/{operation_id}GET /api/v1/billing/credits/jobs/{job_id}레코드에는 작업 ID, 상태, 청구 기준 및 부과된 금액과 환불된 금액이 포함됩니다. API 키와 함께 나열될 때, 작업은 해당 키로 시작된 작업만 포함합니다.
사용법
섹션 제목: “사용법”GET /api/v1/usage?limit=50GET /api/v1/usage/summary사용 엔드포인트는 계정의 파일 수, 문자 수, 토큰 수 및 처리 시간을 반환합니다.
쿼리 사용은 무료입니다.
섹션 제목: “쿼리 사용은 무료입니다.”잔액, 작업 상태, 사용량, 정산 기록, 결과 목록 및 다운로드 주소를 확인하는 데는 크레딧이 소모되지 않습니다.