Google Gemini

Gemini მოდელებზე წვდომა Google Generative Language API-ით, API გასაღებების, Gemini CLI OAuth ტოკენების და 2M ტოკენამდე გრძელი კონტექსტის ფანჯრების მხარდაჭერით.

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

• Google AI Studio API გასაღები aistudio.google.com-დან, ან
• Gemini CLI დაყენებული და ავტენტიფიცირებული (gemini ბრძანება), ან
• GEMINI_API_KEY ან GOOGLE_API_KEY გარემოს ცვლადი

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

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

ვარიანტი A: API გასაღები (რეკომენდებულია უმეტესი მომხმარებლებისთვის)

1. ეწვიეთ aistudio.google.com/app/apikey
2. დააჭირეთ Create API key-ს
3. დააკოპირეთ გასაღები

ვარიანტი B: Gemini CLI (ნულოვანი კონფიგურაცია არსებული მომხმარებლებისთვის)

თუ უკვე იყენებთ Gemini CLI-ს, PRX ავტომატურად ამოიცნობს თქვენს OAuth ტოკენს ~/.gemini/oauth_creds.json-დან. დამატებითი კონფიგურაცია არ არის საჭირო.

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

[default]
provider = "gemini"
model = "gemini-2.5-flash"

[providers.gemini]
api_key = "${GEMINI_API_KEY}"

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

export GEMINI_API_KEY="AIza..."

3. შემოწმება

prx doctor models

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

მოდელი	კონტექსტი	ვიზუალი	ინსტრუმენტები	შენიშვნები
gemini-2.5-pro	1M	დიახ	დიახ	ყველაზე შეძლებული Gemini მოდელი
gemini-2.5-flash	1M	დიახ	დიახ	სწრაფი და ეკონომიური
gemini-2.0-flash	1M	დიახ	დიახ	წინა თაობის flash
gemini-1.5-pro	2M	დიახ	დიახ	ყველაზე გრძელი კონტექსტის ფანჯარა
gemini-1.5-flash	1M	დიახ	დიახ	წინა თაობა

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

ველი	ტიპი	ნაგულისხმევი	აღწერა
api_key	string	არასავალდებულო	Google AI API გასაღები (AIza...)
model	string	gemini-2.5-flash	ნაგულისხმევი მოდელი

ფუნქციები

ავტენტიფიკაციის მრავალი მეთოდი

PRX Gemini-ის ავტორიზაციის მონაცემებს შემდეგი პრიორიტეტით წყვეტს:

პრიორიტეტი	წყარო	როგორ მუშაობს
1	ექსპლიციტური API გასაღები კონფიგურაციაში	იგზავნება როგორც ?key= მოთხოვნის პარამეტრი საჯარო API-ზე
2	GEMINI_API_KEY გარემოს ცვლადი	იგივე, რაც ზემოთ
3	GOOGLE_API_KEY გარემოს ცვლადი	იგივე, რაც ზემოთ
4	Gemini CLI OAuth ტოკენი	იგზავნება როგორც Authorization: Bearer შიდა Code Assist API-ზე

Gemini CLI OAuth ინტეგრაცია

თუ Gemini CLI-ით (gemini ბრძანება) ავტენტიფიცირებული ხართ, PRX ავტომატურად:

1. კითხულობს ~/.gemini/oauth_creds.json-ს
2. ამოწმებს ტოკენის ვადას (ვადაგასულ ტოკენებს გამოტოვებს გაფრთხილებით)
3. მოთხოვნებს Google-ის შიდა Code Assist API-ზე (cloudcode-pa.googleapis.com) მარშრუტიზებს სათანადო კონვერტის ფორმატით

ეს ნიშნავს, რომ Gemini CLI-ის არსებულ მომხმარებლებს PRX-ის გამოყენება შეუძლიათ ნულოვანი დამატებითი კონფიგურაციით.

გრძელი კონტექსტის ფანჯრები

Gemini მოდელები უკიდურესად გრძელ კონტექსტის ფანჯრებს უჭერს მხარს (Gemini 1.5 Pro-სთვის 2M ტოკენამდე). PRX maxOutputTokens-ს ნაგულისხმევად 8192-ზე აყენებს. საუბრის სრული ისტორია იგზავნება როგორც contents სათანადო როლების შესაბამისობით (user/model).

სისტემური ინსტრუქციები

სისტემური პრომპტები Gemini-ის მშობლიური systemInstruction ველით იგზავნება (არა როგორც ჩვეულებრივი შეტყობინება), რაც უზრუნველყოფს მათ სწორ დამუშავებას მოდელის მიერ.

მოდელის სახელის ავტომატური ფორმატირება

PRX ავტომატურად ამატებს models/ პრეფიქსს მოდელის სახელებს საჭიროებისას. ორივე ვარიანტი — gemini-2.5-flash და models/gemini-2.5-flash — სწორად მუშაობს.

პროვაიდერის მეტსახელები

შემდეგი სახელები ყველა Gemini პროვაიდერზე მიუთითებს:

• gemini
• google
• google-gemini

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

"Gemini API key not found"

PRX ვერ იპოვა ავტენტიფიკაცია. ვარიანტები:

1. დააყენეთ GEMINI_API_KEY გარემოს ცვლადი
2. გაუშვით gemini CLI ავტენტიფიკაციისთვის (ტოკენები ავტომატურად იქნება ხელახლა გამოყენებული)
3. მიიღეთ API გასაღები aistudio.google.com/app/apikey-დან
4. გაუშვით prx onboard ინტერაქტიული კონფიგურაციისთვის

"400 Bad Request: API key not valid" Gemini CLI-ით

ეს ხდება, როცა Gemini CLI-ის OAuth ტოკენები საჯარო API ენდფოინთზე იგზავნება. PRX ამას ამუშავებს OAuth ტოკენების ავტომატურად cloudcode-pa.googleapis.com შიდა ენდფოინთზე მარშრუტიზებით. თუ ეს შეცდომა ხედავთ, დარწმუნდით, რომ PRX-ის უახლეს ვერსიას იყენებთ.

"Gemini CLI OAuth token expired"

ხელახლა გაუშვით gemini CLI თქვენი ტოკენის განახლებისთვის. PRX ავტომატურად არ ანახლებს Gemini CLI-ის ტოკენებს (Anthropic OAuth ტოკენებისგან განსხვავებით).

403 Forbidden

თქვენს API გასაღებს შეიძლება Generative Language API ჩართული არ ჰქონდეს. გადახვიდეთ Google Cloud Console-ზე და ჩართეთ Generative Language API თქვენი პროექტისთვის.