|

Model baru November berdatangan, bagaimana mengintegrasikannya? Satu pintu masuk untuk berganti model, tagihan dilihat terpisah per saluran

Model baru November berdatangan, bagaimana mengintegrasikannya? Satu pintu masuk untuk berganti model, tagihan dilihat terpisah per saluran

Catatan penulis: Pada November 2026, model baru dirilis secara beruntun. Artikel ini menjelaskan cara mengganti tipe model lewat satu pintu masuk, mengakses berdasarkan endpoint, dan memisahkan pembukuan tagihan tiap jalur.

Tiga minggu pertama November baru saja berlalu, Google sudah berturut-turut merilis tiga model Gemini 4: Carbon dirilis 10 November, Hydrogen 12 November, dan Neon 18 November. Di bidang gambar, coding, dan lainnya juga bermunculan model baru di pemberitaan. Bagi developer yang ingin mencoba model baru, kerepotannya bukan pada tidak bisa menulis kode pemanggilan, melainkan karena setiap vendor punya SDK sendiri, autentikasi sendiri, dan dasar penagihan sendiri. Artikel ini menyajikan cara yang lebih praktis: satu pintu masuk untuk ganti model, tagihan dilihat terpisah per jalur.

Ini bukan daftar promosi “paket lengkap model baru”. Model yang muncul di berita dan model yang sudah bisa dipanggil di platform akan ditulis terpisah dalam artikel ini. Misalnya MAI Image 2.7 yang ada di berita saat ini belum masuk ke rak APIYI, jadi tidak akan dianggap sebagai model yang bisa dipanggil.

Nilai inti: Setelah membaca artikel ini, Anda akan tahu harus ke mana lebih dulu untuk mencocokkan daftar model, bagaimana memutuskan model ID mana yang akan diganti, endpoint mana yang harus dipakai tiap jenis model, serta bagaimana menghindari penggunaan harga satuan satu vendor untuk memperkirakan seluruh tagihan. Model dan harga yang dibahas di bawah ini mengacu pada daftar model dan antarmuka penetapan harga APIYI apiyi.com per 2026-11-20.

november-new-models-one-endpoint-switch-model-billing-by-channel-id-image-0


Poin Inti Integrasi Model Baru November

Saat model baru dirilis secara intensif, titik paling rawan kesalahan ada di tiga hal: menganggap model yang diberitakan sebagai model yang sudah tersedia, menggunakan endpoint yang salah, dan memperkirakan seluruh biaya dengan satu harga satuan. Tabel di bawah menyatukan ketiga hal itu dengan cara penanganannya.

Poin Penjelasan Manfaat
Cocokkan daftar model lebih dulu Berpatokan pada tabel induk platform dan API harga; catat model yang diberitakan secara terpisah dari model yang bisa dipanggil Menghindari pemanggilan langsung nama model dari acara peluncuran yang akhirnya error
Ganti model = ganti model ID + periksa endpoint Di base_url yang sama, ubah parameter model, lalu pastikan lewat chat, messages, responses, atau gemini Tidak perlu menulis satu set SDK untuk tiap vendor
Lihat tagihan per jalur secara terpisah Catat token input, output, dan cache read untuk setiap model dan setiap endpoint Model dengan harga satuan berbeda beberapa kali tidak ikut dirata-ratakan, biaya bisa dilacak
Harga perkenalan punya tanggal berakhir Sebagian model baru memiliki harga perkenalan terbatas, setelah berakhir harga standar resmi akan berubah Perkirakan anggaran bulan depan lebih awal, agar rencana tidak terganggu kenaikan harga

Detail Penting Integrasi Model Baru: Nama Model dari Berita ≠ Model yang Sudah Tersedia

Langkah pertama integrasi adalah memeriksa ketersediaan, bukan menulis kode. Alamat tabel induk model APIYI adalah docs.apiyi.com/models.md; versi yang dirujuk artikel ini diperbarui pada 2026-11-19 10:59 (UTC+8). Ada juga API harga yang dapat dibaca mesin https://api.apiyi.com/api/pricing dengan penanda versi shell-api-modelmak-v1. Kedua sumber bisa tidak diperbarui serempak; misalnya gemini-4-neon belum muncul di tabel induk versi ini, tetapi API harga sudah memiliki kolom harga yang lengkap. Jadi saat menilai “bisa dipanggil atau tidak”, sebaiknya periksa tabel induk dan API harga; jika salah satunya punya catatan, konfirmasi dengan satu permintaan kecil.

