Cara menggunakan Gemini 3.7 Flash API: Panduan Lengkap untuk Pembangun

TLDR: Gemini 3.7 Flash (model ID gemini-3.7-flash), dikeluarkan pada 13 Ogos 2026, ialah model kelas Flash paling berkemampuan Google untuk pengaturcaraan, aliran kerja berorientasikan agen, pembangunan web, dan tugasan berintensif pengetahuan.

Ia menawarkan tetingkap konteks 1,048,576 token, sehingga 65,536 token output, tahap pemikiran boleh ditala (rendah/sederhana/tinggi), sokongan multimodal yang kukuh, dan harga pengenalan $0.75 per 1M token input / $3.75 per 1M token output sehingga 31 Disember 2026. Akses melalui Interactions API Google atau, lebih mudah untuk timbunan berbilang model, melalui titik akhir bersatu CometAPI. Panduan ini merangkumi perkara baharu, parameter API, penggunaan langkah demi langkah dengan CometAPI, contoh kod, penanda aras, dan amalan terbaik.

Pengajaran Utama

• Gemini 3.7 Flash memberikan lonjakan besar berbanding 3.6 Flash dalam pengaturcaraan (FrontierCode 1.1 Main: 43.6% vs 34.4%; DeepSWE v1.1: 65.3% vs ~49%), pembangunan web (WebDev Arena Elo 1588 vs 1538), pemprosesan dokumen (GDP.pdf 34% vs 22%), dan automasi perniagaan (AutomationBench 30.4% vs 17%).
• Gunakan Interactions API (client.interactions.create) untuk ciri terkini; thinking_level menggantikan parameter belanjawan lama.
• CometAPI menyediakan satu kunci API dan akses serasi OpenAI (atau Gemini asli) kepada Gemini 3.7 Flash serta 500+ model lain, memudahkan pengebilan, penukaran, dan kawalan kos.
• Input multimodal (teks, imej, video, audio, PDF) dengan output teks; alat terbina dalam termasuk panggilan fungsi, pelaksanaan kod, pengukuhan carian, penggunaan komputer (pratonton), dan banyak lagi.
• $0.75 per 1M token input dan $3.75 per 1M token output melalui 31 Disember 2026, Harga pengenalan tamat pada 31 Disember 2026; rancang kadar standard $1.50 / $7.50 selepas itu.
• Sesuai untuk agen produksi, penjanaan kod ketepatan tinggi, dan aliran kerja berbilang langkah di mana kecekapan kos dan kebolehpercayaan penting.

Google mengeluarkan Gemini 3.7 Flash pada 13 Ogos 2026—hanya tiga minggu selepas Gemini 3.6 Flash—sebagai model kerja lasak paling pintar setakat ini untuk pengaturcaraan dan agen. Ia menyasarkan kejuruteraan perisian yang kompleks, pelaksanaan berbilang langkah berorientasikan agen, penjanaan web/UI dengan pematuhan reka bentuk yang kukuh, dan domain padat pengetahuan seperti kewangan, undang-undang, dan biosains.

Penting: Gemini 3.7 Flash memperkenal atau mewarisi perubahan tingkah laku API Gemini 3.x yang penting. Khususnya, pembangun yang memigrasikan aplikasi Gemini lama harus menghapus temperature, top_p, dan top_k, menggantikan thinking_budget dengan thinking_level, menghapus candidate_count yang tidak disokong, dan menghentikan pra-mengisi giliran model.

Apakah Gemini 3.7 Flash?

Gemini 3.7 Flash ialah model generatif AI kelas Flash terbaharu Google, dikeluarkan pada 13 Ogos 2026.

Google menggambarkannya sebagai “model kerja lasak paling pintar setakat ini untuk pengaturcaraan dan agen.” Keluaran ini ketara kerana hadir hanya tiga minggu selepas Gemini 3.6 Flash, menunjukkan Google mempercepat kitaran iterasi untuk model Flash berorientasikan pembangun.

Daripada memposisikan Gemini 3.7 Flash semata-mata sebagai model chatbot yang lebih pantas, Google menyasarkan beban kerja di mana sistem AI perlu:

• menaakul melalui berbilang langkah;
• menulis dan menyahpepijat perisian;
• menggunakan alat;
• berinteraksi dengan sistem luaran;
• menganalisis dokumen besar;
• mengubah reka bentuk menjadi antara muka berfungsi;
• melaksanakan aliran kerja perniagaan;
• beroperasi sebagai sebahagian daripada agen AI.

Perbezaan itu penting.

Chatbot tradisional mungkin menjawab:

“Bagaimana cara saya melaksanakan OAuth?”

