가격

모든 모델의 가격은 모델 제작자가 청구하는 금액과 정확히 동일하며 미국 달러로 표시됩니다. 비용은 API 잔액에서 지불하며 API 크레딧으로 계산됩니다: 1,000 API 크레딧 = $1. API 잔액은 Doitong 앱의 크레딧과 별도의 독립적인 잔액입니다. 플랜, 최소 금액 또는 모델별 수수료는 없습니다. 호출이 수락되면 해당 가격이 API 잔액에서 차감됩니다.

러시아에서는(doitong.ru, api.doitong.ru 또는 ?currency=rub) 가격이 루블로도 표시됩니다. USD 가격 × USD/RUB 환율 × 1.3입니다.

단위#

각 모델에는 페이지와 GET https://api.doitong.com/v1/models/{model_id}에 표시되는 청구 단위가 하나씩 있습니다.

가격 = 수량 × 단위당 API 크레딧이며, 1 API 크레딧 단위로 올림됩니다($0.001). 최저 금액은 1입니다. 매우 저렴한 단위는 단위당 소수 가격을 가질 수 있습니다(0.4 API 크레딧/초). 올림은 호출 전체 금액에만 적용됩니다.

일부 모델은 입력에 따라 다른 요율을 적용합니다. 예를 들어 소리가 있는 동영상은 없는 동영상보다 비싸고, 4K는 1K보다 비쌉니다. 이러한 규칙은 각 모델 페이지에 나열됩니다. 생략한 매개변수는 기본값으로 계산되므로 입력에 표시된 가격이 실제 지불 가격입니다.

정확한 가격, 측정 가격, 추정 가격 및 사용량 기준 가격#

모든 가격에는 mode가 있습니다.

• exact: 가격이 입력에서 계산됩니다(초, 이미지, 메가픽셀, 문자, 단계 또는 동영상이나 호출당 고정 가격).
• measured: 가격이 전송한 파일에 따라 결정됩니다. 입력 동영상 또는 오디오의 길이, 입력 이미지의 크기, 동영상의 프레임 속도 또는 프레임 수를 기준으로 합니다. 업스케일러, 립싱크, 동영상 변환, 전사 및 오디오 도구가 이 방식으로 가격이 책정됩니다. 실행 전에 API가 파일의 길이, 해상도 및 프레임 속도를 읽으므로(견적도 동일하게 처리함) 견적은 실행 시 청구되는 금액과 정확히 같습니다. 모델 페이지에는 결제 기준(“입력 동영상의 초당 가격”)이 표시되고 계산기는 파일의 수치를 사용합니다. 읽을 수 없는 파일은 unmeasurable_input으로 거부되며 요금이 부과되지 않습니다.
• estimate: 모델 자체의 비용이 입력으로 미리 알 수 없는 항목(토큰, 처리 시간)에 따라 달라집니다. 이러한 모델은 실제 실행의 평균 비용으로 정한 실행당 고정 추정 가격을 청구합니다(이미지 수가 있는 경우 출력 이미지당). 실행 전에 가격을 알 수 있으며, 견적이 실제 지불 금액입니다.
• metered: 모델은 실제 사용량 기준으로 청구되며, 사용량은 실행 자체에서만 알 수 있습니다. 언어 또는 비전 모델이 읽고 쓰는 토큰, 음성 모델이 생성하는 음성의 초, 또는 모델의 처리 시간 등이 해당합니다. 아래 사용량 기준 청구를 참조하세요.

모델 페이지에는 “실행당 가격”, “입력 동영상의 초당 가격”(및 유사한 표현), “실행당 추정 가격” 또는 “사용량 기준 청구”가 표시됩니다. GET https://api.doitong.com/v1/models?mode=measured, ?mode=estimate 및 ?mode=metered로 해당 모델을 나열할 수 있습니다.

사용량 기준 청구#

metered 모델에는 사용량 가격(“토큰 1000개당 $0.01”, “생성된 오디오 초당 $0.002”, “처리 시간 초당 $0.00111”)과 실행당 최대 금액이 있습니다. 이는 요청 내용(max_tokens, 텍스트 길이, 해상도, 출력 수)과 모델이 공개한 제한으로 정해지는 실행 비용의 최대치입니다. URL 뒤의 파일 내용에는 절대 좌우되지 않습니다. 처리 시간 또는 음성 세션 길이 기준으로 청구되는 모델의 경우 최대값은 요청이 실행될 수 있는 최대 시간(이미지는 15분, 오디오는 30분, 동영상은 60분)이므로 일반적인 실행보다 훨씬 큽니다. 최대값이 모델의 실행당 제한을 초과하는 입력(매우 긴 텍스트)은 422 invalid_input으로 거부됩니다.

1. 견적은 해당 최대값을 credits로 반환합니다(hold 및 일반적인 실행을 나타내는 typical 포함). 실행이 시작되면 최대값이 API 잔액에서 차감되며, API 잔액과 키 한도에서 이를 충당할 수 있어야 합니다.
2. 실행이 성공하면 요청은 모델이 보고한 사용량으로 정산됩니다. 사용량 × 사용량 가격을 계산한 후 API 크레딧 단위로 올림합니다. 최대값 중 나머지는 자동으로 한 번 환불되며, API 잔액의 refund 행으로 기록됩니다.
3. 사용량이 더 많더라도 실행 비용은 최대값을 초과하지 않습니다. 실패하거나 취소된 실행은 항상 전액 환불됩니다.

