MớiCách chúng tôi bắt người bán gắn sai model, và hoàn tiền cho bạn nếu có.

Người bán

Bạn có thể niêm yết dung lượng suy luận mà bạn được cấp phép bán lại trên MartLLM: một tài khoản tại một trong các nhà cung cấp trong danh sách của chúng tôi, theo một gói dịch vụ cho phép bán lại. Các yêu cầu của người mua đối với một mô hình có thể được định tuyến đến ưu đãi của bạn, và bạn được ghi nhận toàn bộ số tiền mà người mua thanh toán cho mỗi yêu cầu.

Để niêm yết một ưu đãi từ trình duyệt, hãy sử dụng trang người bán: Tài khoản → Bán dung lượng → Ưu đãi mới. Trang này sẽ hướng dẫn bạn qua năm bước: Nhà cung cấp, Khám phá, Kiểm tra sức khỏe, Định giá, Đánh giá. Không có gì được công bố cho đến khi bạn xác nhận, và người mua sẽ được chuyển đến một ưu đãi mới ngay khi nó vượt qua kiểm tra mô hình của chúng tôi và một người trong nhóm của chúng tôi đã phê duyệt.

Mọi thứ mà trang này thực hiện cũng là một API, vì vậy tác nhân của bạn cũng có thể thực hiện được (xem Dành cho tác nhân).

Từ terminal

npx uberllm sell

Một lệnh duy nhất thực hiện tương tự như trang người bán. Nó yêu cầu Node.js 18 trở lên.

  1. Bạn đặt tên nhà cung cấp và dán khóa của mình. Việc nhập liệu được ẩn đi, và khóa không bao giờ được chấp nhận dưới dạng cờ dòng lệnh (trong một script, hãy dùng --key-env NAME).
  2. Khóa được kiểm tra với nhà cung cấp, và chỉ gửi đến đó. Đối với OpenRouter, DeepSeek, Venice AI, Moonshot AI / Kimi, Ollama Cloud và Morpheus, bạn sẽ thấy số dư còn lại, được đọc từ API số dư riêng của nhà cung cấp. Đối với các nhà cung cấp khác, khóa được kiểm tra với danh sách mô hình của nhà cung cấp, vốn miễn phí, và bạn đọc số dư trong tài khoản nhà cung cấp của mình.
  3. Bạn sẽ được hỏi trước khi khóa được gửi đến MartLLM. Trên no, không có gì được gửi đi.
  4. Bạn chọn các mô hình và giá (Enter khớp với giá thấp nhất mà người mua nhận được hiện tại), và một yes thứ hai sẽ liệt kê chúng qua /v1/seller/offers/bulk, 10 mô hình mỗi yêu cầu. Nếu một yêu cầu thất bại, những gì đã được liệt kê sẽ được hiển thị; chạy lại lệnh cho phần còn lại (các mô hình đã được liệt kê sẽ bị bỏ qua).

Khóa MartLLM của bạn được đọc từ UBERLLM_API_KEY, hoặc từ khóa uberllm init đã lưu. Nếu không có, lệnh sẽ kiểm tra khóa nhà cung cấp của bạn và mở biểu mẫu người bán với nhà cung cấp đã chọn (/seller/new?provider=<id>).

Tùy chọn Chức năng
--provider <id> Nhà cung cấp để bán từ đó. --providers in ra danh sách.
--key-env <NAME> Đọc khóa nhà cung cấp từ biến môi trường này.
--check-only Kiểm tra khóa và số dư, không gửi gì đến MartLLM.
--models <a,b> ID mô hình để liệt kê. Mặc định: mọi mô hình chúng tôi có thể liệt kê từ khóa.
--discount <percent> Định giá thấp hơn giá niêm yết bao nhiêu. Mặc định: khớp với giá thấp nhất mà người mua nhận được hiện tại.
--precision <full|8bit|below8> Cách nhà cung cấp của bạn chạy các mô hình mã nguồn mở.
--daily-cap <usd> Ngừng gửi người mua khi số tiền này đã được chi cho một ưu đãi trong một ngày.
--yes Không hỏi trước khi gửi khóa đến MartLLM và liệt kê (dành cho script).

Hướng dẫn từng bước cho mọi nhà cung cấp đã xác minh, cùng với những gì điều khoản của từng nhà cung cấp đã nêu khi chúng tôi đọc chúng: Bán tín dụng AI chưa sử dụng.