Model pengaturcaraan berorientasikan agen dijangka memahami repositori, memeriksa fail, mengenal pasti kebergantungan, mencadangkan perubahan, melaksanakan alat, mendiagnosis ralat, dan berulang sehingga pelaksanaan berjaya.

Gemini 3.7 Flash direka jauh lebih tertumpu pada senario kedua.

API Gemini 3.7 Flash: Spesifikasi Teras

Dokumentasi API rasmi Gemini menyenaraikan Gemini 3.7 Flash sebagai tersedia umum dengan spesifikasi utama berikut.

Tetingkap konteks 1M token amat berguna untuk repositori besar, dokumentasi teknikal panjang, dokumen perusahaan, dan sesi agen berbilang langkah.

Apakah yang berubah pada API Gemini 3.7 Flash?

Ini merupakan salah satu bahagian paling penting untuk pembangun.

Gemini 3.7 Flash bukan sekadar menukar:

gemini-3.6-flash

kepada:

gemini-3.7-flash

Generasi Gemini 3.x Google memperkenalkan perubahan tingkah laku API yang boleh merosakkan aplikasi lama. Dokumentasi migrasi Gemini 3.7 khususnya menyorot beberapa perubahan.

1. temperature, top_p, dan top_k telah ditamatkan

Penyepaduan Gemini lama lazimnya mengandungi konfigurasi seperti:

generation_config = {
    "temperature": 0.7,
    "top_p": 0.9,
    "top_k": 40
}

Untuk Gemini 3.x, parameter pensampelan ini harus dikeluarkan.

Google menyatakan parameter ini ditamatkan dan generasi model masa depan boleh menolaknya bukannya menerimanya secara senyap.

Untuk Gemini 3.7 Flash, gunakan kawalan pemikiran sebagai ganti:

generation_config = {
    "thinking_level": "medium"
}

Ini merupakan perubahan konseptual yang signifikan.

Daripada mengawal kebolehrandomean semata-mata, pembangun kini boleh mengawal jumlah usaha penaakulan.

---

2. thinking_budget menjadi thinking_level

Aplikasi yang menggunakan konfigurasi penaakulan lama mungkin mempunyai sesuatu seperti:

{
  "thinking_budget": 4096
}

Gemini 3.7 Flash menggunakan:

{
  "thinking_level": "medium"
}

Tahap yang disokong ialah:

• low
• medium
• high

Google menerangkan low sebagai berguna untuk tugasan sensitif kependaman, medium sebagai tetapan lalai dan tujuan umum, dan high sebagai sesuai untuk penaakulan sukar, matematik, pengaturcaraan, dan tugasan berorientasikan agen.

---

3. candidate_count harus dikeluarkan

Senarai semak migrasi Google juga menyatakan untuk menghapus candidate_count, yang tidak disokong dalam Gemini 3.x.

Oleh itu, konfigurasi legasi seperti:

{
  "candidate_count": 3
}

tidak sepatutnya dibawa terus ke Gemini 3.7 Flash.

---

4. Giliran model pra-isi tidak lagi disokong

Seni bina perbualan lama kadangkala menamatkan permintaan dengan giliran model yang dipra-isi sebahagiannya.

Tingkah laku API baharu Gemini memerlukan pembangun memikir semula corak ini.

Google mengesyorkan menggunakan keadaan perbualan sisi pelayan melalui previous_interaction_id untuk interaksi berbilang giliran dan menghapus giliran model pra-isi.

---

5. Panggilan fungsi memerlukan perhatian tambahan

Panduan migrasi juga menyerlahkan perubahan panggilan fungsi.

Untuk aplikasi yang menggunakan alat, pembangun harus memberi perhatian kepada:

• aset multimodal;
• arahan sebaris;
• metadata respons fungsi;
• call_id;
• nama fungsi;
• ralat panggilan fungsi yang terbentuk dengan tidak betul.

Untuk API generateContent khususnya, Google menyatakan objek FunctionResponse harus merangkumi kedua-dua call_id dan name.

Ini sangat penting untuk aplikasi agen kerana panggilan fungsi tidak lagi sekadar “bagus untuk ada.” Ia adalah teras kepada cara agen pengaturcaraan dan aliran kerja beroperasi.

Cara Menggunakan API Gemini 3.7 Flash dengan CometAPI

CometAPI ialah gerbang API bersatu yang menawarkan akses kepada 500+ model (termasuk seluruh keluarga Gemini) di bawah satu kunci API, titik akhir serasi OpenAI, harga kompetitif, dan pengurusan berbilang vendor yang dipermudah. Ini amat berguna jika aplikasi anda sudah menggunakan SDK OpenAI atau perlu bertukar antara Gemini, Claude, GPT, dan model lain tanpa menulis semula logik pengesahan atau pengebilan.

