OpenRouter

200+ მოდელზე წვდომა მრავალი პროვაიდერიდან (OpenAI, Anthropic, Google, Meta, Mistral და სხვები) ერთი API გასაღებითა და ერთიანი ინტერფეისით.

წინაპირობები

• OpenRouter API გასაღები openrouter.ai-დან

სწრაფი დაყენება

1. API გასაღების მიღება

1. დარეგისტრირდით openrouter.ai-ზე
2. გადახვიდეთ Keys განყოფილებაში სამართავ პანელზე
3. დააჭირეთ Create Key-ს და დააკოპირეთ (იწყება sk-or--ით)

2. კონფიგურაცია

[default]
provider = "openrouter"
model = "anthropic/claude-sonnet-4"

[providers.openrouter]
api_key = "${OPENROUTER_API_KEY}"

ან დააყენეთ გარემოს ცვლადი:

export OPENROUTER_API_KEY="sk-or-..."

3. შემოწმება

prx doctor models

ხელმისაწვდომი მოდელები

OpenRouter ასობით მოდელზე წვდომას უზრუნველყოფს. რამდენიმე პოპულარული ვარიანტი:

მოდელი	პროვაიდერი	კონტექსტი	ვიზუალი	ინსტრუმენტები	შენიშვნები
anthropic/claude-sonnet-4	Anthropic	200K	დიახ	დიახ	Claude Sonnet 4
anthropic/claude-opus-4	Anthropic	200K	დიახ	დიახ	Claude Opus 4
openai/gpt-4o	OpenAI	128K	დიახ	დიახ	GPT-4o
openai/o3	OpenAI	128K	დიახ	დიახ	მსჯელობის მოდელი
google/gemini-2.5-pro	Google	1M	დიახ	დიახ	Gemini Pro
google/gemini-2.5-flash	Google	1M	დიახ	დიახ	Gemini Flash
meta-llama/llama-3.1-405b-instruct	Meta	128K	არა	დიახ	ყველაზე დიდი ღია მოდელი
deepseek/deepseek-chat	DeepSeek	128K	არა	დიახ	DeepSeek V3
mistralai/mistral-large	Mistral	128K	არა	დიახ	Mistral Large
x-ai/grok-2	xAI	128K	არა	დიახ	Grok 2

სრული მოდელების სია იხილეთ openrouter.ai/models-ზე.

კონფიგურაციის მითითება

ველი	ტიპი	ნაგულისხმევი	აღწერა
api_key	string	სავალდებულო	OpenRouter API გასაღები (sk-or-...)
model	string	სავალდებულო	მოდელის ID პროვაიდერი/მოდელი ფორმატში

ფუნქციები

ერთიანი მრავალ-პროვაიდერული წვდომა

ერთი OpenRouter API გასაღებით შეგიძლიათ მოდელებზე წვდომა OpenAI-დან, Anthropic-დან, Google-დან, Meta-დან, Mistral-დან, Cohere-დან და სხვა მრავალიდან. ეს მრავალი API გასაღების მართვის აუცილებლობას აქარწყლებს.

OpenAI-თავსებადი API

OpenRouter OpenAI-თავსებად Chat Completions API-ს ავრცელებს მისამართზე https://openrouter.ai/api/v1/chat/completions. PRX მოთხოვნებს აგზავნის შემდეგით:

• Authorization: Bearer <key> ავტენტიფიკაციისთვის
• HTTP-Referer: https://github.com/theonlyhennygod/openprx აპლიკაციის იდენტიფიკაციისთვის
• X-Title: OpenPRX აპლიკაციის სახელის ატრიბუციისთვის

მშობლიური ინსტრუმენტების გამოძახება

ინსტრუმენტები OpenAI-ის მშობლიურ ფუნქციების გამოძახების ფორმატში იგზავნება. პროვაიდერი მხარს უჭერს tool_choice: "auto"-ს და სწორად ამუშავებს სტრუქტურირებულ ინსტრუმენტის გამოძახების პასუხებს tool_call_id შესაბამისობის ჩათვლით მრავალბიჯიანი ინსტრუმენტების ინტერაქციებისთვის.