Các nhà cung cấp bạn có thể bán từ

  • Chỉ các nhà cung cấp trong danh sách của chúng tôi. Khi bạn thêm một ưu đãi, bạn chọn nhà cung cấp từ danh sách (GET /seller/providers) và dán API key của bạn; địa chỉ sẽ đến từ danh sách. Máy chủ của riêng bạn, hoặc bất kỳ địa chỉ nào không có trong danh sách, sẽ bị từ chối. Để bán từ một nhà cung cấp không có trong danh sách, hãy yêu cầu chúng tôi thêm vào: [email protected]. Chúng tôi kiểm tra một nhà cung cấp trước khi thêm vào: danh sách mô hình của họ, một yêu cầu nhỏ, cách họ báo cáo lỗi và mức sử dụng, giá cả của họ và liệu các điều khoản của họ có cho phép bán lại hay không.
  • Các nhà cung cấp đã xác minh. Các nhà cung cấp được đánh dấu Đã xác minh (trusted: true) được điều hành bởi một công ty mà chúng tôi đã kiểm tra. Người mua được mặc định chuyển đến các ưu đãi từ các nhà cung cấp đã xác minh. Các ưu đãi từ các nhà cung cấp khác trong danh sách chỉ tiếp cận được những người mua đã bật Cũng sử dụng người bán trên các nhà cung cấp chúng tôi chưa xác minh cho API key của họ.
  • Các ưu đãi được niêm yết trước quy tắc này trên một địa chỉ không có trong danh sách sẽ không có người mua và không thể bật lại (provider_listed: false, với lý do trong blocked_reason). Lịch sử bán hàng của họ vẫn được giữ lại. Để tiếp tục bán, hãy niêm yết lại mô hình từ một nhà cung cấp trong danh sách.

Ưu đãi hoạt động như thế nào

  • Một khóa nhà cung cấp, một base URL, nhiều mô hình. Một ưu đãi là một mô hình được phục vụ thông qua một khóa tại một địa chỉ. Cùng một khóa có thể phục vụ bao nhiêu mô hình tùy thích, nhưng bạn không thể liệt kê cùng một mô hình hai lần trên cùng một khóa và địa chỉ — một mô hình thứ hai sẽ bị từ chối với 409 duplicate_offer_for_credential (và, khi ưu đãi hiện có là của bạn, id của nó là error.detail.existing_offer_id).
  • Chúng tôi chọn tên của nhà cung cấp cho mô hình, bạn thì không. Nhà cung cấp có thể gọi một mô hình khác với chúng tôi (chúng tôi gọi nó là deepseek/deepseek-v4-flash, nhà cung cấp gọi nó là deepseek-v4-flash). Chúng tôi đọc danh sách mô hình của nhà cung cấp bằng khóa của bạn và chỉ liệt kê một mô hình khi tên của nhà cung cấp là cùng một mô hình với chúng tôi: cùng một tên sau khi tiền tố của nhà sản xuất, chữ cái in hoa và - _ . được bỏ qua, với tối đa một dấu ngày hoặc phiên bản ở cuối. Discovery làm điều này cho bạn. Nếu bạn tự gửi upstream_model, nó phải là một trong các tên trong danh sách của nhà cung cấp và là cùng một mô hình, nếu không ưu đãi sẽ bị từ chối. Nếu chúng tôi không thể đọc danh sách mô hình của nhà cung cấp bằng khóa của bạn, ưu đãi sẽ bị từ chối kèm theo lý do.
  • Hình dạng khóa của bạn được kiểm tra trước. Đối với các nhà cung cấp có khóa có dạng được ghi lại (ví dụ, khóa OpenRouter bắt đầu bằng sk-or-v1-, khóa Groq bằng gsk_), một khóa có dạng khác sẽ bị từ chối trước khi chúng tôi gửi bất cứ điều gì.
  • Khóa của bạn được mã hóa khi không sử dụng, chỉ được giải mã để phục vụ một yêu cầu gửi đến bạn, không bao giờ được trả về bởi bất kỳ thao tác đọc nào và không bao giờ được ghi nhật ký. Một khóa mới được kiểm tra trước khi được chấp nhận — nếu kiểm tra thất bại, khóa cũ của bạn vẫn được giữ lại. Việc xóa một ưu đãi sẽ xóa khóa đã lưu trữ.

Giá cả

Các ưu đãi văn bản được định giá theo mức chiết khấu so với giá niêm yết của mô hình (giá mà người mua sẽ trả nếu mua trực tiếp). Gửi discount_pct (ví dụ: 45 = giảm 45%) hoặc tương đương với multiplier (0.55). Giá mỗi token (input_usd_per_mtok / output_usd_per_mtok) không còn được chấp nhận cho các mô hình văn bản.

"match_best": true đặt giá của bạn theo mức chiết khấu sâu nhất mà người mua có thể nhận được cho mô hình đó ngay bây giờ. Bạn có thể thay đổi bất cứ lúc nào.

