Gemini API-də Imagen-dən Nano Banana-ya keçid: addım-addım bələdçi

Bu bələdçidə nə öyrənəcəksiniz?

Google-ın Gemini API sənədlərinə əsasən, Imagen modelləri deaktiv edilib və API vasitəsilə artıq istifadə oluna bilmir. Buna görə Imagen-ə bağlı vizual generasiya inteqrasiyasını köçürərkən üç məqamı birlikdə nəzərdən keçirmək lazımdır: model adı, çağırış metodu və qaytarılan cavabın emalı. Bu bələdçi mövcud inteqrasiyada bu dəyişiklikləri necə yoxlaya biləcəyinizi izah edir.

İzah API-dən istifadə edən tətbiq və iş axınları üçün keçid yoxlama siyahısıdır. Mənbə sənəddə konkret proqramlaşdırma dili üçün quraşdırma əmrləri, paket versiyası və ya tam kod nümunəsi yoxdur. Buna görə burada nümunə kod və mənbədə göstərilməyən interfeys addımları təqdim edilmir.

Tələblər və keçidə hazırlıq

Keçid Gemini API vasitəsilə vizual generasiya edən Imagen bağlantılarını əhatə edir. Mənbədə hesab növü, ödəniş, kvota və ya avadanlıq tələbləri açıqlanmır. Tətbiqə başlamazdan əvvəl layihənin mövcud API çağırışlarını və vizual cavabdan istifadə edən hissələrini müəyyənləşdirmək yaxşı ilk addımdır.

Kod bazasında, konfiqurasiya fayllarında və ya sorğu şablonlarında Imagen model adlarının istifadə olunduğu yerləri siyahıya alın. Sonra vizual generasiya çağırışının hansı metodla edildiyini və API cavabının tətbiq tərəfindən hansı hissədə emal olunduğunu qeyd edin. Bu yoxlama göstərir ki, dəyişiklik yalnız sorğunun göndərilməsi mərhələsi ilə məhdudlaşmaya bilər; cavabı emal edən hissədə də düzəliş tələb oluna bilər.

Nano Banana-ya addım-addım keçid

1. Mövcud model adını müəyyənləşdirin. Imagen istifadə edən sorğu nöqtələrini tapın və tətbiqin hansı model adı ilə çağırış etdiyini yoxlayın. Google Imagen model adları əvəzinə gemini-2.5-flash-image istifadə etməyi və ya gemini-3.1-flash-image kimi Nano Banana 2 modellərinə keçməyi tövsiyə edir. Hansı variantın seçiləcəyinə qərar verərkən tətbiqdə model seçiminin edildiyi yeri yeniləyin; eyni konfiqurasiyadan istifadə edən başqa sorğuların olub-olmadığını da yoxlayın.

2. Çağırış metodunu dəyişdirin. Google-ın keçid qeydində Imagen üçün istifadə olunan client.models.generate_images metodu əvəzinə client.models.generate_content metodunun işlədilməsi göstərilir. Bu dəyişikliyi model adının yenilənməsindən ayrı bir yoxlama kimi nəzərdən keçirin. Yeni model adı təyin edilsə də, tətbiq əvvəlki metodu çağırırsa, keçid tamamlanmış sayılmır.

3. Cavabın emalı hissəsini nəzərdən keçirin. Nano Banana cavabı əvvəlki istifadədə gözlənilə bilən xüsusi vizual cavab obyekti formatında deyil, vizual məlumatları ehtiva edən məzmun hissələri şəklində qaytarır. Tətbiqinizin API cavabını qəbul etdiyi nöqtədə hansı strukturun oxunduğunu yoxlayın. Vizual məlumatların tətbiqin sonrakı emal mərhələlərinə necə ötürüldüyünü də izləyin.

4. Tətbiqin öz iş axınında yoxlayın. Model adı və çağırış metodu dəyişdirildikdən sonra vizual generasiya sorğusu ilə prosesi başdan sona yoxlayın. Təkcə sorğunun göndərilməsini deyil, cavabdakı vizual məlumatların tətbiqin gözlədiyi növbəti mərhələyə çatıb-çatmadığını da sınayın. Google-ın bu keçid qeydi konkret test ssenarisi və ya gözlənilən nəticə nümunəsi vermədiyindən yoxlamanın əhatəsi tətbiqin istifadəsinə uyğun müəyyənləşdirilməlidir.

