openai gem के साथ Ruby में पहला request: base_url, key, usage

हाँ, आधिकारिक openai gem CheapTokens के साथ काम करता है: base_url: "https://api.cheaptokens.dev/v1" और अपनी key को OpenAI::Client.new में पास करें, client.chat.completions.create कॉल करें, और choices.first.message.content से टेक्स्ट पढ़ें। इस पेज का बाकी हिस्सा पूरी स्क्रिप्ट है, जो वापस आता है उसे कैसे पढ़ें, और जब यह न चले तो क्या जाँचें।

मान लीजिए आपके पास एक rake task है जो support tickets को label करता है, या एक background job है जो किसी note को सेव करने से पहले उसका सारांश बनाता है। आपको आधिकारिक SDK चाहिए, हाथ से लिखा HTTP नहीं, और आप देखना चाहते हैं कि हर कॉल में कितने tokens लगे। यही यह स्क्रिप्ट है।

शुरू करने से पहले आपको क्या चाहिए#

RubyGems पर gem पेज (8 नवंबर 2026 को जाँचा गया) openai 0.120.0 सूचीबद्ध करता है, जो 5 नवंबर 2026 को रिलीज़ हुआ, Apache-2.0। इसे Ruby 3.3.0 या नया चाहिए; अगर आप Ruby 3.2 पर अटके हैं, तो gem के अपने नोट्स 0.75.x लाइन की ओर इशारा करते हैं। पैकेज अभी भी 0.x है और तेज़ी से बदलता है, इसलिए version pin करें।

अपने Gemfile में:

gem "openai", "~> 0.120.0"

फिर bundle install। Bundler के बिना, gem install openai -v 0.120.0 वही काम करता है।

आपको अपने CheapTokens account से एक API key भी चाहिए। इसे code से बाहर रखें: इसे एक environment variable में डालें, और अगर .gitignore शब्द आपके लिए नया है, तो keys को सुरक्षित रखने पर यह गाइड पाँच मिनट का पाठ है।

export CHEAPTOKENS_API_KEY="sk-your-key"

स्क्रिप्ट#

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

इसे ruby ask.rb से चलाएँ। तीन चीज़ें दोबारा देखने लायक हैं।

ENV[...] के बजाय ENV.fetch। अगर variable मौजूद नहीं है, तो fetch तुरंत एक KeyError के साथ रुक जाता है जो उसका नाम बताता है। ENV[...] चुपचाप nil पास कर देता है और आपको कुछ लाइनों बाद एक भ्रमित करने वाला authentication error मिलता है।

base_url: ही एकमात्र लाइन है जो gem के README में दिए OpenAI उदाहरणों से अलग है। बाकी सब वही code है, और OpenAI-compatible API का पूरा मतलब यही है। अगर यह विचार नया है, तो base_url क्या है और कैसे बदलें इसे एक restaurant analogy के साथ समझाता है।

Model id पूरा वाला है, deepseek-ai/DeepSeek-V4-Flash-0731। किसी price table से छोटा नाम API स्वीकार नहीं करता; ids CheapTokens docs से या GET /v1/models से लें।

जो वापस आता है उसे पढ़ना#

Reply एक object है, hash नहीं, इसलिए आप उस पर methods कॉल करते हैं। टेक्स्ट completion.choices.first.message.content पर है; gem का README भी यही path इस्तेमाल करता है।

पहले दिन से दो और लाइनें print करने लायक हैं:

• finish_reason बताता है कि model क्यों रुका। stop सामान्य अंत है। length का मतलब है कि किसी length limit ने जवाब काट दिया। अगर आपको यह कभी दिखे, तो जवाब क्यों कट जाते हैं और इसे कैसे ठीक करें।
• usage में वे tokens होते हैं जिनके लिए कॉल का बिल बना: आपने जो भेजा और model ने जो लिखा। स्क्रिप्ट puts completion.usage के साथ पूरा object print करती है, इसलिए आप दोनों संख्याएँ वैसे ही देखते हैं जैसे API ने लौटाईं।

इन्हें log क्यों करें? क्योंकि tokens ही बिल हैं। एक वाक्य का सवाल और एक वाक्य का जवाब बहुत छोटा है, लेकिन दिन में हज़ार बार चलने वाला job नहीं। Input vs output tokens समझाता है कि दूसरी संख्या का प्रति token खर्च आमतौर पर ज़्यादा क्यों होता है।

ऐसी कॉल की लागत#

CheapTokens पर DeepSeek-V4-Flash $0.015 प्रति 1M input tokens और $0.10 प्रति 1M output tokens है, दिन के किसी भी घंटे में वही कीमत। एक ticket-labeling job लें: प्रति ticket लगभग 300 tokens अंदर, 150 tokens बाहर। एक ticket की लागत $0.00002 है। हज़ार tickets ऐसे दिखते हैं, अगली column में OpenRouter का reference price:

Model 380K tokens तक context और एक जवाब में 32,768 tokens तक लेता है, इसलिए summarizing job शायद ही कभी दीवार से टकराता है। अगर आप उसी स्क्रिप्ट से दूसरा model आज़माना चाहें, तो सिर्फ़ model: string को zai-org/GLM-5.3-Flash में बदलें (390K context, 8,192 output tokens तक)।

अगर यह न चले#

पहली बार चलाने की ज़्यादातर विफलताएँ पाँच में से एक होती हैं। जो आपकी स्क्रीन से मेल खाए उसे चुनें।

401 और 404 वाले मामले हर SDK में आते हैं, सिर्फ़ Ruby में नहीं; API 401 या 404: गलत key, base URL या model id इन्हें क्रम से समझाता है।

आगे कहाँ जाएँ#

अब आपके पास सबसे छोटा उपयोगी loop है: भेजें, टेक्स्ट पढ़ें, tokens log करें। यहाँ से, कॉल को एक method में लपेटें, और अपने logger में usage संख्याएँ जोड़ें। अगर आपका stack मिला-जुला है तो यही pattern दूसरी भाषाओं में भी है: Go, Java और C#। models और कीमतों की पूरी सूची models page पर है, और API reference docs में है।