Hướng dẫn
Chợ mô hình và tính phí
Chọn mô hình, hiểu thẻ giá, xác nhận năng lực và tính khả dụng
Chợ mô hình và tính phí
Chợ mô hình là lối vào để chọn mô hình và tìm hiểu giá gọi, hiển thị danh mục mô hình hiện có thể cung cấp công khai của nền tảng. Phạm vi thực tế có thể gọi vẫn do nhóm gọi mà API Key thuộc về và trạng thái khả dụng theo thời gian thực quyết định.
Cách chọn mô hình
- Tìm theo tên, hoặc lọc theo thương hiệu mô hình, năng lực và loại API;
- Mở chi tiết, xác nhận API mô hình hỗ trợ, nhóm khả dụng và loại giá;
- Dùng
GET /v1/modelsđể xác nhận ID mô hình mà Key đó nhìn thấy; - Ở backend nghiệp vụ dùng ID mô hình trả về để gửi yêu cầu.
Trường của danh mục mô hình
GET /v1/models trả về các mô hình mà Key hiện tại có thể gọi, mô tả trường như sau:
| Trường | Kiểu | Mô tả |
|---|---|---|
data[].id | string | ID mô hình, điền nguyên như khi gửi yêu cầu |
data[].object | string | Cố định là model |
data[].created | integer | Thời điểm bản ghi danh mục (giây Unix) |
data[].owned_by | string | Mã nhận diện nhà cung cấp mô hình, chỉ để tham khảo |
data[].supported_endpoint_types | string[] | Các loại API mà mô hình này hỗ trợ |
Danh mục mô hình chỉ dùng để xác nhận 「Key này có gọi được mô hình này hay không」, giới hạn tham số cụ thể (số ảnh tham chiếu, thông số video đầu vào, thời lượng và độ nét đầu ra, v.v.) lấy trang chi tiết mô hình và lỗi tham số trả về từ API làm chuẩn. Nền tảng sẽ không đoán tham số thay mô hình, cũng không âm thầm hạ cấp trên các tham số không được hỗ trợ.
Cách đọc thẻ giá
| Hiển thị | Ý nghĩa |
|---|---|
| Đầu vào / Đầu ra | Tính phí riêng theo Token đầu vào và đầu ra, đơn vị hiển thị là 1K hoặc 1M Token. |
| Đầu vào bộ nhớ đệm / Ghi bộ nhớ đệm | Chỉ hiển thị với mô hình hỗ trợ bộ nhớ đệm prompt. |
| Theo lần | Mỗi yêu cầu thành công tính phí theo giá cố định. |
| Video tính phí theo lượng | Mô hình video hiển thị theo giá đang có hiệu lực; độ phân giải, thời lượng hoặc chế độ không có giá sẽ không hiển thị. |
Hiển thị giá dùng để ước tính, khoản trừ thực tế lấy lượng sử dụng thực tế của yêu cầu, nhóm của yêu cầu và bản ghi hóa đơn phía máy chủ làm chuẩn.
Mô hình video
Dòng doubao-seedance và seedance sẽ hiển thị ma trận giá riêng, chia theo 「có đầu vào video hay không」và 「độ phân giải đầu ra」, ô được hỗ trợ đưa ra chi phí video, tổ hợp không được hỗ trợ hiển thị rõ 「không hỗ trợ」.
Khi đọc ma trận, trước tiên xác định lần này có gửi đầu vào video hay không, rồi chọn độ phân giải cần thiết. Ví dụ khi chỉ tải lên văn bản hoặc ảnh tham chiếu thì xem cột 「không có đầu vào video」; khi gửi video làm đầu vào thì xem cột 「có đầu vào video」. Không được suy đoán giá hoặc năng lực chưa hiển thị dựa trên mức liền kề.
Trước khi gọi hãy xác nhận:
- ID mô hình xuất hiện trong phản hồi
/v1/modelscủa bạn; - Yêu cầu dùng API video
/v1/video/generations, chứ không phải API văn bản; - Ảnh tham chiếu hoặc video tham chiếu phù hợp yêu cầu tham số công khai của mô hình đó;
- Phía nghiệp vụ lưu và thăm dò ID tác vụ trả về cho tác vụ bất đồng bộ.
Tham chiếu tư liệu và mô hình
Nhập tư liệu không liên quan đến mô hình: tư liệu chỉ cần nhập một lần, nền tảng sẽ chuẩn bị tham chiếu tư liệu tương ứng theo mô hình hiện tại. Cùng một ID tư liệu có thể chuyển đổi trực tiếp giữa các mô hình khác nhau, chuyển mô hình chỉ cần đổi trường model trong yêu cầu.
Những mô hình nào dùng chung một thư viện tư liệu, và tư liệu người thật hỗ trợ những mô hình nào, xem API thư viện tư liệu.
Tính phí và hóa đơn
Chợ mô hình hiển thị mô tả giá, không đồng nghĩa với số tiền quyết toán cuối cùng. Mô hình văn bản thường quyết toán theo lượng đầu vào, đầu ra và bộ nhớ đệm thực tế; mô hình hình ảnh, âm thanh hoặc video có thể quyết toán theo lần, theo thời lượng hoặc theo đơn vị đo do mô hình định nghĩa.
Tác vụ bất đồng bộ như video quyết toán khi hoàn thành: gửi thành công chỉ là tiếp nhận tác vụ, không tạm giữ trước chi phí, sau khi tác vụ hoàn thành trong hóa đơn chỉ xuất hiện một bản ghi trừ phí thực tế. Trước khi gửi, nền tảng sẽ kiểm tra số dư tài khoản (hoặc hạn mức API Key hiện tại) có đủ cho ước tính lần này hay không, nếu không đủ sẽ trả về trực tiếp thông báo dễ đọc, không tạo tác vụ. Sau khi tác vụ hoàn thành có thể đối chiếu mô hình, thời gian, ID yêu cầu và khoản trừ thực tế trong ví hoặc bản ghi sử dụng.
Kiểm tra tham số thất bại (HTTP 400) nghĩa là yêu cầu chưa được tiếp nhận, thường sẽ không phát sinh chi phí tác vụ tạo sinh; quy tắc tính phí, thất bại và hoàn tiền sau khi đã trả về ID tác vụ được xử lý theo mô hình đó và cấu hình giá của nền tảng.
Thay đổi khả dụng
Thẻ mô hình không hiển thị hoặc trong /v1/models không có một mô hình nào đó, nghĩa là mô hình đó hiện không thuộc danh mục khả dụng của Key, hãy chuyển sang mô hình cùng loại, không viết cứng tên mô hình đã không còn khả dụng ở phía ứng dụng.
「Không có kênh khả dụng」「Mô hình tạm thời không khả dụng」nghĩa là khung giờ hiện tại không thể định tuyến đến mô hình đó, không có nghĩa là định dạng API Key sai. Trước tiên hãy làm mới danh sách mô hình hoặc chuyển sang mô hình cùng loại; nếu vẫn liên tục không khả dụng thì liên hệ hỗ trợ nền tảng và cung cấp ID yêu cầu.