대부분의 실행은 최대값보다 훨씬 적은 비용이 듭니다. 모델 페이지에는 빌더 입력에 대해 “실행당 최대 $X”가 표시되고, 카탈로그에는 일반적인 실행 가격이 “from”으로 표시됩니다. 처리 시간 기준으로 청구되는 일부 모델에서는 사용량이 모델의 처리 시간이며 approximate로 표시됩니다.

{
  "object": "quote",
  "credits": 621,
  "usd": "0.621",
  "mode": "metered",
  "label": "Charged by usage",
  "hold": { "credits": 621, "usd": "0.621" },
  "typical": { "credits": 10, "usd": "0.01" },
  "settlement": "usage",
  "display": "$0.01 / 1000 tokens",
  "breakdown": "up to 62.035 × 1000 tokens × $0.01"
}

실행 후 요청의 cost에서 보류된 금액과 실제 사용량을 확인할 수 있습니다.

{
  "cost": { "credits": 621, "usd": "0.621", "charged": 621, "refunded": 611, "mode": "metered", "held": 621,
            "typical": 10, "settled": { "status": "settled", "credits": 10, "usd": "0.01", "quantity": 1,
            "unit": "1000_tokens", "unit_usd": "0.01", "source": "billed_usage", "approximate": false } }
}

charged − refunded가 실행 비용입니다. 결과가 나온 후 정산되기 전까지 settled.status는 pending이며, 모델이 사용량을 전혀 보고하지 않은 드문 경우에는 no_usage입니다(이 경우 최대값이 가격으로 유지됨).

실행 전 견적#

POST https://api.doitong.com/v1/quote/{model_id}는 run에 보낼 본문과 정확히 동일한 본문을 받아 해당 입력의 가격을 반환합니다. 사용량 기준으로 청구되는 모델을 제외하면 정확한 가격이며, 해당 모델에서는 실행에 청구될 수 있는 최대 금액입니다. 키가 필요 없고 비용도 들지 않습니다.

curl -X POST "https://api.doitong.com/v1/quote/flux/schnell" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "A lighthouse at dusk", "num_images": 2}'

{
  "object": "quote",
  "model": "flux/schnell",
  "credits": 6,
  "usd": "0.006",
  "unit": "megapixel",
  "quantity": 2,
  "unit_credits": 3,
  "mode": "exact",
  "label": "Price per run",
  "display": "$0.003 / megapixel",
  "breakdown": "2 MP (2 images) × 3 API credits",
  "input": { "prompt": "A lighthouse at dusk", "num_images": 2 },
  "warnings": []
}

키를 사용하면 견적에 balance_credits 및 balance_usd(API 잔액), affordable 및 key_budget_remaining도 반환됩니다. rub 금액을 받으려면 ?currency=rub를 추가합니다.

가격 객체#

API의 모든 가격은 동일한 구조를 가집니다.

• 모델: price: { "credits": 112, "usd": "0.112", "unit": "second", "display": "$0.112 / second", "credits_display": "112 API credits / second", "from_credits": 560, "from_usd": "0.56", "mode": "exact" } — 러시아 또는 ?currency=rub 사용 시 rub, rub_display 및 from_rub도 포함됩니다.
• 요청: cost: { "credits": 560, "usd": "0.56", "charged": 560, "refunded": 0 } (API 크레딧; 사용량 기준 요청에는 mode, held, typical 및 settled가 추가됩니다. 사용량 기준 청구 참조)
• 계정: GET https://api.doitong.com/v1/account는 credits(API 잔액), balance: { "credits", "usd" } 및 storage(파일 스토리지 가격, 사용량 및 월별 예상 금액)를 반환합니다.

환불#

• 실행이 시작되기 전의 잘못된 요청(모든 4xx)에는 요금이 부과되지 않습니다.
• failed로 종료된 요청(timeout 포함)은 API 잔액으로 전액 자동 환불됩니다.
• 시작 전에 취소한 요청은 전액 환불됩니다. 모델이 생성 중인 경우 취소는 요청으로만 처리됩니다. 모델이 완료하면 결과가 전달되고 요금이 부과됩니다.
• 성공한 metered 요청은 최대값 중 사용하지 않은 부분을 돌려받습니다.

요청 객체에서 모든 내역을 확인할 수 있습니다: cost.credits, cost.charged 및 cost.refunded.

파일 스토리지#

출력 파일은 저희 스토리지에 보관됩니다. 계정 또는 실행별로(?storage=) 보관 방식을 선택할 수 있습니다.

영구 스토리지는 API 잔액에서 하루에 한 번 청구됩니다. 보관된 GB × 월별 가격 ÷ 해당 월의 일수이며, 종류가 storage인 원장 행으로 기록됩니다. API 크레딧의 소수 부분은 다음 날로 이월되므로 한 달 동안 정확히 GB × 100 API 크레딧이 됩니다(1 GB = 1024³바이트, 10 GB를 한 달 보관하는 비용은 1,000 API 크레딧). 잔액은 0 미만으로 내려가지 않습니다. 결제할 수 없는 날에는 요금이 청구되지 않고 이메일이 전송되며, 30일 동안 충전할 시간이 주어집니다. 그 후 보관 파일은 임시 파일로 전환되고 7일 뒤 삭제됩니다. 자세한 내용은 파일을 참조하세요.

현재 가격#

추천 모델은 다음과 같습니다. 모든 1,496개 모델과 가격은 모델 카탈로그 및 GET /models(키 필요 없음)에서 확인할 수 있습니다.

충전#

https://doitong.com/developers/dashboard#balance에서 API 잔액에 금액을 추가합니다. 잔액이 부족하면 실행 시 402 insufficient_credits와 top_up_url이 반환됩니다. 각 API 키에도 API 크레딧 단위의 자체 한도를 설정할 수 있습니다. (인증 참조)