Yêu cầu đầu tiên bằng Ruby với gem openai: base_url, key, usage

Có, gem chính thức openai hoạt động với CheapTokens: truyền base_url: "https://api.cheaptokens.dev/v1" và key của bạn vào OpenAI::Client.new, gọi client.chat.completions.create, và đọc văn bản từ choices.first.message.content. Phần còn lại của trang này là toàn bộ script, cách đọc kết quả trả về, và những gì cần kiểm tra khi nó không chạy.

Giả sử bạn có một rake task gắn nhãn cho ticket hỗ trợ, hoặc một background job tóm tắt ghi chú trước khi lưu. Bạn muốn dùng SDK chính thức, không phải tự viết HTTP, và bạn muốn xem mỗi lần gọi dùng bao nhiêu token. Đó chính xác là script này.

Những gì bạn cần trước khi bắt đầu#

Trang gem trên RubyGems (kiểm tra ngày 8 tháng 11 năm 2026) liệt kê openai 0.120.0, phát hành ngày 5 tháng 11 năm 2026, Apache-2.0. Nó cần Ruby 3.3.0 trở lên; nếu bạn còn kẹt ở Ruby 3.2, ghi chú của chính gem chỉ sang dòng 0.75.x. Gói vẫn ở 0.x và thay đổi nhanh, nên hãy ghim phiên bản.

Trong Gemfile của bạn:

gem "openai", "~> 0.120.0"

Sau đó bundle install. Không dùng Bundler thì gem install openai -v 0.120.0 làm điều tương tự.

Bạn cũng cần một API key từ tài khoản CheapTokens. Đừng để nó trong code: đặt nó vào một biến môi trường, và nếu từ .gitignore còn mới với bạn, hướng dẫn giữ key an toàn này chỉ mất năm phút đọc.

export CHEAPTOKENS_API_KEY="sk-your-key"

Script#

Tạo ask.rb:

require "openai"

client = OpenAI::Client.new(
  api_key: ENV.fetch("CHEAPTOKENS_API_KEY"),
  base_url: "https://api.cheaptokens.dev/v1"
)

completion = client.chat.completions.create(
  model: "deepseek-ai/DeepSeek-V4-Flash-0731",
  messages: [
    { role: "user", content: "Explain in one sentence what a token is." }
  ]
)

choice = completion.choices.first
puts choice.message.content
puts "finish_reason: #{choice.finish_reason}"
puts completion.usage

Chạy nó bằng ruby ask.rb. Có ba điều đáng xem lại.

ENV.fetch thay vì ENV[...]. Nếu biến bị thiếu, fetch dừng ngay lập tức với một KeyError nêu tên nó. ENV[...] lặng lẽ truyền nil và bạn nhận được lỗi xác thực khó hiểu vài dòng sau đó.

base_url: là dòng duy nhất khác với các ví dụ OpenAI trong README của gem. Mọi thứ khác đều là cùng một đoạn code, đó chính là mục đích của một API tương thích OpenAI. Nếu khái niệm này còn mới, base_url là gì và cách chuyển đổi giải thích nó bằng một phép so sánh nhà hàng.

Model id là id đầy đủ, deepseek-ai/DeepSeek-V4-Flash-0731. Tên ngắn từ bảng giá không được API chấp nhận; hãy lấy id từ tài liệu CheapTokens hoặc từ GET /v1/models.

Đọc kết quả trả về#

Phản hồi là một object, không phải hash, nên bạn gọi phương thức trên nó. Văn bản nằm ở completion.choices.first.message.content; đó cũng là đường dẫn mà README của gem dùng.

Hai dòng nữa đáng in ra ngay từ ngày đầu:

• finish_reason cho bạn biết vì sao model dừng. stop là kết thúc bình thường. length nghĩa là một giới hạn độ dài đã cắt câu trả lời. Nếu bạn gặp trường hợp đó, vì sao câu trả lời bị cắt và cách khắc phục.
• usage chứa số token mà lần gọi được tính phí: những gì bạn gửi và những gì model viết. Script in toàn bộ object bằng puts completion.usage, nên bạn thấy cả hai con số như API trả về.

Vì sao ghi log chúng? Vì token chính là hóa đơn. Một câu hỏi một câu với câu trả lời một câu thì rất nhỏ, nhưng một job chạy nghìn lần mỗi ngày thì không. Token đầu vào so với đầu ra giải thích vì sao con số thứ hai thường tốn hơn trên mỗi token.

Một lần gọi như thế này tốn bao nhiêu#

DeepSeek-V4-Flash trên CheapTokens là $0.015 mỗi 1M token đầu vào và $0.10 mỗi 1M token đầu ra, với cùng mức giá vào bất kỳ giờ nào trong ngày. Lấy một job gắn nhãn ticket: khoảng 300 token vào, 150 token ra mỗi ticket. Một ticket tốn $0.00002. Một nghìn ticket trông như thế này, với giá tham chiếu của OpenRouter ở cột bên cạnh:

Model nhận tối đa 380K token ngữ cảnh và tối đa 32.768 token trong một câu trả lời, nên một job tóm tắt hiếm khi chạm giới hạn. Nếu bạn muốn thử model thứ hai với cùng script, chỉ cần đổi chuỗi model: thành zai-org/GLM-5.3-Flash (390K ngữ cảnh, tối đa 8.192 token đầu ra).

Nếu nó không chạy#

Hầu hết lỗi lần chạy đầu là một trong năm trường hợp. Chọn trường hợp khớp với màn hình của bạn.

Các trường hợp 401 và 404 xuất hiện với mọi SDK, không chỉ Ruby; API 401 hoặc 404: sai key, base URL hoặc model id đi qua chúng theo thứ tự.

Tiếp theo nên đi đâu#

Giờ bạn đã có vòng lặp hữu ích nhỏ nhất: gửi, đọc văn bản, ghi log token. Từ đây, hãy bọc lời gọi trong một phương thức, và thêm các con số usage vào logger của bạn. Cùng mẫu này có ở các ngôn ngữ khác nếu stack của bạn hỗn hợp: Go, Java và C#. Danh sách đầy đủ các model và giá nằm ở trang model, và tài liệu tham chiếu API ở trong tài liệu.