Sebaliknya juga perlu diperhatikan. MAI Image 2.7 adalah model gambar dalam berita terbaru, tetapi tabel induk dan API harga APIYI saat ini hanya memuat MAI-Image-2.6 dan MAI-Image-2.6-Flash, tidak ada 2.7. Artinya MAI Image 2.7 belum tersedia; kami akan segera menghadirkan model ini, dan saat itu nama model serta harga mengikuti daftar model platform. Selain itu, Kling, Muse, dan gemini-4-flash-lite saat ini tidak ditemukan di tabel induk maupun API harga; jangan masukkan mereka saat merencanakan solusi.

november-new-models-one-endpoint-switch-model-billing-by-channel-id-image-1

Perbandingan model baru November dan status ketersediaan

Tabel berikut memetakan model yang disebut dalam berita November ke status ketersediaan per 2026-11-20. Tabel ini hanya memuat informasi yang dapat diverifikasi dari sumber; hal yang belum terverifikasi tidak ditebak.

Model Informasi berita Status ketersediaan APIYI (2026-11-20) ID model
Gemini 4 Carbon Dirilis 2026-11-10, ditujukan untuk tugas panjang yang sulit Dapat dilihat di tabel utama dan endpoint harga gemini-4-carbon
Gemini 4 Hydrogen Dirilis 2026-11-12, varian harian yang cepat Dapat dilihat di tabel utama dan endpoint harga gemini-4-hydrogen
Gemini 4 Neon Dirilis 2026-11-18, kemampuan menengah Sudah ada di endpoint harga, tetapi belum tercantum di tabel utama versi ini gemini-4-neon
Gemini 4 Argon — Dapat dilihat di tabel utama gemini-4-argon
MAI Image 2.7 Model gambar yang disebut dalam berita Belum tersedia; akan segera tersedia Mengacu pada daftar platform
MAI Image 2.6 / 2.6 Flash — Dapat dicek, dihitung per permintaan MAI-Image-2.6 / MAI-Image-2.6-Flash

Posisi tiga varian Gemini 4 dapat dipahami secara sederhana: Carbon lebih diarahkan untuk tugas rantai panjang dan tingkat kesulitan tinggi, Hydrogen mengutamakan kecepatan dan cocok untuk pemanggilan harian berfrekuensi tinggi, sedangkan Neon berada di antara keduanya. Saat memilih, tentukan dulu varian berdasarkan tingkat kesulitan tugas, baru lihat harga; cara ini lebih aman daripada langsung memilih yang termurah.


Panduan Cepat Model Baru November: Satu Pintu Masuk untuk Ganti Model

Contoh Minimal: Ubah Dua Parameter, Ganti Model

APIYI menyediakan antarmuka yang kompatibel dengan OpenAI. Saat mengintegrasikan model baru, sebagian besar perubahan hanya ada di dua tempat: base_url dan model. Dengan contoh SDK Python resmi OpenAI, langkah minimalnya sebagai berikut:

  1. Instal SDK: pip install openai
  2. Buat klien: client = openai.OpenAI(api_key="YOUR_API_KEY", base_url="https://api.apiyi.com/v1")
  3. Mulai percakapan: client.chat.completions.create(model="gemini-4-hydrogen", messages=[{"role": "user", "content": "Hello!"}])
  4. Baca hasil: response.choices[0].message.content

Ingin beralih dari Hydrogen ke Carbon? Cukup ubah model="gemini-4-hydrogen" menjadi model="gemini-4-carbon"; klien, autentikasi, dan struktur pesan tidak perlu diubah. Inilah arti “satu pintu masuk untuk ganti model”: mengganti model biasanya berarti mengganti ID model dan memeriksa endpoint, tanpa perlu menulis SDK terpisah untuk tiap penyedia.

Lihat Pendekatan Integrasi Lengkap (Termasuk Peralihan Endpoint dan Pencatatan Kanal)