Di bawah ialah panduan lengkap berorientasikan produksi. Setiap langkah utama distrukturkan sebagai H2 untuk kejelasan dan SEO.

Daftar CometAPI dan Dapatkan Kunci API Anda

1. Lawati https://www.cometapi.com/ dan cipta akaun (Google, GitHub, atau e-mel).
2. Navigasi ke bahagian API Keys / Konsol: https://www.cometapi.com/console/token.
3. Klik Create API Key, berikan nama deskriptif (cth., gemini-3.7-flash-prod), dan salin kunci tersebut.
4. Simpannya dengan selamat sebagai pemboleh ubah persekitaran:Bashexport COMETAPI_KEY="your-key-here"

Jangan sekali-kali komit kunci ke kawalan versi atau dedahkannya dalam kod sisi klien.

CometAPI menggunakan harga bayar-ikut-penggunaan dengan kadar yang lazimnya kompetitif berbanding harga vendor langsung dan tiada minimum bulanan.

Pasang SDK Diperlukan

Untuk gaya Gemini asli (disyorkan untuk pariti ciri penuh):

Bash
pip install google-genai

Untuk panggilan serasi OpenAI (migrasi paling mudah):

Bash
pip install openai

Setara Node.js juga tersedia (@google/genai atau OpenAI Node SDK).

Konfigurasikan Klien untuk CometAPI

Pilihan A – Klien Google GenAI asli yang menunjuk ke CometAPI (mengekalkan Interactions API dan kawalan pemikiran):

Python
import os
from google import genai

client = genai.Client(
    http_options={
        "api_version": "v1beta",
        "base_url": "https://api.cometapi.com"
    },
    api_key=os.environ.get("COMETAPI_KEY")
)

Pilihan B – Klien serasi OpenAI (sesuai jika asas kod anda sudah berasaskan OpenAI):

Python
from openai import OpenAI
import os

client = OpenAI(
    api_key=os.environ.get("COMETAPI_KEY"),
    base_url="https://api.cometapi.com/v1"
)

Kedua-dua pendekatan menghala trafik melalui CometAPI sambil memilih model huluan melalui parameter model.

Lakukan Panggilan Pertama Anda ke Gemini 3.7 Flash

Menggunakan gaya Interactions API (melalui klien GenAI yang dikonfigurasi):

Python
interaction = client.interactions.create(
    model="gemini-3.7-flash",
    input="Tulis skrip Three.js sedia produksi yang memaparkan lubang hitam 3D realistik dengan cakera akresi dan pembiasan graviti.",
    generation_config={
        "thinking_level": "medium"
    }
)
print(interaction.output_text)

Gaya chat completions serasi OpenAI:

Python
response = client.chat.completions.create(
    model="gemini-3.7-flash",  # Sahkan ID model tepat dalam papan pemuka CometAPI jika beralias
    messages=[
        {"role": "system", "content": "Anda ialah jurutera perisian pakar."},
        {"role": "user", "content": "Tulis fungsi Python yang mengendalikan cubaan semula pembayaran serentak dengan selamat menggunakan penguncian yang betul."}
    ],
    max_tokens=4096
)
print(response.choices[0].message.content)

Contoh cURL (serasi OpenAI):

Bash
curl https://api.cometapi.com/v1/chat/completions \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3.7-flash",
    "messages": [
      {"role": "user", "content": "Terangkan penambahbaikan utama dalam Gemini 3.7 Flash dalam 3 poin berbutir."}
    ]
  }'

Sentiasa sahkan rentetan model tepat yang tersedia dalam papan pemuka Models CometAPI, kerana pengagregat kadangkala menggunakan pengecam atau alias yang sedikit berbeza.

Tetapkan Tahap Pemikiran dan Opsyen Penjanaan Lanjutan

Untuk tugasan pengaturcaraan atau agen yang kompleks, tetapkan tahap pemikiran dengan jelas:

Python
interaction = client.interactions.create(
    model="gemini-3.7-flash",
    input="Analisis saluran pemprosesan pembayaran ini untuk keadaan lumba dan tulis semula kunci dengan selamat.",
    generation_config={
        "thinking_level": "high"  # atau "low" / "medium"
    }
)

• low: Paling pantas, sesuai untuk chat masa nyata atau draf ringkas.
• medium (lalai): Keseimbangan terbaik untuk kebanyakan kerja pengaturcaraan dan berorientasikan agen.
• high: Kedalaman penaakulan dan penggunaan alat maksimum; penggunaan token/kos lebih tinggi.

