Bảng giá

Mỗi mô hình có đúng mức giá mà nhà sản xuất mô hình tính, bằng đô la Mỹ. Bạn thanh toán từ số dư API, được tính bằng tín dụng API: 1.000 tín dụng API = 1 $. Số dư API là số dư riêng, tách biệt với tín dụng của các ứng dụng Doitong. Không có gói, mức tối thiểu hoặc phí theo mô hình: mỗi cuộc gọi có giá riêng và được trừ vào số dư API khi yêu cầu được chấp nhận.

Tại Nga (doitong.ru, api.doitong.ru hoặc ?currency=rub), giá cũng được hiển thị bằng rúp: giá USD × tỷ giá USD/RUB × 1,3.

Đơn vị#

Mỗi mô hình có một đơn vị tính phí, hiển thị trên trang của mô hình và trong GET https://api.doitong.com/v1/models/{model_id}:

Giá = số lượng × tín dụng API trên mỗi đơn vị, làm tròn lên thành số tín dụng API nguyên (0,001 $), không bao giờ thấp hơn 1. Các đơn vị rất rẻ có thể có giá lẻ trên mỗi đơn vị (0.4 tín dụng API mỗi giây); chỉ tổng của một cuộc gọi được làm tròn.

Một số mô hình tính mức giá khác nhau tùy đầu vào: video có âm thanh đắt hơn video không có âm thanh, 4K đắt hơn 1K, v.v. Các quy tắc này được liệt kê trên từng trang mô hình. Tham số bạn bỏ qua được tính là giá trị mặc định, vì vậy giá hiển thị cho một đầu vào chính là giá bạn trả.

Giá chính xác, đo được, ước tính và theo mức sử dụng#

Mỗi giá có một mode:

• exact: Giá được tính từ đầu vào của bạn (giây, hình ảnh, megapixel, ký tự, bước hoặc một mức giá cố định cho mỗi video hay cuộc gọi).
• measured: Giá dựa trên các tệp bạn gửi: độ dài video hoặc âm thanh đầu vào, kích thước hình ảnh đầu vào, tốc độ khung hình hoặc số khung hình của video. Công cụ nâng cấp, đồng bộ môi, video-sang-video, chuyển biên và công cụ âm thanh được tính theo cách này. Trước khi chạy, API đọc độ dài, độ phân giải và tốc độ khung hình của tệp (báo giá cũng làm như vậy), nên báo giá chính xác bằng khoản phí khi chạy. Trang mô hình cho biết bạn trả tiền cho gì ("Giá mỗi giây của video đầu vào") và công cụ tính sử dụng các số liệu của tệp. Tệp không thể đọc bị từ chối với unmeasurable_input và không tính phí.
• estimate: Chi phí riêng của mô hình phụ thuộc vào thứ mà đầu vào không thể cho biết trước (token, thời gian tính toán). Mô hình đó tính giá ước tính cố định cho mỗi lần chạy (cho mỗi hình ảnh đầu ra khi có số lượng hình ảnh), được đặt từ chi phí trung bình của các lần chạy thực tế của mô hình. Bạn vẫn biết giá trước khi chạy: báo giá chính là số tiền bạn trả.
• metered: Mô hình được tính phí theo mức sử dụng thực tế, chỉ lần chạy mới biết: số token mà mô hình ngôn ngữ hoặc thị giác đọc và viết, số giây lời nói mà mô hình giọng nói tạo ra hoặc thời gian xử lý của mô hình. Xem Tính phí theo mức sử dụng bên dưới.

Trang mô hình ghi "Giá mỗi lần chạy", "Giá mỗi giây của video đầu vào" (và các cách tương tự), "Giá ước tính mỗi lần chạy" hoặc "Tính phí theo mức sử dụng"; GET https://api.doitong.com/v1/models?mode=measured, ?mode=estimate và ?mode=metered liệt kê chúng.

Tính phí theo mức sử dụng#

Mô hình metered có giá theo mức sử dụng ("$0.01 trên mỗi 1000 token", "$0.002 mỗi giây âm thanh được tạo", "$0.00111 mỗi giây thời gian xử lý") và mức tối đa cho mỗi lần chạy: khoản cao nhất mà lần chạy có thể tốn, dựa trên những gì yêu cầu của bạn cho biết (max_tokens, độ dài văn bản, độ phân giải, số đầu ra) và các giới hạn đã công bố của mô hình. Mức này không bao giờ phụ thuộc vào nội dung của tệp phía sau URL. Với mô hình tính theo thời gian xử lý hoặc độ dài phiên giọng nói, mức tối đa là thời gian dài nhất một yêu cầu có thể chạy (15 phút cho hình ảnh, 30 cho âm thanh, 60 cho video), nên cao hơn nhiều so với lần chạy thông thường. Đầu vào có mức tối đa vượt quá giới hạn mỗi lần chạy của mô hình (văn bản rất dài) bị từ chối với 422 invalid_input:

1. Báo giá trả về mức tối đa đó dưới dạng credits (cùng hold và typical, là lần chạy thông thường). Khi lần chạy bắt đầu, mức tối đa được trừ vào số dư API và số dư cùng ngân sách khóa phải đủ chi trả.
2. Khi lần chạy thành công, khoản phải trả của yêu cầu được quyết toán theo mức sử dụng mà mô hình báo cáo: mức sử dụng × giá theo mức sử dụng, làm tròn lên thành tín dụng API nguyên. Phần còn lại của mức tối đa được hoàn tiền tự động, một lần, dưới dạng dòng refund trong số dư API.
3. Một lần chạy không bao giờ tốn quá mức tối đa, ngay cả khi mức sử dụng có thể vượt mức đó. Lần chạy thất bại hoặc bị hủy luôn được hoàn tiền đầy đủ.

Hầu hết lần chạy tốn ít hơn nhiều so với mức tối đa; trang mô hình hiển thị "Tối đa $X mỗi lần chạy" cho đầu vào của trình tạo và lần chạy thông thường ("từ" trong danh mục). Với một số ít mô hình tính theo thời gian xử lý, mức sử dụng là thời gian xử lý của mô hình (được đánh dấu 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"
}

Sau khi chạy, cost của yêu cầu cho biết khoản đã giữ và mức sử dụng thực tế:

{
  "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 là chi phí của lần chạy. settled.status là pending trong khoảng thời gian giữa kết quả và quyết toán, và là no_usage trong trường hợp hiếm khi mô hình không báo cáo mức sử dụng nào (khi đó mức tối đa được giữ làm giá).

Báo giá trước khi chạy#

POST https://api.doitong.com/v1/quote/{model_id} nhận chính xác phần thân bạn sẽ gửi tới run và trả về giá của đầu vào đó: giá chính xác, ngoại trừ mô hình tính phí theo mức sử dụng, trong đó đây là khoản cao nhất lần chạy có thể tốn. Không cần khóa và không tính phí:

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": []
}

Khi có khóa, báo giá cũng trả về balance_credits và balance_usd (số dư API), affordable và key_budget_remaining. Thêm ?currency=rub để nhận số tiền rub.

Đối tượng giá#

Mọi giá trong API có cùng cấu trúc:

• models: 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" } — cộng thêm rub, rub_display và from_rub tại Nga hoặc với ?currency=rub;
• requests: cost: { "credits": 560, "usd": "0.56", "charged": 560, "refunded": 0 } (tín dụng API; yêu cầu tính theo mức sử dụng thêm mode, held, typical và settled, xem Tính phí theo mức sử dụng);
• account: GET https://api.doitong.com/v1/account trả về credits (số dư API), balance: { "credits", "usd" } và storage (giá lưu trữ tệp, mức sử dụng và ước tính hàng tháng).

Hoàn tiền#

• Yêu cầu không hợp lệ (bất kỳ 4xx nào trước khi lần chạy bắt đầu) không bao giờ bị tính phí.
• Yêu cầu kết thúc ở trạng thái failed (bao gồm timeout) được hoàn tiền đầy đủ vào số dư API một cách tự động.
• Yêu cầu bạn hủy trước khi bắt đầu được hoàn tiền đầy đủ. Khi mô hình đã bắt đầu tạo, thao tác hủy chỉ là một yêu cầu: nếu mô hình hoàn tất, kết quả được gửi và tính phí.
• Yêu cầu metered thành công được hoàn lại phần mức tối đa chưa sử dụng.

Đối tượng yêu cầu hiển thị tất cả: cost.credits, cost.charged và cost.refunded.

Lưu trữ tệp#

Tệp đầu ra được giữ trong hệ thống lưu trữ của chúng tôi. Bạn chọn trong tài khoản hoặc cho từng lần chạy (?storage=):

Lưu trữ vĩnh viễn được tính phí mỗi ngày một lần từ số dư API: số GB được giữ × giá hàng tháng ÷ số ngày trong tháng, dưới dạng các dòng sổ cái có loại storage. Phần lẻ của tín dụng API được chuyển sang ngày tiếp theo, nên một tháng cộng lại chính xác bằng số GB × 100 tín dụng API (1 GB = 1024³ byte; 10 GB được giữ trong một tháng tốn 1.000 tín dụng API). Số dư không bao giờ xuống dưới 0: khi không thể thanh toán, ngày đó không bị tính phí, bạn nhận email và có 30 ngày để nạp tiền trước khi tệp được giữ chuyển thành tệp tạm thời và bị xóa 7 ngày sau. Chi tiết: Tệp.

Giá hiện tại#

Đây là các mô hình nổi bật. Tất cả 1.496 mô hình và giá của chúng có trong catalog mô hình và trong GET /models (không cần khóa).

Nạp tiền#

Thêm tiền vào số dư API tại https://doitong.com/developers/dashboard#balance. Khi số dư quá thấp, lần chạy trả về 402 insufficient_credits cùng top_up_url. Mỗi khóa API cũng có thể được giới hạn bằng ngân sách riêng tính bằng tín dụng API (xem Xác thực).