Dalam proyek lengkap, sebaiknya letakkan pemetaan “ID model → endpoint” di konfigurasi, bukan tersebar di dalam kode:

1. Tentukan item konfigurasi `MODEL_ROUTES`; setiap entri berisi tiga field: `model`, `endpoint`, dan `price_key`. Misalnya, `gemini-4-neon` dipetakan ke `chat`, `claude-fable-5-2` ke `messages`, dan `gpt-6.2-astra` ke `responses`.
2. Bungkus fungsi `call_model(model, prompt)`: berdasarkan `endpoint`, panggil `client.chat.completions.create`, `client.responses.create`, atau gunakan Anthropic SDK untuk meminta dengan format Messages (base_url sama seperti di atas).
3. Setelah setiap permintaan mengembalikan respons, baca token input, output, dan cache dari field `usage` pada respons; tulis ke buku besar lokal dengan `model+endpoint` sebagai kunci kanal.
4. Setiap hari, panggil endpoint harga sekali secara terjadwal, hitung harga satuan berdasarkan `model_ratio`, `completion_ratio`, dan `cache_ratio`, lalu kalikan dengan jumlah token di buku besar untuk mendapatkan perkiraan biaya setiap kanal.
5. Saat pemanggilan gagal, catat `model` dan pesan kesalahan. Jika muncul pesan bahwa model tidak ada, periksa kembali daftar model terlebih dahulu; jangan langsung mencoba ulang tanpa memeriksa.

Dengan begitu, setelah model baru tersedia, Anda hanya perlu menambahkan satu baris konfigurasi di `MODEL_ROUTES`; kode bisnis tidak perlu diubah.

🚀 Saran memulai cepat: Daftar dulu di APIYI apiyi.com dan ambil kuota uji gratis untuk pengguna baru. Gunakan model kelas harian seperti Hydrogen untuk memastikan alur berjalan, lalu beralih ke Neon dan Carbon untuk membandingkan hasil. Seluruh proses hanya membutuhkan satu kunci API.

Pemetaan endpoint model baru: jangan paksakan semua model ke chat

“Satu pintu masuk” tidak sama dengan “satu endpoint”. Model teks yang sudah bisa dipanggil memiliki endpoint yang berbeda-beda; saat mengganti model, langkah ini wajib dicek:

Seri model Contoh ID model Endpoint yang tersedia Keterangan
Seri Gemini 4 gemini-4-carbon / gemini-4-neon / gemini-4-hydrogen chat atau gemini chat adalah /v1/chat/completions yang kompatibel dengan OpenAI; gemini adalah format native Gemini, path spesifiknya mengikuti dokumentasi platform
Claude Fable 5.2 claude-fable-5-2 / claude-fable-5-2-thinking chat atau messages messages adalah /v1/messages bergaya Anthropic
GPT-6.2 Astra gpt-6.2-astra Disarankan responses Disarankan menggunakan /v1/responses
MAI Image 2.6 MAI-Image-2.6 / MAI-Image-2.6-Flash Pembuatan gambar Ditagih per pemanggilan; cara pemanggilan mengikuti dokumentasi platform

Dalam penggunaan praktis, jika tim sudah memiliki banyak kode berbasis format chat, Gemini dan Claude bisa tetap memakai endpoint chat terlebih dahulu, dengan biaya migrasi paling rendah. Saat membutuhkan kemampuan native dari vendor, baru beralih ke endpoint gemini atau messages. Untuk GPT-6.2 Astra, sebaiknya langsung diintegrasikan melalui endpoint responses; jangan memaksakan chat hanya karena kebiasaan.


Tagihan model baru November: dibedakan berdasarkan kanal

Pertama, pahami cara membaca endpoint harga

Endpoint harga APIYI menyatakan harga dalam bentuk rasio pengali, dengan aturan konversi sebagai berikut:

  • Harga satuan input = model_ratio × 2 (satuan: USD/juta token, saat model_ratio bernilai 1 sama dengan $2 / 1M)
  • Harga satuan output = harga satuan input × completion_ratio
  • Harga satuan baca cache = harga satuan input × cache_ratio