Tambah Input Multimodal (Imej, PDF, Video, Audio)

Gemini 3.7 Flash secara asli menerima modaliti bercampur. Contoh dengan imej + prompt teks (menggunakan klien GenAI):

Python
from google.genai import types

# Andaikan bait imej atau laluan fail dikendalikan dengan sesuai
response = client.models.generate_content(  # atau interaksi yang setara
    model="gemini-3.7-flash",
    contents=[
        types.Part.from_bytes(data=image_bytes, mime_type="image/jpeg"),
        "Huraikan sistem reka bentuk UI dalam mockup ini dan jana kod React + Tailwind yang sepadan."
    ]
)

Corak serupa berfungsi untuk input PDF, video, dan audio. Ini berkuasa untuk aliran kerja reka bentuk-ke-kod, soal jawab dokumen, dan analisis video.

Laksanakan Panggilan Fungsi / Penggunaan Alat

Isytiharkan alat dalam permintaan dan biarkan model memutuskan bila untuk memanggilnya. CometAPI meneruskan ini ke backend Gemini yang mendasari. Ikuti skema panggilan fungsi rasmi Gemini (nama, penerangan, parameter sebagai JSON Schema). Selepas menerima panggilan fungsi, laksanakan alat dan kembalikan hasil dalam giliran berikutnya.

Parameter API untuk Gemini 3.7 Flash

Apabila memanggil melalui Interactions API (disyorkan), parameter utama termasuk:

• model: "gemini-3.7-flash" (diperlukan)
• input: Rentetan atau kandungan berstruktur (teks + bahagian multimodal)
• generation_config (objek pilihan):
  • thinking_level: "low" | "medium" | "high" (lalai medium)
  • Medan konfigurasi lain yang disokong untuk output berstruktur, keselamatan, dll.
• tools / deklarasi fungsi untuk penggunaan alat
• arahan sistem (melalui peranan system atau medan khusus bergantung pada klien)
• Tetapan persekitaran / agen apabila menggunakan agen terurus (cth., Antigravity)

Panggilan gaya generateContent asli kekal tersedia tetapi Interactions API lebih diutamakan untuk akses ciri penuh dan orkestrasi agen.

Pengiraan token, caching (tersirat + eksplisit), inferens kelompok, dan opsyen keutamaan/fleks disokong.

Parameter dan konsep konfigurasi paling penting diringkaskan di bawah.

Dokumentasi migrasi Google secara eksplisit menyerlahkan parameter yang ditamatkan/tidak disokong dan corak perbualan baharu.

Amalan Terbaik Produksi dan Petua Migrasi

• Mulakan dengan thinking_level="medium" dan ukur kualiti vs kependaman/kos.
• Keluarkan parameter yang ditamatkan (temperature, top_p, top_k, belanjawan pemikiran lama).
• Utamakan Interactions API untuk aliran berbilang langkah berorientasikan agen dan integrasi Antigravity.
• Untuk aplikasi berbilang model, kekalkan base URL CometAPI dan hanya tukar rentetan model—tiada pengesahan semula diperlukan.
• Uji dengan teliti pada gelung agen khusus anda; 3.7 Flash mengurangkan gelung gagal tetapi masih mendapat manfaat daripada arahan sistem yang jelas dan skema alat yang baik.
• Gabungkan dengan model lain CometAPI (cth., penjana imej khusus atau model penaakulan alternatif) apabila Gemini 3.7 Flash bukan pilihan optimum untuk sub-tugasan.

Tangani Penstriman, Caching, dan Permintaan Kelompok

• Penstriman disokong melalui bendera stream standard dalam kedua-dua klien serasi OpenAI dan klien asli.
• Caching konteks (tersirat dan eksplisit) mengurangkan kos untuk konteks besar yang berulang.
• Opsyen inferens kelompok dan keutamaan tersedia untuk volum tinggi atau kependaman sensitif—semak matriks sokongan semasa CometAPI dan pilihan penggunaan rasmi Gemini.

Pantau Penggunaan, Kos, dan Ralat

Gunakan papan pemuka CometAPI untuk penjejakan penggunaan masa nyata, penjejakan kos, dan keterlihatan had kadar. Laksanakan penundaan eksponen untuk ralat 429 dan patuhi apa-apa had kadar yang didokumenkan. Log penggunaan token daripada metadata respons untuk pengagihan kos yang tepat.

Senarai Semak Migrasi API Gemini 3.7 Flash

Sebelum mengeluarkan aplikasi Gemini sedia ada, semak setiap item di bawah.