Người mua trả giá của bạn; toàn bộ số tiền đó sẽ được ghi có vào tài khoản của bạn khi mỗi yêu cầu hoàn tất. MartLLM không thu phí từ doanh số bán hàng của bạn. Chi phí của riêng bạn là bất cứ điều gì nhà cung cấp của bạn tính phí cho API key của bạn.

Tùy chọn daily_cap_usd: một khi người mua đã chi tiêu số tiền đó cho ưu đãi trong một ngày, nó sẽ ngừng nhận yêu cầu cho đến ngày hôm sau.

Sức khỏe

Sức khỏe được đo lường dựa trên lưu lượng truy cập thực của người mua. Các yêu cầu duy nhất khác mà chúng tôi gửi đến khóa của bạn là yêu cầu kiểm tra bên dưới và những yêu cầu của kiểm tra mô hình.

  • Khi bạn đăng hoặc bật một ưu đãi, hoặc thay đổi khóa của nó, chúng tôi gửi một yêu cầu kiểm tra nhỏ (nó có thể sử dụng một phần rất nhỏ hạn mức của bạn).
  • Nếu yêu cầu của người mua đến bạn thất bại, người mua sẽ được chuyển đến người bán tiếp theo và ưu đãi của bạn sẽ tạm ngừng định tuyến trong một thời gian: 30 giây → 1 phút → 2 phút → 10 phút đối với lỗi máy chủ và hết thời gian chờ, 10 → 20 → 40 → 60 phút đối với khóa bị từ chối hoặc không có tín dụng, 15–30 giây đối với giới hạn tốc độ. Khi thời gian chờ kết thúc, ưu đãi của bạn sẽ nhận lại yêu cầu; một yêu cầu thành công sẽ đặt lại nó.
  • Đã khắc phục sớm hơn? POST /seller/offers/{id}/reset-health (nút Đã khắc phục, thử lại) sẽ đưa nó trở lại ngay lập tức. Một khóa hoặc địa chỉ mới vượt qua bài kiểm tra cũng vậy.
  • Nếu nhà cung cấp của bạn từ chối khóa của bạn hoặc nói rằng tài khoản không có tín dụng hai lần liên tiếp, chúng tôi sẽ gửi email cho bạn (tối đa một lần mỗi ngày) với các ưu đãi bị ảnh hưởng.
  • Nếu nhà cung cấp của bạn nói rằng khóa của bạn không hợp lệ (HTTP 401 hoặc 403) ba lần liên tiếp, ưu đãi sẽ bị tạm dừng và nhật ký sức khỏe sẽ cho biết lý do (key_rejected). Khắc phục khóa (hoặc thêm khóa mới bằng Thay đổi khóa), sau đó bật ưu đãi: chúng tôi sẽ kiểm tra khóa lại trước.
  • GET /seller/health-log cho biết, bằng những từ ngữ đơn giản, lý do tại sao một ưu đãi bị bỏ qua và khi nào nó hoạt động trở lại.

Chất lượng so với các máy chủ khác

Mỗi phản hồi mà ưu đãi của bạn cung cấp cũng được kiểm tra dựa trên yêu cầu mà nó đã trả lời: các lệnh gọi công cụ là JSON hợp lệ, gọi tên một công cụ mà người mua đã cung cấp và phù hợp với các đối số của công cụ đó; các phản hồi không bị cắt ngắn hơn nhiều so với độ dài mà người mua yêu cầu hoặc vượt quá nó; cài đặt suy nghĩ của người mua được tuân thủ; và một phản hồi có suy nghĩ cũng trả lời. Cứ vài phút một lần, tỷ lệ của bạn được so sánh với các máy chủ khác của cùng một mô hình trong hai ngày qua. Hầu hết các máy chủ bị tụt hậu đều có cài đặt sai (một trình phân tích cú pháp lệnh gọi công cụ, giới hạn độ dài đầu ra, tùy chọn suy luận), vì vậy đây là phản hồi, không phải là hình phạt cho việc gian lận:

  • Bị tụt hậu xa so với những người khác về một trong những điều này, ưu đãi của bạn vẫn hoạt động nhưng người mua được gửi đến các máy chủ khác của mô hình trước (đối với các vấn đề về công cụ, chỉ những người mua sử dụng công cụ). Trang Bán hàng của bạn sẽ cho biết điều gì sai, bằng những từ ngữ đơn giản.
  • Nó sẽ tự động phục hồi trong vòng vài phút một khi các chỉ số của bạn trở lại bình thường.
  • Một ưu đãi mới, hoặc một ưu đãi có ít lưu lượng truy cập, không được so sánh cho đến khi nó có đủ phản hồi: nó không được ưu tiên cũng không bị kìm hãm.