Sebagai contoh, untuk gemini-4-neon, endpoint harga memberikan model_ratio 1.5, completion_ratio 5, dan cache_ratio 0.05. Setelah dikonversi, harga input menjadi $3 / 1M, output $15 / 1M, dan baca cache $0.15 / 1M, sama dengan harga resmi Google. Setelah memahami metode konversi ini, begitu model baru tersedia, Anda bisa menghitung harga satuannya sendiri dari https://api.apiyi.com/api/pricing, tanpa perlu menunggu artikel diperbarui.

Perbandingan Harga Antar Kanal (Diperiksa 2026-11-20)

november-new-models-one-endpoint-switch-model-billing-by-channel-id-image-2

📊 Keterangan sumber data: Harga pada grafik dan tabel di atas diambil dari tabel utama model dan API penetapan harga APIYI apiyi.com, dengan tanggal pemeriksaan 2026-11-20. Penyesuaian berikutnya mengikuti daftar real-time platform.

Kanal (ID Model) Input Baca cache Output Keterangan
gemini-4-hydrogen $1.5 / 1M $0.075 / 1M $7.5 / 1M Varian cepat harian
gemini-4-carbon $2 / 1M $0.1 / 1M $10 / 1M Sesuai harga perkenalan Google hingga 2026-11-30
gemini-4-argon $2 / 1M $0.1 / 1M $10 / 1M Diambil dari tabel utama
gemini-4-neon $3 / 1M $0.15 / 1M $15 / 1M Diambil dari API penetapan harga
claude-fable-5-2 / -thinking $8 / 1M $0.2 / 1M $40 / 1M Harga kedua ID sama
gpt-6.2-astra (tingkat pertama) $8 / 1M $0.4 / 1M $40 / 1M Di atas 272000 token lihat di bawah
MAI-Image-2.6 Per panggilan $0.12 — — Gambar
MAI-Image-2.6-Flash Per panggilan $0.06 — — Gambar

Ada dua hal di tabel yang perlu dijelaskan secara terpisah.

Yang pertama adalah tingkatan konteks panjang GPT-6.2 Astra. Tabel utama menulis bahwa di atas 272000 token, harga input menjadi $16 / 1M; API penetapan harga lebih jauh menyebutkan bahwa di atas 272000 token, output dihitung $60 / 1M dan baca cache $0.8 / 1M. Jika bisnis Anda akan memasukkan konteks yang sangat panjang, pastikan menghitung estimasi secara terpisah berdasarkan tingkatan, jangan memakai harga tingkat pertama untuk semua permintaan.

Yang kedua adalah harga perkenalan Gemini 4 Carbon. Harga saat ini sesuai dengan harga perkenalan Google hingga 2026-11-30; harga standar Google mulai 1 Desember adalah input $4 / 1M dan output $20 / 1M. Harga platform selanjutnya mengikuti daftar model APIYI, jadi saat menyusun anggaran Desember sebaiknya sisihkan selisih ini.

Mengapa Satu Harga Satuan Tidak Cukup untuk Mewakili Semuanya

Dari tabel di atas terlihat, untuk output satu juta token yang sama, Hydrogen berada di $7.5, sedangkan tarif pertama Claude Fable 5.2 dan GPT-6.2 Astra adalah $40 — selisihnya lebih dari lima kali lipat. Jika tim menjalankan tiga atau empat model sekaligus, hanya berpatokan pada satu “harga satuan rata-rata” atau harga dari satu penyedia saja, biaya sangat mudah diremehkan atau justru dilebih-lebihkan. Pendekatan yang lebih aman adalah memakai “ID model + endpoint” sebagai kunci kanal, mencatat token input, output, dan baca cache secara terpisah untuk setiap kanal, mengalikannya dengan harga satuan masing-masing, lalu menjumlahkannya di akhir.

Perlu diperhatikan juga: gerbang terpadu memang menyelesaikan biaya akses, tetapi bukan berarti setiap model pasti lebih murah. Beberapa varian Gemini 4 pada tabel di atas harganya sama dengan harga resmi Google. Apakah sebuah kanal menguntungkan harus dibandingkan satu per satu dengan pemakaian aktual Anda, bukan digeneralisasi begitu saja.

💰 Saran biaya: saat membandingkan pilihan, Anda bisa memakai APIYI apiyi.com untuk memanggil Hydrogen, Neon, dan Carbon dengan kumpulan sampel uji yang sama, lalu mencatat konsumsi token per kanal, menghitung biaya riil per panggilan untuk setiap kanal, dan baru kemudian menentukan model utama.