[ ] Tukar ID model kepada gemini-3.7-flash
[ ] Keluarkan temperature
[ ] Keluarkan top_p
[ ] Keluarkan top_k
[ ] Ganti thinking_budget dengan thinking_level
[ ] Keluarkan candidate_count
[ ] Hapus giliran model pra-isi
[ ] Semak keadaan perbualan berbilang giliran
[ ] Semak pengendalian panggilan fungsi
[ ] Semak FunctionResponse call_id/name
[ ] Kemas kini SDK
[ ] Jalankan semula suit ujian produksi
[ ] Uji penanda aras low/medium/high thinking
[ ] Kira semula kos token
[ ] Uji tingkah laku kegagalan/cuba semula

Panduan migrasi Google secara khusus mengesyorkan perubahan ini apabila beralih ke Gemini 3.7 Flash.

Soalan Lazim

Apakah API Gemini 3.7 Flash?

API Gemini 3.7 Flash menyediakan akses berpengaturcaraan ke model Gemini 3.7 Flash Google. Google memposisikan model ini untuk pengaturcaraan, agen, pembangunan web, kerja pengetahuan, dan aliran kerja berbilang langkah yang kompleks.

Berapakah kos Gemini 3.7 Flash?

Sehingga 31 Disember 2026, harga pengenalan ialah $0.75 per sejuta token input dan $3.75 per sejuta token output.

Mulai 1 Januari 2027, Google menyatakan harga menjadi $1.50 per sejuta token input dan $7.50 per sejuta token output.

Bolehkah saya masih menggunakan temperature dengan Gemini 3.7 Flash?

Tidak sepatutnya. Dokumentasi migrasi Gemini 3.x Google menyatakan temperature, top_p, dan top_k ditamatkan dan harus dikeluarkan.

Bolehkah saya menggunakan Gemini 3.7 Flash melalui CometAPI?

Platform CometAPI kini mengiklankan ketersediaan Gemini 3.7 Flash dan menyediakan corak API format Gemini dan serasi OpenAI. Oleh kerana model ini baru dikeluarkan, pembangun harus mengesahkan halaman model dan keupayaan titik akhir semasa sebelum pelaksanaan produksi.

Adakah CometAPI lebih baik daripada API rasmi Gemini?

Tiada yang secara universal “lebih baik.” API rasmi Gemini ialah pilihan semula jadi jika anda mahukan ekosistem asli Google dan fungsi khusus penyedia. CometAPI lebih menarik apabila anda memerlukan antara muka bersatu merentas pelbagai penyedia AI, pengurusan berpusat, dan penukaran model yang lebih mudah.

Keputusan Akhir: Adakah Gemini 3.7 Flash Berbaloi Digunakan?

Bagi pembangun yang membina aplikasi AI pada 2026, Gemini 3.7 Flash wajar diberi perhatian serius.

Keluaran ini kurang tentang menjadikan chatbot sedikit lebih pintar dan lebih tentang menjadikan model yang agak murah lebih baik untuk benar-benar melakukan sesuatu.

Pertimbangan teknikal terbesar ialah migrasi.

Jika aplikasi anda dibina berdasarkan API Gemini lama, jangan sekadar menukar nama model. Keluarkan parameter pensampelan yang ditamatkan, migrasikan ke thinking_level, hapus candidate_count yang tidak disokong, hentikan pra-isi giliran model, dan semak tingkah laku panggilan fungsi.

Bagi pasukan yang membina secara eksklusif di sekitar Google, API Gemini asli ialah titik mula yang jelas.

Bagi pasukan yang membina timbunan AI berbilang model, CometAPI menyediakan alternatif yang meyakinkan: satu lapisan API, akses model berpusat, dan keupayaan mencuba Gemini bersama keluarga model utama lain tanpa mencipta integrasi berasingan untuk setiap penyedia.

Saranan praktikalnya mudah:

Mulakan dengan Gemini 3.7 Flash pada usaha pemikiran sederhana, penanda araskan terhadap beban kerja sebenar anda, kemudian gunakan pemikiran rendah atau tinggi secara selektif berdasarkan kependaman, kualiti, dan keperluan kos. Jika produk anda juga memerlukan pelbagai penyedia AI, nilai beban kerja yang sama melalui CometAPI supaya anda boleh membandingkan model tanpa mereka bentuk semula seni bina aplikasi anda.

Gabungan—prestasi agen yang lebih kuat, tetingkap konteks 1M token, penaakulan boleh dikonfigurasi, dan harga agresif 2026—menjadikan Gemini 3.7 Flash salah satu keluaran API yang lebih menarik untuk pembangun yang membina agen AI produksi sekarang.