Từ niêm yết đến hoạt động

Mọi ưu đãi mới đều trải qua các bước giống nhau, và trang Bán hàng hiển thị trạng thái của từng ưu đãi:

  1. Đã niêm yết. Khóa của bạn đã vượt qua yêu cầu kiểm tra khi bạn xác nhận.
  2. Kiểm tra mô hình. Chúng tôi kiểm tra xem máy chủ của bạn có phản hồi đúng như mô hình bạn đã niêm yết hay không. Việc này thường mất vài phút. Xem Kiểm tra mô hình.
  3. Đội ngũ xem xét. Một người trong đội ngũ của chúng tôi sẽ phê duyệt ưu đãi. Cho đến lúc đó, trang Bán hàng sẽ hiển thị trạng thái là Đang xem xét. Việc kiểm tra mô hình và xem xét diễn ra đồng thời.
  4. Hoạt động. Người mua sẽ được chuyển đến ưu đãi này. Chúng tôi sẽ gửi email cho bạn khi ưu đãi được phê duyệt.

Nếu đội ngũ của chúng tôi không phê duyệt một ưu đãi, ưu đãi đó sẽ bị tạm dừng và hiển thị trạng thái Không được phê duyệt kèm theo lý do, và chúng tôi sẽ gửi email cho bạn cùng lý do đó. Hãy khắc phục theo những gì được nêu, sau đó bật lại ưu đãi: ưu đãi sẽ quay lại đội ngũ của chúng tôi để xem xét.

Một khóa mới, địa chỉ máy chủ hoặc mô hình mới trên một ưu đãi được coi là một ưu đãi mới: nó sẽ trải qua quá trình kiểm tra mô hình và xem xét lại. Trong khi một ưu đãi đang chờ xem xét, bạn vẫn có thể thay đổi giá hoặc tạm dừng nó.

Kiểm tra mô hình

Người mua trả tiền cho mô hình bạn niêm yết, vì vậy chúng tôi kiểm tra để đảm bảo rằng ưu đãi của bạn thực sự cung cấp đúng mô hình đó.

Các quy tắc

  • Cung cấp đúng mô hình bạn niêm yết. Không phải mô hình nhỏ hơn, rẻ hơn, cũ hơn hoặc được tinh chỉnh khác, và không phải là sự kết hợp của nhiều mô hình.
  • Không thêm bất cứ điều gì vào yêu cầu. Không có hướng dẫn, system prompt hoặc công cụ của riêng bạn, và không cắt bỏ bất cứ điều gì từ những gì người mua đã gửi. Một ứng dụng trò chuyện hoặc công cụ lập trình được bán lại mà thêm hướng dẫn riêng của nó sẽ vi phạm quy tắc này.
  • Truyền số lượng token không thay đổi, chính xác như mô hình đã đếm.
  • Không thay đổi câu trả lời. Không thêm nội dung để làm cho phản hồi dài hơn, không cắt bớt, không viết lại: hãy gửi lại những gì mô hình đã viết.
  • Truyền các tag không thay đổi. Yêu cầu của người mua có thể đến với bạn kèm theo các tag như [EMAIL_3f9a2c1b] thay cho bí mật và dữ liệu cá nhân. Hãy gửi chúng đến mô hình như nguyên trạng, và gửi lại câu trả lời của mô hình với chúng như nguyên trạng.

Cách chúng tôi kiểm tra

  • Mọi ưu đãi đều được một người trong nhóm của chúng tôi xem xét trước khi bất kỳ người mua nào được gửi đến. Cho đến lúc đó, trang Bán hàng (Selling page) sẽ hiển thị là Đang xem xét (In review).
  • Mọi ưu đãi cũng được kiểm tra trước khi bất kỳ người mua nào được gửi đến. Cho đến khi vượt qua, trang Bán hàng (Selling page) sẽ hiển thị là Đang kiểm tra (Checking); một khi cả hai hoàn tất, nó sẽ Hoạt động (Live). Một key, địa chỉ hoặc mô hình mới sẽ được xem xét và kiểm tra lại theo cùng một cách.
  • Các ưu đãi tiếp tục được kiểm tra trong suốt thời gian chúng được niêm yết, ngay cả sau khi chúng Hoạt động (Live), trên lưu lượng truy cập thực và với các kiểm tra trông giống như bất kỳ yêu cầu nào khác và có thể đến bất cứ lúc nào. Một ưu đãi đang hoạt động có thể quay lại trạng thái Đang kiểm tra (Checking) trong một thời gian; người mua sẽ được gửi đến lại một khi kiểm tra vượt qua.
  • Các kiểm tra sử dụng một phần nhỏ hạn mức của bạn và được thanh toán như bất kỳ yêu cầu nào khác.
  • Chúng tôi không công bố cách thức hoạt động của các kiểm tra hoặc khi nào chúng được thực hiện.