5. Köhnə istinadları və sənədləşməni yeniləyin. Kodda və ya komandanın texniki qeydlərində Imagen model adları, eləcə də köhnə cavab formatı ilə bağlı izahlar qala bilər. Bunları yeniləmək sonrakı texniki xidmət zamanı deaktiv edilmiş model və ya artıq istifadə olunmayan metod əsasında yeni bağlantı qurulması riskini azaldır. Bu addım API-nin yeni funksiyası deyil, keçid prosesini aydın saxlamağa yönəlmiş texniki xidmət tövsiyəsidir.

Tez-tez rast gəlinən səhvlər

Yalnız model adını dəyişmək: Google-ın keçidlə bağlı izahına əsasən, model adı ilə yanaşı metod və cavabın emal formatı da nəzərdən keçirilməlidir. İnteqrasiyanı yeni istifadəyə uyğun qiymətləndirmək üçün hər üç yoxlamanın aparılması vacibdir.

Köhnə cavab strukturunu gözləmək: Nano Banana vizual məlumatları məzmun hissələri daxilində qaytardığı üçün əvvəlki vizual cavab obyektinə əsasən yazılmış tətbiq hissəsi bu məlumatları gözlənilən formatda tapa bilməyə bilər. Cavabı emal edən komponenti də keçid planına daxil edin.

Mənbədə göstərilməyən tələbləri fərz etmək: Keçid qeydi konkret dil və ya paket versiyası, ödəniş, kvota və ya hesab şərti bildirmir. Bu detalları qəti tələb kimi təqdim etmək əvəzinə, tətbiq etməzdən əvvəl müvafiq aktual Gemini API sənədlərindən yoxlayın.

Testi sorğunun göndərilməsi ilə məhdudlaşdırmaq: Sorğunun uğurla göndərilməsi cavabdakı vizual məlumatların tətbiqin sonrakı mərhələlərində düzgün istifadə olunduğunu öz-özlüyündə göstərmir. Cavabın emalı hissəsini də testə daxil edin.

Memarlıq, interyer dizaynı və archviz iş axınlarına təsiri

Gemini API vasitəsilə vizual generasiyadan konsept işlərində, interyer alternativlərində və ya digər vizual mərhələlərdə istifadə edən komandalar üçün bu dəyişiklik mövcud inteqrasiyanın yenilənməsi deməkdir. Imagen-ə bağlı avtomatlaşdırma varsa, model adı, çağırış metodu və cavabdan istifadə edən hissə birlikdə nəzərdən keçirilməlidir. Yaradılan vizual məlumatları layihə iş axınında başqa mərhələyə ötürən tətbiqlərdə də bu ötürmənin yeni cavab formatına uyğunluğu yoxlanmalıdır.

Mənbədə yerli avadanlıq tələbi göstərilmədiyindən, bu keçid üçün konkret iş stansiyası və ya GPU ehtiyacı müəyyən etmək mümkün deyil. Qiymətlər və istifadə şərtləri də açıqlanmır. Ofislər və vizualizasiya komandalarının keçiddən əvvəl API istifadə şərtlərini ayrıca nəzərdən keçirməsi, mövcud avtomatlaşdırmanı isə model, metod və cavabdakı dəyişikliklərə görə test etməsi məqsədəuyğundur.

Növbəti addımlar

Əvvəlcə Imagen-ə bağlı çağırışları inventarlaşdırın. Sonra Google-ın tövsiyə etdiyi model adlarından birini və yeni çağırış metodunu nəzərdən keçirin; sonda vizual məlumatları ehtiva edən cavab hissələrinin tətbiqinizdə necə emal olunduğunu yoxlayın. Daha ətraflı nümunələr üçün Google vizual generasiya bələdçisinə yönləndirir. Bu bələdçidə izah edilməyən tətbiq detalları üçün aktual rəsmi sənədlərə müraciət edin.

Mənbə və lisenziya

Bu bələdçi Google-ın Gemini API-də Imagen-dən istifadə və Nano Banana-ya keçidlə bağlı rəsmi ingilisdilli təlimatı əsasında hazırlanıb. Mənbə, başqa cür göstərilmədiyi halda, CC BY 4.0 lisenziyası ilə yayımlanır. Mətn Azərbaycan dilinə uyğunlaşdırılıb; mənbədə olmayan kod nümunələri əlavə edilməyib.