მრავალბიჯიანი საუბრის ისტორია

საუბრის სრული ისტორია ინახება სათანადო სტრუქტურირებული ფორმატირებით:

• ასისტენტის შეტყობინებები ინსტრუმენტების გამოძახებებით სერიალიზდება tool_calls მასივებით
• ინსტრუმენტის შედეგის შეტყობინებები მოიცავს tool_call_id მითითებებს
• სისტემური, მომხმარებლის და ასისტენტის შეტყობინებები პირდაპირ გადადის

კავშირის გახურება

გაშვებისას PRX მსუბუქ მოთხოვნას აგზავნის https://openrouter.ai/api/v1/auth/key-ზე API გასაღების შესამოწმებლად და TLS/HTTP2 კავშირების პულის შესაქმნელად.

მოდელების მარშრუტიზაცია

OpenRouter მხარს უჭერს მოდელების მარშრუტიზაციასა და სარეზერვო ვარიანტს API დონეზე. ასევე შეგიძლიათ PRX-ის ჩაშენებული fallback_providers გამოყენება კლიენტის მხრიდან სარეზერვო ვარიანტისთვის:

[default]
provider = "openrouter"
model = "anthropic/claude-sonnet-4"

[reliability]
fallback_providers = ["openai"]

ნაგულისხმევი პროვაიდერი

OpenRouter არის PRX-ის ნაგულისხმევი პროვაიდერი. თუ თქვენს კონფიგურაციაში provider მითითებული არ არის, PRX ნაგულისხმევად OpenRouter-ს იყენებს.

პრობლემების მოგვარება

"OpenRouter API key not set"

დააყენეთ OPENROUTER_API_KEY გარემოს ცვლადი ან დაამატეთ api_key თქვენს config.toml-ში [providers.openrouter] სექციაში. ასევე შეგიძლიათ prx onboard-ის გაშვება ინტერაქტიული კონფიგურაციისთვის.

402 Payment Required

თქვენს OpenRouter ანგარიშზე არასაკმარისი კრედიტია. დაამატეთ კრედიტები openrouter.ai/credits-ზე.

მოდელის სპეციფიკური შეცდომები

OpenRouter-ზე სხვადასხვა მოდელს სხვადასხვა შესაძლებლობები და ლიმიტები აქვს. თუ კონკრეტული მოდელი შეცდომებს აბრუნებს:

• შეამოწმეთ, უჭერს თუ არა მოდელი მხარს ინსტრუმენტების გამოძახებას (ყველა არ უჭერს)
• დარწმუნდით, რომ მოდელი არ არის მოძველებული OpenRouter-ზე
• სცადეთ სხვა მოდელის ვარიანტი

ნელი პასუხები

OpenRouter მოთხოვნებს ძირითად პროვაიდერზე მარშრუტიზებს. პასუხის დრო დამოკიდებულია:

• მოდელის პროვაიდერის მიმდინარე დატვირთვაზე
• თქვენს გეოგრაფიულ დაშორებულობაზე პროვაიდერთან
• მოდელის ზომასა და კონტექსტის სიგრძეზე

გაითვალისწინეთ fallback_providers-ის გამოყენება პროვაიდერთან პირდაპირ კავშირზე გადასართავად, თუ OpenRouter ნელია.

შეზღუდვა

OpenRouter-ს აქვს საკუთარი ლიმიტები ძირითადი პროვაიდერის ლიმიტების გარდა. შეზღუდვის შემთხვევაში:

• შეამოწმეთ თქვენი გამოყენება openrouter.ai/usage-ზე
• განაახლეთ თქვენი გეგმა უფრო მაღალი ლიმიტებისთვის
• გამოიყენეთ PRX-ის სანდო პროვაიდერის შემფუთველი ავტომატური ხელახალი ცდისთვის უკუსვლით