Khi một ưu đãi không vượt qua kiểm tra

  • Nó sẽ bị Tạm dừng (Paused), và bạn không thể tự mình bật lại. Việc niêm yết cùng một key một lần nữa như một ưu đãi mới cũng sẽ bị từ chối.
  • Các khoản thanh toán của bạn sẽ bị giữ lại trong khi nhóm của chúng tôi xem xét. Những gì ưu đãi đó đã kiếm được và chưa được thanh toán có thể được hoàn trả cho những người mua mà nó đã phục vụ.
  • Trang Bán hàng (Selling page) và GET /seller/offers sẽ cho biết lý do, bằng những từ ngữ dễ hiểu (listing_state: "paused" với check_reason), và chúng tôi sẽ gửi email cho bạn.
  • Để được kiểm tra lại, hãy khắc phục những gì đang cung cấp ưu đãi, sau đó viết thư cho [email protected].

Khi người bán bị phát hiện cung cấp mô hình khác với mô hình đã niêm yết

  • Tài khoản người bán của bạn sẽ bị đình chỉ (suspended) và tất cả các ưu đãi của bạn sẽ dừng ngay lập tức.
  • Thu nhập chưa được thanh toán sẽ bị tịch thu và dùng để hoàn tiền cho những người mua mà ưu đãi của bạn đã phục vụ. Các khoản thanh toán chưa được gửi sẽ bị hủy.
  • Bạn không thể niêm yết trên MartLLM nữa, với cùng provider key, server, địa chỉ thanh toán hoặc email.
  • Trang Bán hàng (Selling page) sẽ nói như vậy, và GET /seller/offers trả lời listing_state: "suspended". Hãy viết thư cho [email protected] về vấn đề này.

Mô hình mã nguồn mở (Open-weight models): hãy cho biết cách bạn chạy chúng

Các mô hình mã nguồn mở (Open-weight models) (GPT-OSS, Qwen, DeepSeek, GLM, Kimi, MiniMax và các mô hình khác có trọng số được công bố) có thể được chạy ở chất lượng đầy đủ hoặc nén để tiết kiệm bộ nhớ. Một bản sao nén sẽ trả lời kém hơn một chút, và không có thử nghiệm nào có thể phân biệt đáng tin cậy nó với mô hình đầy đủ. Vì vậy, khi bạn niêm yết một mô hình mã nguồn mở, bạn phải cho biết server của bạn chạy nó như thế nào, và người mua sẽ thấy câu trả lời của bạn trên trang của mô hình:

  • Chất lượng đầy đủ (16-bit): trọng số như đã công bố (bf16 / fp16), hoặc tốt hơn.
  • 8-bit: fp8 hoặc int8.
  • Dưới 8-bit (6-bit hoặc 4-bit): bất cứ thứ gì nhỏ hơn.

Một niêm yết mới của mô hình mã nguồn mở cần một trong ba tùy chọn trên. Các ưu đãi được niêm yết trước 1 tháng 11, 2026 sẽ hiển thị "Độ chính xác chưa được nêu" (Precision not stated) cho đến khi bạn thiết lập nó (Trang Bán hàng (Selling page) → ưu đãi → Giá và độ chính xác (Price and precision)). Việc nêu độ chính xác cao hơn so với những gì server của bạn thực sự chạy là một mô hình khác với mô hình đã niêm yết: tài khoản sẽ bị đình chỉ, như đã nêu dưới đây. Các mô hình đóng (Claude, GPT-5, Gemini…) không yêu cầu điều này.

Số lượng token bị độn

Khi server của bạn báo cáo số lượng prompt token nhiều hơn đáng kể so với những gì một yêu cầu thực sự chứa, người mua sẽ bị tính phí, và bạn sẽ được thanh toán, tối đa khoảng 2× số lượng đếm của chúng tôi đối với prompt token của yêu cầu, cộng thêm một khoản phụ cấp nhỏ cho các định nghĩa công cụ và hình ảnh. Dưới mức đó, các yêu cầu sẽ được tính phí chính xác như server của bạn báo cáo.