FAQ (Pertanyaan yang Sering Diajukan)

Q1: Apa maksudnya “satu pintu masuk, ganti tipe model”?

Artinya semua model memakai `base_url` dan kunci API yang sama. Saat berganti model, cukup ubah ID model pada parameter `model` dan pastikan model tersebut mendukung endpoint yang dipakai. Tidak perlu mendaftar terpisah atau mengintegrasikan SDK khusus untuk setiap vendor.

Q2: Model yang baru muncul di berita, bisa langsung dipanggil?

Belum tentu. Rilis di berita tidak sama dengan sudah tersedia di platform. Contohnya pada 2026-11-20, MAI Image 2.7 hanya muncul di berita, sementara di rak APIYI baru ada `MAI-Image-2.6` dan `MAI-Image-2.6-Flash`; versi 2.7 belum tersedia dan akan segera ditambahkan. Sebelum memanggil, cek dulu tabel umum dan endpoint harga untuk memastikan ID model benar-benar ada.

Q3: Bagaimana memilih Carbon, Hydrogen, atau Neon untuk Gemini 4?

Pilih tingkatannya sesuai kesulitan tugas: untuk tugas rantai panjang dan tingkat kesulitan tinggi gunakan Carbon; untuk pemanggilan harian berfrekuensi tinggi yang mengutamakan kecepatan gunakan Hydrogen; untuk kebutuhan di antaranya gunakan Neon. Ketiganya dirilis pada 10, 12, dan 18 November dengan harga yang berbeda-beda. Sebaiknya bandingkan dulu dengan sampel yang sama sebelum menentukan model utama.

Q4: `gemini-4-neon` tidak ada di tabel umum, apakah berarti belum bisa dipakai?

Jangan hanya melihat tabel umum. Pada versi tabel umum 2026-11-19, `gemini-4-neon` memang belum tercantum, tetapi endpoint harga sudah memberikan rasio lengkap: setelah dikonversi, input `$3 / 1M`, output `$15 / 1M`, dan baca cache `$0.15 / 1M`. Kedua sumber informasi ini memiliki selisih waktu, jadi jadikan endpoint harga dan hasil uji coba kecil sebagai acuan.

Q5: Bagaimana cara cepat memanggil model-model baru November ini lewat API?

Disarankan mengikuti langkah berikut:

1. Daftar akun di APIYI apiyi.com, dapatkan kunci API dan kuota uji coba gratis untuk pengguna baru
2. Cek tabel umum model dan endpoint harga untuk memastikan ID model target
3. Setel `base_url` ke alamat kompatibel OpenAI dari platform, lalu pilih chat, messages, responses, atau gemini sesuai tabel padanan endpoint di atas
4. Kirim satu permintaan pendek terlebih dahulu, pastikan bisa dipakai, baru kemudian integrasikan ke bisnis

Q6: Untuk Claude Fable 5.2 yang sama, apakah harga lewat chat dan messages berbeda?

Dalam materi referensi, harga `claude-fable-5-2` dan `claude-fable-5-2-thinking` sama, yaitu input `$8 / 1M`, baca cache `$0.2 / 1M`, dan output `$40 / 1M`. Materi tersebut tidak membedakan harga berdasarkan endpoint. Meski begitu, saat pencatatan biaya sebaiknya tetap menjadikan endpoint sebagai bagian dari kunci kanal agar memudahkan penelusuran masalah dan pengecekan lanjutan.

Q7: Apakah pintu masuk terpadu pasti lebih murah daripada koneksi langsung ke pihak resmi?

Jangan langsung menyimpulkan begitu. Nilai utama pintu masuk terpadu adalah tidak perlu mengintegrasikan banyak set API serta adanya autentikasi dan pintu penagihan yang seragam. Soal harga harus dilihat per kanal, misalnya harga `gemini-4-neon` sama dengan harga resmi Google. Apakah lebih hemat atau tidak tergantung kombinasi model dan volume pemakaian Anda, jadi perlu dihitung sendiri per kanal.

Q8: Batasan apa saja yang sudah diketahui dan perlu direncanakan sejak awal?

