शुरुआत

मॉडल id और वेरिएंट

मॉडल id provider/model फ़ॉर्मेट में होते हैं। :free, :online, :nitro और :floor वेरिएंट, फ़ॉलबैक, allowlist और प्लान के नियम यहाँ समझें।

api14 पर मॉडल id provider/model रूप में होते हैं, उदाहरण के लिए openai/gpt-5-mini। किसी भी अनुरोध के model फ़ील्ड में id पास करें।

{ "model": "anthropic/claude-sonnet-4.5" }

मॉडल id खोजना

मॉडल पेज देखें, हर मॉडल अपने id, कीमतों, कॉन्टेक्स्ट लंबाई और क्षमताओं के साथ।
कोड से GET /models कॉल करें; श्रेणी से फ़िल्टर करने के लिए ?category=image इस्तेमाल करें। देखें मॉडल।

कुछ उदाहरण:

श्रेणी	उदाहरण id
टेक्स्ट	`openai/gpt-5-mini`, `anthropic/claude-sonnet-4.5`, `google/gemini-2.5-pro`, `deepseek/deepseek-chat`
इमेज	`openai/gpt-5.4-image-2`, `google/gemini-2.5-flash-image`
वीडियो	`google/veo-3.1-fast`, `openai/sora-2-pro`
स्पीच (TTS)	`openai/gpt-4o-mini-tts`
ट्रांसक्रिप्शन	`openai/whisper-1`, `openai/gpt-4o-transcribe`
एम्बेडिंग	`openai/text-embedding-3-small`
रीरैंक	`cohere/rerank-v3.5`

id केस-संवेदी हैं। अज्ञात या अक्षम id 404 model_not_found लौटाता है।

वेरिएंट

वेरिएंट कोलन के बाद का प्रत्यय है जो बदलता है कि अनुरोध कैसे परोसा जाए। वेरिएंट उसी बेस मॉडल के साथ काम करते हैं; बेस मॉडल की उपलब्धता और allowlist के नियम लागू होते हैं।

प्रत्यय	प्रभाव
`:free`	मॉडल का मुफ़्त एंडपॉइंट, जहाँ मौजूद हो। मुफ़्त एंडपॉइंट पर अपस्ट्रीम रेट लिमिट सख़्त होती है।
`:online`	प्रॉम्प्ट में वेब सर्च नतीजे जोड़ता है। देखें वेब सर्च।
`:nitro`	सबसे तेज़ प्रोवाइडर (सबसे ऊँचा थ्रूपुट) तक रूट करता है।
`:floor`	सबसे सस्ते प्रोवाइडर तक रूट करता है।

{ "model": "openai/gpt-5-mini:online" }

:nitro और :floor प्रोवाइडर सॉर्टिंग के शॉर्टकट हैं, जैसे provider: { sort: "throughput" } और provider: { sort: "price" }। देखें प्रोवाइडर रूटिंग और फ़ॉलबैक।

मॉडल फ़ॉलबैक

पहला मॉडल विफल या अनुपलब्ध होने पर अन्य मॉडल आज़माने के लिए models ऐरे भेजें:

{
  "model": "anthropic/claude-sonnet-4.5",
  "models": ["openai/gpt-5-mini", "google/gemini-2.5-flash"],
  "messages": [{ "role": "user", "content": "Hello" }]
}

सूची का हर मॉडल उपलब्ध और आपकी कुंजी तथा प्लान के लिए अनुमत होना चाहिए, वरना अनुरोध भेजे जाने से पहले ही अस्वीकार हो जाता है। प्रतिक्रिया का model फ़ील्ड बताता है कि किसने उत्तर दिया, और आप उसी मॉडल की कीमत चुकाते हैं।

Allowlist और प्लान

मॉडल allowlist वाली कुंजी केवल सूचीबद्ध id इस्तेमाल कर सकती है; अन्य id 403 model_not_allowed लौटाते हैं।
हर प्लान, Free समेत, सभी मॉडल श्रेणियों को कवर करता है, जिनमें वीडियो और म्यूज़िक/ऑडियो भी हैं। कुछ ही श्रेणियों तक सीमित प्लान बाकी श्रेणियों के लिए 403 plan_required लौटाता है। देखें कीमत और बिलिंग।

मॉडल में बदलाव

कैटलॉग अपने आप अपडेट होता है। नए मॉडल खुद दिखने लगते हैं; हटाए गए मॉडल 404 model_not_found लौटाते हैं। प्रोडक्शन में सटीक id पिन करें और मज़बूती के लिए models फ़ॉलबैक इस्तेमाल करें।