Phía phản hồi hoạt động tương tự. Chúng tôi đếm văn bản mà phản hồi của bạn gửi lại: câu trả lời, các đối số gọi công cụ, và lý do khi mô hình hiển thị đầy đủ. Người mua sẽ bị tính phí, và bạn sẽ được thanh toán, tối đa 1.15× những gì mô hình thực tế báo cáo cho lượng văn bản đó, cộng thêm 16 token. "Những gì mô hình thực tế báo cáo" được học từ tuyến đường đáng tin cậy của chúng tôi cho cùng một mô hình.

Lý do mà phản hồi không hiển thị (Claude, GPT và Gemini ẩn hoặc tóm tắt nó, hoặc nó được mã hóa) không thể được đếm. Nó được phép tối đa bằng những gì mô hình thực tế sử dụng trong 99 trong số 100 phản hồi với cùng nỗ lực suy luận và kích thước prompt tương tự. Con số đó đến từ dịch vụ riêng của nhà sản xuất mô hình khi chúng tôi có, và từ tuyến đường đáng tin cậy của chúng tôi nếu không.

Cho đến khi chúng tôi có đủ phản hồi của một mô hình để đặt các giới hạn này, các phản hồi của nó sẽ được tính phí như server của bạn báo cáo. Một server trung thực rất hiếm khi bị giới hạn. Các phản hồi vượt quá giới hạn cũng sẽ được tính vào các kiểm tra ưu đãi của bạn, giống như trước đây.

Thu nhập và thanh toán

Bảng điều khiển người bán có sáu tab: Thu nhập, Thanh toán, Ưu đãi (mỗi mô hình bạn bán, được nhóm theo nhà cung cấp, lọc theo Trực tiếp / Đang xem xét / Cần chú ý, và các khóa nhà cung cấp đã lưu của bạn), Ưu đãi mới, Khóa đại lý và Thị trường nhà cung cấp.

  • Thị trường nhà cung cấp (GET /seller/market): mỗi khóa nhà cung cấp bạn niêm yết trong 30 ngày qua: số tiền kiếm được, số cuộc gọi đã phục vụ và tỷ lệ thắng của nó, tức là phần trăm thắng trong mỗi cuộc gọi mà người mua thực hiện trên cùng các mô hình (thông qua bất kỳ ai, vì vậy đây là mức trần, không phải nhu cầu nhắm vào bạn). Nó cũng hiển thị doanh thu hôm nay so với giới hạn hàng ngày của mỗi khóa (chúng được đặt lại vào 00:00 UTC).

  • GET /seller/earnings?range=7d|30d|90d|all — thu nhập, doanh số và token, theo mô hình, cùng với thị trường xung quanh mỗi mô hình của bạn (mức chiết khấu rẻ nhất hiện tại và mức chiết khấu thực tế của thị trường trong giờ qua) để bạn có thể biết cách định giá. daily liệt kê số tiền bạn kiếm được mỗi ngày UTC với doanh số, và avg_discount_pct cho biết người mua đã trả thấp hơn giá niêm yết trung bình bao nhiêu (chưa hiển thị cho đến khi bạn có doanh số trên một mô hình có giá niêm yết).

  • GET /seller/payouts — có sẵn để thanh toán (owed_usd), đang giữ (held_usd, và next_release_at: khi phần tiếp theo sẵn sàng), đang trên đường và đã thanh toán dưới dạng các số riêng biệt, nơi các khoản thanh toán của bạn được gửi đến (payout_method, null cho đến khi bạn thiết lập), cộng với lịch sử thanh toán của bạn.

  • PUT /seller/payout-method {method, address} — nơi gửi tiền của bạn: {"method":"paypal","address":"[email protected]"} (email tài khoản PayPal của bạn) hoặc {"method":"usdc_base","address":"0x…"} (ví của bạn trên Base, 0x và 40 ký tự hex; chúng tôi chỉ gửi USDC trên mạng Base). Trả lời {method, address, set_at} đã lưu. Trong bảng điều khiển: Thanh toán → Nơi nhận thanh toán.

Thu nhập được giữ lại trước khi có thể thanh toán: 14 ngày khi bạn là người bán mới (30 ngày đầu tiên của bạn, hoặc cho đến khi bạn kiếm được tổng cộng $500), sau đó là 7 ngày. Bằng cách đó, người mua có thể được hoàn tiền nếu một ưu đãi hóa ra không phục vụ mô hình mà nó niêm yết. Trang Bán hàng hiển thị Có sẵn để thanh toán và Đang giữ, cùng với ngày phần tiếp theo sẵn sàng. Tiền cũng có thể bị giữ lại, không có ngày cụ thể, trong khi một cuộc kiểm tra trên một trong các ưu đãi của bạn đang diễn ra.

