Felo API PlatformFelo API Platform

Hướng dẫn

Mô hình và giá

Hiểu ID mô hình, nhà cung cấp, giá công bố, chiết khấu, đơn vị tính phí và cách một yêu cầu được tính giá.

Giá mô hình được công bố bằng USD. Một mô hình có thể có sẵn qua nhiều hơn một nhà cung cấp thượng nguồn, và mỗi nhà cung cấp có thể công bố một mức giá khách hàng khác nhau. Hướng dẫn này giải thích nguồn gốc của các mức giá đó và cách tính một yêu cầu trước khi gửi.

Tìm model ID

Dùng model ID do API trả về. Không tự dựng ID từ tên hiển thị hoặc slug trang.

EndpointTrả về
GET /api/v1/modelsMọi danh mục mô hình đang bật
GET /api/v1/videos/modelsCác mô hình tạo video
GET /api/v1/decisions/modelsCác mô hình quyết định

GET /api/v1/models cũng chấp nhận exclude_video_and_decisions=true và bộ lọc provider tùy chọn. Việc khám phá chỉ đọc danh mục và không tính phí một lệnh gọi mô hình.

Các mô hình hình ảnh không có endpoint liệt kê riêng. Hãy lọc GET /api/v1/models theo model_kind: "image_generation"; xem Tạo hình ảnh.

Để xem dạng duyệt được, hãy mở danh mục mô hình hoặc trang giá. Trang chi tiết mô hình hiển thị giới hạn ngữ cảnh, giao thức và mọi mức giá nhà cung cấp được công bố.

Nhà cung cấp và kênh

Mỗi mô hình có một danh sách kênh công khai. Một kênh là một cấu hình nhà cung cấp thượng nguồn cho mô hình đó, chẳng hạn Anthropic, Azure, Google hoặc một kênh Claude được giảm giá.

  • is_default đánh dấu kênh được dùng cho mức giá nổi bật và tuyến mặc định.
  • runnable đánh dấu kênh hiện có sẵn để nhận yêu cầu hay không.
  • standard_pricing chứa mức giá tiêu chuẩn của nhà cung cấp.
  • discount_multiplier là hệ số bán hàng từ 0 đến 1.
  • pricing_mode là configured_rates hoặc upstream_cost.

Trang mô hình sắp xếp nhà cung cấp với mặc định trước, sau đó theo giá đầu vào cho khách hàng từ thấp đến cao. Để chọn nhà cung cấp một cách tường minh, hãy xem Kênh và định tuyến nhà cung cấp.

Cách tính giá khách hàng

Với một kênh configured_rates:

customer price = standard rate × discount multiplier

Ví dụ: một kênh có mức giá đầu vào tiêu chuẩn $1.00 mỗi 1M token và hệ số 0.8 sẽ tính $0.80 mỗi 1M token.

Với một kênh upstream_cost, standard_pricing là null, không phải 0. Việc tính phí dựa trên chi phí tạo được báo cáo nhân với mức giảm giá đã cố định. Trang mô hình hiển thị quy tắc thực tế cho kênh đó.

Để dễ đọc, mức giá token được hiển thị theo 1 triệu token. Việc tính phí dùng độ chính xác theo từng token trong ảnh chụp giá hiện tại.

Đơn vị tính phí

Đơn vịCách dùng điển hìnhCách đo
TokenChat, suy luận, embeddings, tạo văn bảnToken đầu vào và đầu ra riêng biệt; lượt đọc và ghi cache có thể có mức giá riêng
Token hình ảnhTạo và chỉnh sửa hình ảnhToken hình ảnh đầu vào và đầu ra riêng biệt; số token đầu ra mỗi hình phụ thuộc vào độ phân giải
Yêu cầuMột số endpoint hình ảnh và tiện íchMột khoản phí cố định cho mỗi lệnh gọi
Giây hoặc bậcTạo videoThời lượng, độ phân giải, đầu vào tham chiếu hoặc một điều kiện được công bố khác

Nếu nhiều điều kiện giá cùng khớp, điều kiện khớp đầu tiên được liệt kê trong chi tiết giá của mô hình sẽ được áp dụng. Hãy kiểm tra trang chi tiết mô hình để xem các bậc trước khi ước tính một tác vụ lớn.

Mức giá cache

Khi một mô hình công bố input_cache_read hoặc input_cache_write, các mức giá đó xuất hiện trong danh mục và trên trang mô hình. Việc dùng cache được báo cáo qua phản hồi giao thức; không bảo đảm có cache hit và điều này phụ thuộc vào nhà cung cấp thượng nguồn và yêu cầu. Felo không thêm công tắc cache riêng.

Nơi kiểm tra giá

  • Trang giá — so sánh mô hình và nhà cung cấp.
  • Trang chi tiết mô hình — bảng giá đầy đủ, các bậc và điều kiện.
  • Model catalog API — cùng dữ liệu dạng JSON, được làm mới trong vòng 60 giây.

Không gán cứng giá trong ứng dụng của bạn. Hãy đọc danh mục hoặc hiển thị liên kết đến trang giá để một thay đổi giá không âm thầm làm hỏng ước tính chi phí của bạn.

Ước tính một yêu cầu

  1. Tìm model ID và kênh bạn định dùng.
  2. Đọc mức giá đầu vào, đầu ra và cache của kênh đó.
  3. Nhân với số token dự kiến của bạn, hoặc dùng mức giá theo yêu cầu hoặc thời lượng cho các mô hình không tính theo token.
  4. Cộng thêm bất kỳ bậc có điều kiện nào áp dụng.
  5. Chừa dư địa cho việc thử lại và sai lệch đầu ra.

Liên quan