Ada tiga hal utama. Pertama, sebagian model baru belum tersedia, misalnya MAI Image 2.7, Kling, Muse, dan `gemini-4-flash-lite` saat ini belum bisa ditemukan. Kedua, harga perkenalan memiliki tanggal berakhir; harga perkenalan Google untuk Gemini 4 Carbon berlaku sampai 30 November. Ketiga, GPT-6.2 Astra dikenai tarif bertingkat setelah melewati 272000 token. Jika menghadapi kondisi seperti ini, sesuaikan rencana berdasarkan daftar platform terlebih dahulu, baru kemudian ubah kode.

Poin Penting Utama Integrasi Model Baru November

  • Cek ketersediaan dulu sebelum menulis kode: Gunakan tabel model lengkap dan antarmuka harga sebagai acuan, catat secara terpisah antara model yang diberitakan dan model yang benar-benar bisa dipanggil
  • Ganti model hanya perlu ubah dua tempat: Di bawah base_url yang sama, ubah ID Model Bahasa Besar, lalu periksa ulang tipe endpoint
  • Endpoint harus sesuai peruntukan: Gemini lewat chat atau gemini, Claude lewat chat atau messages, GPT-6.2 Astra direkomendasikan responses
  • Paham rasio bisa hitung harga: model_ratio × 2 adalah harga input, lalu kalikan dengan rasio output dan cache
  • Tagihan dipisah per kanal: Catat terpisah dengan kunci “ID Model + endpoint”, jangan pakai satu harga untuk semua
  • Perhatikan tenggat waktu dan tingkatan: Harga perkenalan Carbon dan tingkatan 272000 token Astra akan memengaruhi anggaran
  • Cara memulai: Di APIYI gunakan satu Key untuk mengambil kuota gratis, jalankan dulu tier harian, baru bandingkan secara horizontal

Ringkasan: Model baru November membludak, satu pintu masuk ganti model, tagihan dipisah per kanal

Saat model baru membludak di November, kunci integrasi bukanlah mengejar setiap berita, melainkan membangun alur kerja yang tetap:

  1. Cocokkan daftar model: Periksa di tabel lengkap dan antarmuka harga. MAI Image 2.7 yang ada di berita belum tersedia di platform, jangan masukkan ke rencana peluncuran.
  2. Ganti ID Model dan periksa endpoint: Satu base_url menangani banyak model, pilih chat, messages, responses, atau gemini sesuai tabel referensi endpoint.
  3. Lihat tagihan per kanal: Hitung token dan biaya secara terpisah untuk setiap model dan setiap endpoint, sekaligus perhatikan tenggat harga perkenalan dan tingkatan konteks panjang.

Setelah alur kerja ditetapkan, saat model baru dirilis berikutnya, Anda hanya perlu menambahkan satu baris ID Model di konfigurasi, memeriksa antarmuka harga sekali, dan integrasi serta evaluasi biaya bisa diselesaikan. Disarankan di APIYI apiyi.com gunakan kuota gratis pengguna baru untuk menjalankan satu kanal terlebih dahulu, lalu secara bertahap tambahkan Gemini 4, Claude Fable 5.2, dan GPT-6.2 Astra ke dalam perbandingan.


📚 Referensi

  1. Blog Resmi Google – Pengumuman Rilis Gemini 4 Neon: Pengenalan seri model Gemini 4

    • Tautan: blog.google/innovation-and-ai/models-and-research/gemini-models/introducing-gemini-4-neon
    • Keterangan: Memahami posisi dan waktu rilis Carbon, Hydrogen, dan Neon
  2. Tabel Induk Model dan Antarmuka Harga APIYI: Sumber untuk memverifikasi model dan harga

    • Tautan: lihat bagian “Model Berita ≠ Model di Rak” di teks utama
    • Keterangan: Versi tabel induk dan antarmuka harga bisa saja tidak sinkron, sebaiknya periksa dan bandingkan keduanya

Penulis: Tim Teknis APIYI
Diskusi teknis: Silakan hubungi kami melalui halaman utama situs APIYI, dokumentasi integrasi lainnya dapat diakses di pusat dokumentasi docs.apiyi.com

Artikel terkait

Similar Posts