Các khoản thanh toán trên $100 cần kiểm tra danh tính một lần. Trước khi chúng tôi gửi một khoản thanh toán trên $100,, một người trong nhóm của chúng tôi sẽ xác nhận bạn là ai. Chúng tôi sẽ gửi email cho bạn để thiết lập; cho đến lúc đó khoản thanh toán đó sẽ chờ, và không có gì bị mất.

Khi đã thoát khỏi trạng thái giữ, số tiền có sẵn sẽ tự động được đưa vào một khoản thanh toán khi nó đạt $5, hoặc 72 giờ sau khi giao dịch bán hàng chưa thanh toán cũ nhất của bạn thoát khỏi trạng thái giữ (được kiểm tra mỗi 10 phút). Bạn cũng có thể yêu cầu thanh toán bất cứ lúc nào (POST /seller/payouts/request, nút Thanh toán cho tôi ngay). Bạn chỉ có một khoản thanh toán đang trên đường tại một thời điểm: số tiền bạn kiếm được trong thời gian chờ đợi sẽ vẫn nợ và sẽ được đưa vào khoản thanh toán tiếp theo của bạn sau khi khoản hiện tại đã được thanh toán (yêu cầu một khoản khác trả lời 409 payout_already_on_the_way).

Nhóm của chúng tôi gửi mỗi khoản thanh toán đến email PayPal hoặc ví USDC (Base) mà bạn đã thiết lập, thường trong vòng 2 ngày làm việc kể từ khi nó bắt đầu. Nếu một khoản thanh toán bắt đầu trước khi bạn thiết lập, chúng tôi sẽ gửi email cho chủ sở hữu tài khoản của bạn để hỏi, và gửi nó ngay khi bạn làm. Một khoản thanh toán chỉ được tính là đã thanh toán khi nó thực sự đã được gửi; mã tham chiếu thanh toán sau đó sẽ hiển thị bên cạnh nó, và chúng tôi sẽ gửi email cho bạn rằng nó đã được gửi.

Nếu một khoản thanh toán không thể được gửi (ví dụ: email PayPal không thể nhận tiền), nó sẽ hiển thị là Không thành công kèm theo lý do. Không có gì bị mất: số tiền đó sẽ được nợ bạn lại và sẽ được gửi cùng với khoản thanh toán tiếp theo của bạn, và chúng tôi sẽ gửi email cho bạn để kiểm tra nơi chúng tôi gửi tiền của bạn.

API

Khi đăng nhập trên web, API người bán nằm ở /api/v1/seller. Với API key MartLLM của bạn (cái mà tác nhân của bạn nhận được từ uberllm khi đăng nhập), API tương tự nằm ở /v1/seller.

Agent keys (Bán hàng › Agent keys) cho phép một script hoặc tác nhân quản lý các ưu đãi của bạn mà không cần đăng nhập của bạn và không cần spending key của bạn. Một agent key chỉ gọi /v1/seller: nó có thể tạo, thay đổi, tạm dừng và xóa ưu đãi, test key, đọc thu nhập và yêu cầu thanh toán, cũng như liệt kê, tạo và thu hồi agent key (GET/POST /v1/seller/agent-keys {name}, DELETE /v1/seller/agent-keys/{id}; toàn bộ key được trả lời một lần). Nó không thể thực hiện các yêu cầu AI, chi tiêu tín dụng, thay đổi nơi nhận thanh toán của bạn (/seller/payout-method trả lời 403 agent_key_not_allowed), hoặc quản lý API key, tín dụng hay tài khoản của bạn. Tối đa 25 mỗi tài khoản; thu hồi một cái có hiệu lực ngay lập tức, và các ưu đãi nó tạo ra vẫn tiếp tục hoạt động.

curl https://api.martllm.com/v1/seller/offers -H "Authorization: Bearer $UBERLLM_SELLER_KEY"
Gọi Chức năng
POST /seller/register {display_name?} Bắt đầu bán hàng (một lần). Tên là tùy chọn: nếu bỏ trống, bạn sẽ được hiển thị là "Seller" cộng thêm 4 chữ cái. Trang Bán hàng sẽ làm điều này cho bạn.
GET /seller/providers Các nhà cung cấp bạn có thể bán từ: id, name, base_url, và trusted (đã xác minh).
POST /seller/discover {base_url, api_key} or {config_id} Các model mà một key có thể phục vụ, được khớp với của chúng tôi (open_weights: true = liệt kê nó cần một precision). Không tốn quota.
POST /seller/test {base_url, api_key, models[]} Một yêu cầu kiểm tra nhỏ cho mỗi model.
POST /seller/offers/bulk Liệt kê nhiều model trên một key: {endpoint_url, api_key, save_config, daily_cap_usd, precision, offers:[{model_id, upstream_model, precision, discount_pct | match_best}]}. precision (full, 8bit hoặc below8) là bắt buộc đối với các model mã nguồn mở; cái cấp cao nhất áp dụng cho mọi model mã nguồn mở trong lô. Mỗi model được kiểm tra khi nó được liệt kê; cái nào thất bại sẽ bị bỏ qua kèm theo lý do.
POST /seller/offers Liệt kê một model: {model_id, endpoint_url, api_key, upstream_model, precision, discount_pct, daily_cap_usd}.
GET /seller/offers · GET /seller/offers/{id} Các ưu đãi của bạn với giá, % giảm giá, tình trạng hoạt động, trạng thái (listing_state: review, checking, live, paused hoặc suspended; needs_review: true trong khi nhóm của chúng tôi chưa phê duyệt; review_note kèm lý do khi nhóm của chúng tôi không phê duyệt; với check_reason khi nó không vượt qua kiểm tra model) và thứ hạng trực tiếp (vị trí của bạn trong số tất cả những gì người mua có thể được gửi đến cho model đó). provider_listed: false = địa chỉ của nó không có trong danh sách nhà cung cấp của chúng tôi: không có người mua, không thể bật, lý do ở blocked_reason.
PATCH /seller/offers/{id} Định giá lại (discount_pct), giới hạn (daily_cap_usd, 0 loại bỏ nó), precision (các model mã nguồn mở), status: paused | active (một ưu đãi không vượt qua kiểm tra model không thể bật lại).
POST /seller/offers/{id}/rotate-credential {api_key} Key mới, được kiểm tra trước khi chấp nhận.
POST /seller/offers/{id}/reset-health Hiện đã trở lại định tuyến.
DELETE /seller/offers/{id} Xóa: ra khỏi định tuyến, key đã lưu bị xóa.
GET /seller/configs · DELETE /seller/configs/{id} Các key đã lưu để bắt đầu ưu đãi mới (chỉ một gợi ý 4 ký tự được hiển thị).
GET /seller/health-log Tại sao các ưu đãi bị bỏ qua hoặc tạm dừng (key_rejected = nhà cung cấp từ chối key ba lần liên tiếp).
GET /seller/earnings · GET /seller/payouts · POST /seller/payouts/request Tiền: số tiền có sẵn, đang giữ, đang chuyển và đã thanh toán.
PUT /seller/payout-method {method: paypal | usdc_base, address} Nơi thanh toán của bạn được gửi đến: một email PayPal hoặc một ví USDC trên Base.
curl https://api.martllm.com/v1/seller/offers/bulk \
  -H "Authorization: Bearer $UBERLLM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "endpoint_url": "https://openrouter.ai/api/v1",
    "api_key": "<your provider key>",
    "save_config": true,
    "offers": [
      { "model_id": "meta-llama/llama-3.3-70b-instruct", "match_best": true }
    ]
  }'

endpoint_url phải là base_url của nhà cung cấp từ GET /seller/providers. Trường hợp nhà cung cấp đặt tên model khác với chúng tôi, hãy gửi upstream_model: server_model mà POST /seller/discover đã trả về cho model đó.

Dành cho các tác nhân

Tác nhân của bạn đã có một API key của MartLLM sau khi đăng nhập. Nó có thể đăng ký, tìm các mô hình trên một provider key, liệt kê chúng và theo dõi thu nhập với các lệnh gọi ở trên dưới /v1/seller. Không cần loại key nào khác.

Chỉ niêm yết những gì bạn được phép bán lại

  • ✅ Dung lượng tại một nhà cung cấp trong danh sách của chúng tôi mà bạn được phép bán lại.
  • ❌ Máy chủ của riêng bạn, hoặc một nhà cung cấp không có trong danh sách của chúng tôi. Hãy yêu cầu chúng tôi thêm nhà cung cấp: [email protected].
  • ❌ Một API key của nhà cung cấp mà các điều khoản không cho phép bạn bán lại hoặc cấp quyền truy cập cho người khác. Điều khoản của nhiều nhà cung cấp không cho phép: hãy kiểm tra điều khoản của bạn trước khi niêm yết.
  • ❌ Các API key bị đánh cắp, bị rò rỉ, được chia sẻ, dùng thử miễn phí hoặc dùng để đánh giá. Một ưu đãi vi phạm các quy tắc này sẽ bị gỡ bỏ.

Sử dụng một API key của nhà cung cấp dành riêng với giới hạn chi tiêu. Bạn chịu trách nhiệm về việc cấp phép và hoạt động hợp pháp của những gì bạn niêm yết.