Catatan penulis: kalau Agent Anda saat ini masih memakai client.chat.completions.create dengan tools, setelah pindah ke GPT-6.1 Anda akan menemui satu titik percabangan yang sangat spesifik: teks masih bisa jalan, tetapi pemanggilan tool harus pindah endpoint.
Mengapa pemanggilan tool tersangkut di endpoint setelah upgrade ke GPT-6.1
Kesimpulannya dulu: GPT-6 Astra, GPT-6.1 Sol, dan GPT-6.1 Terra sama-sama mendukung Chat Completions, tetapi pemanggilan tool harus lewat Responses API. Artinya, dalam satu basis kode yang sama, percakapan teks biasa boleh tetap di Chat. Begitu Anda perlu mendaftarkan fungsi, membaca hasil dari tool, atau menjalankan loop tool multi-putaran, request harus dikirim ke endpoint Responses.
Ini bukan masalah kompatibilitas yang bisa disiasati dengan mengubah parameter. Mengganti cara penulisan tools tidak ada gunanya, menambahkan tool_choice juga tidak. Untuk ketiga model ini, jalur Chat Completions memang tidak menyediakan kemampuan pemanggilan tool. Yang perlu diubah adalah endpoint-nya sendiri, beserta seluruh struktur request/response di sekitarnya. Kalau ingin membandingkan kedua endpoint dengan kunci API Anda sendiri, Anda bisa memakai pintu masuk terpadu APIYI di apiyi.com. Arahkan base_url ke https://api.apiyi.com/v1, lalu ganti ID model untuk berpindah.
Ada satu jebakan lagi, yaitu GPT-6 Sol dan GPT-6 Luna. Kedua model ini bisa melakukan function calling di Chat Completions, tetapi dengan syarat reasoning_effort bernilai none. Dengan kata lain, keduanya bisa memanggil tool lewat Chat, tetapi harus mematikan tingkat penalaran. Kalau Anda tetap butuh penalaran, Anda juga harus kembali ke Responses. Detail ini sering terlewat, sehingga kodenya jalan tetapi hasilnya tidak sesuai harapan.
Nilai utama: setelah membaca artikel ini, Anda bisa menentukan rantai pemanggilan tool Anda termasuk kategori yang mana, lalu memindahkan request dari endpoint Chat ke endpoint Responses tanpa merombak arsitektur secara keseluruhan.
Poin Utama Pemanggilan Alat di GPT-6.1
Tabel berikut memuat pembagian endpoint untuk tiga model baru dan dua model lama. Sebaiknya cocokkan dulu model yang Anda pakai sebelum masuk ke langkah migrasi di bagian selanjutnya.
| Model | Chat Completions teks murni | Chat Completions pemanggilan alat | Endpoint untuk pemanggilan alat |
|---|---|---|---|
| gpt-6.1-sol | Didukung | Tidak didukung | Responses |
| gpt-6.1-terra | Didukung | Tidak didukung | Responses |
| gpt-6-astra | Didukung | Tidak didukung | Responses |
| gpt-6-sol | Didukung | Hanya didukung jika reasoning_effort bernilai none |
Responses (jika proses penalaran perlu dipertahankan) |
| gpt-6-luna | Didukung | Hanya didukung jika reasoning_effort bernilai none |
Responses (jika proses penalaran perlu dipertahankan) |
Pembagian tugas endpoint: Chat untuk teks, Responses untuk alat
Singkatnya, di seri GPT-6 Chat Completions kini hanya berfungsi sebagai jalur teks, sedangkan jalur alat dipisahkan ke Responses. Dampaknya ke proyek lama bertingkat. Layanan yang hanya menangani tanya jawab, ringkasan, atau klasifikasi hampir tidak perlu diubah. Layanan yang membangun Agent, memakai function calling, atau mengorkestrasi alat multilangkah wajib bermigrasi.
Kabar baiknya untuk tim yang sudah membungkus SDK dalam satu lapisan: cakupan migrasinya lebih kecil dari yang dibayangkan. ID model tidak berubah, cara autentikasi tidak berubah, dan base_url juga tetap. Yang berubah hanya struktur badan permintaan dan cara mengembalikan hasil alat ke model. Jadi beban kerja sebenarnya bukan pada “mengganti model”, melainkan pada “mengganti cara memanggil”.
Logika memilih di antara tiga model utama
GPT-6.1 Sol dan GPT-6.1 Terra adalah dua model andalan generasi ini, dengan perbedaan utama pada posisi dan biaya. GPT-6 Astra adalah model unggulan generasi sebelumnya. Model ini tetap mendukung teks murni lewat Chat dan pemanggilan alat lewat Responses, sehingga cocok untuk proyek yang sudah berjalan stabil dan tidak ingin diubah besar-besaran. Saat memilih, lihat dulu seberapa sering alat dipanggil, lalu panjang jendela konteks per permintaan, dan harga satuan paling akhir. Pemanggilan alat biasanya melibatkan banyak putaran bolak-balik sehingga konsumsi token ikut membengkak.
Harga lengkapnya bisa dicek di tabel harga pada bagian berikutnya. Anda juga bisa memeriksa skema tarif yang sedang berlaku langsung di dokumentasi APIYI (apiyi.com) agar anggaran tidak disusun berdasarkan harga lama.
Lima Bagian yang Perlu Diubah untuk Pemanggilan Tool di GPT-6.1
Bagian ini paling praktis di seluruh artikel. Kalau kelima poin di bawah sudah Anda ubah, satu siklus pemanggilan tool yang umum bisa langsung berpindah dari endpoint Chat ke endpoint Responses.
| No. | Yang Diubah | Cara Tulis Chat Completions | Cara Tulis Responses |
|---|---|---|---|
| 1 | Metode pemanggilan | client.chat.completions.create |
client.responses.create |
| 2 | Wadah input | array messages |
parameter input |
| 3 | Deklarasi tool | tools (dipertahankan) |
tools (struktur pada dasarnya sama) |
| 4 | Pengisian balik hasil tool | pesan dengan role: "tool" |
entri bertipe function_call_output |
| 5 | Konteks multi-giliran | menyusun messages lengkap secara manual |
bisa disambung dengan previous_response_id |
Poin 1 dan 2 paling sering terlewat. Banyak orang merasa migrasi sudah selesai setelah mengubah struktur tools, lalu baru sadar bahwa metode SDK-nya sama sekali tidak berubah, sehingga request masih dikirim ke chat.completions. Endpoint ditentukan oleh metode yang dipanggil. Selama metodenya tidak diganti, endpoint-nya tidak akan berubah.
Poin 4 adalah bagian yang paling sering bikin macet saat migrasi. Di Chat, hasil eksekusi tool dimasukkan kembali ke messages sebagai satu pesan dengan role: "tool". Di Responses, entri pemanggilan yang dikembalikan model harus dibawa kembali apa adanya, lalu ditambah satu entri function_call_output. Kalau ada satu entri yang tidak ikut terbawa, atau urutannya tertukar satu posisi saja, model bisa mengulang pemanggilan yang sama.
Poin 5 termasuk kategori “boleh tidak diubah, tapi sebaiknya diubah”. Responses mendukung previous_response_id untuk melanjutkan giliran sebelumnya, sehingga Anda tidak perlu mengirim ulang seluruh riwayat pesan setiap kali. Untuk Agent dengan banyak giliran tool, dampak poin ini terhadap biaya lebih terasa daripada sekadar mengganti model.
🎯 Saran teknis: Cara validasi paling hemat tenaga selama migrasi adalah menjalankan jalur lama dan jalur baru secara paralel dengan kumpulan request yang sama, lalu membandingkan tingkat keberhasilan pemanggilan tool dan struktur respons yang dikembalikan. Lewat antarmuka terpadu APIYI (apiyi.com), Anda tidak perlu repot mengelola kunci API di banyak platform. Cukup satu kali konfigurasi, dan Anda bisa membandingkan perbedaan respons asli antara Responses dan Chat.
Panduan Cepat Pemanggilan Alat di GPT-6.1
Contoh Minimal Pemanggilan Alat
Anggap kamu punya sebuah fungsi alat untuk mengecek status pesanan, namanya get_order_status, dengan parameter berupa nomor pesanan. Bagian yang perlu diubah hanya dua: cara pemanggilan dan pengisian ulang hasilnya.
- Inisialisasi klien tetap seperti semula. Isi
api_keydengan Key milikmu sendiri, lalu setbase_urlkehttps://api.apiyi.com/v1, sehingga semua model di bawah antarmuka yang kompatibel dengan OpenAI bisa langsung dipanggil. - Isi ID model dengan
gpt-6.1-sol(ataugpt-6.1-terra,gpt-6-astra). Ketiganya memakai Responses untuk pemanggilan alat. - Ganti
client.chat.completions.create(...)yang lama denganclient.responses.create(...), dan parametermessagesdiganti menjadiinput. toolstetap dikirim seperti biasa. Deskripsi alat dan schema parameternya tidak perlu ditulis ulang.- Dari
outputyang dikembalikan, cari entri bertipefunction_call, ambil nama alat dan parameternya, lalu jalankan fungsi cek pesananmu secara lokal. - Tambahkan hasil eksekusi sebagai
function_call_output, lalu kirim permintaan kedua untuk mendapatkan jawaban akhir.
Dari 6 langkah ini, yang benar-benar “wajib diubah” hanya langkah 3 dan 6. Langkah 1 dan 2 adalah konfigurasi, sedangkan langkah 4 dan 5 hanyalah kebiasaan era Chat yang pindah tempat membacanya.
🚀 Mulai Cepat: Kalau tidak mau repot menyiapkan lingkungan uji sendiri, kamu bisa klaim kuota uji coba gratis di APIYI apiyi.com, jalankan contoh cek pesanan di atas sampai berhasil, baru kemudian ubah kode produksi. Cara ini risikonya paling kecil.
Cara yang lebih praktis adalah memisahkan lapisan alat dari lapisan model terlebih dahulu: definisi alat dikumpulkan di satu tempat, lalu pintu masuk pemanggilan dibungkus dalam satu fungsi yang di dalamnya menentukan “teks biasa lewat Chat, yang membawa tools lewat Responses”. Dengan begitu, migrasi hanya terjadi di lapisan pembungkus, dan kode bisnis tidak perlu diubah sama sekali.
Harga dan Pemilihan Model GPT-6.1 (2026-11-12)
Tabel di bawah disusun berdasarkan ketentuan yang berlaku mulai 2026-11-12. Semua harga dalam dolar AS per 1M token.
| Model | Input | Output | Baca cache | Rekomendasi endpoint |
|---|---|---|---|---|
| gpt-6.1-sol | $2 | $10 | $0.1 | responses |
| gpt-6.1-terra | $1 | $5 | $0.05 | responses |
| gpt-6-luna | $0.1 | $0.5 | $0.01 | chat (dengan reasoning_effort bernilai none) atau responses |
Ada satu kesimpulan praktis dari tabel ini: harga input dan output GPT-6.1 Terra persis setengah dari Sol. Untuk skenario dengan banyak putaran pemanggilan alat dan konteks yang sering berulang, Terra biasanya jadi pilihan default yang lebih pas. Harga GPT-6 Luna turun satu orde besaran, jadi cocok untuk tugas ringan seperti klasifikasi dan ekstraksi. Dengan begitu, Sol atau Terra bisa dicadangkan untuk bagian orkestrasi alat yang benar-benar butuh penalaran.
Kolom harga baca cache juga layak diperhatikan. Pemanggilan alat secara alami menghasilkan banyak awalan yang berulang, seperti system prompt, definisi alat, dan riwayat percakapan. Begitu kena cache, harga satuannya sekitar seperdua puluh dari harga input. Jadi kalau di Responses Anda memakai previous_response_id untuk melanjutkan konteks, yang dihemat bukan cuma lalu lintas data, tapi juga uang sungguhan.
💰 Tips biaya: Kalau perlu membagi anggaran per proyek, pemanggilan lewat satu kunci API terpadu di APIYI (apiyi.com) memungkinkan Anda memantau pemakaian banyak model di satu tempat. Dipadukan dengan penagihan sesuai pemakaian, biaya pemanggilan alat yang sebenarnya jadi lebih mudah dihitung.
FAQ Pemanggilan Alat GPT-6.1
Q1: GPT-6.1 itu apa, dan apa hubungannya dengan GPT-6?
GPT-6.1 adalah versi iterasi dari seri GPT-6. Saat ini ada dua model, yaitu GPT-6.1 Sol dan GPT-6.1 Terra. Seri GPT-6 sendiri terdiri dari GPT-6 Astra, GPT-6 Sol, dan GPT-6 Luna. Semuanya memakai jalur pemanggilan alat yang sama, yaitu Responses. Bedanya terutama ada di posisi kemampuan dan harga.
Q2: Kenapa pemanggilan alat tidak bisa lewat Chat Completions? Apa parameternya salah?
Bukan masalah parameter. Di Chat Completions, GPT-6 Astra, GPT-6.1 Sol, dan GPT-6.1 Terra hanya menyediakan kemampuan teks murni. Pemanggilan alat dibatasi di Responses API. Mengubah `tools` atau `tool_choice` tidak akan berpengaruh apa-apa. Yang perlu diganti adalah metode SDK-nya, dari `chat.completions.create` menjadi `responses.create`.
Q3: Apakah GPT-6 Sol dan GPT-6 Luna bisa melakukan pemanggilan fungsi lewat Chat?
Bisa, tapi hanya kalau `reasoning_effort` diatur ke `none`. Kalau kamu perlu mempertahankan tingkat penalaran, kedua model ini juga harus lewat Responses. Batasan ini paling gampang terlewat saat migrasi, karena tidak memunculkan error. Hasilnya saja yang jadi tidak sesuai harapan.
Q4: Apakah ID model perlu diganti saat migrasi ke Responses?
Tidak perlu. ID model tetap `gpt-6.1-sol`, `gpt-6.1-terra`, dan `gpt-6-astra`. `base_url` dan cara autentikasinya juga tidak berubah. Yang benar-benar harus diubah ada tiga: metode pemanggilan, wadah input, dan struktur pengembalian hasil alat.
Q5: Bagaimana cara cepat memastikan pemanggilan alat setelah migrasi sudah berjalan normal?
Saya sarankan smoke test dengan satu alat kecil untuk cek pesanan. Pertama, pastikan permintaan benar-benar masuk ke endpoint Responses. Kedua, pastikan `output` yang dikembalikan berisi entri `function_call`. Ketiga, pastikan setelah `function_call_output` dikirim balik, model memberikan jawaban akhir. Kalau ketiganya lolos, berarti alurnya sudah tersambung. Kamu bisa mengambil kunci API uji coba di APIYI (apiyi.com) untuk menjalankan seluruh validasi ini.
Q6: Apakah layanan teks murni juga harus ikut pindah ke Responses?
Tidak harus. Kemampuan teks murni di Chat Completions untuk ketiga model utama tetap bisa dipakai. Layanan yang hanya mengerjakan tugas seperti tanya jawab, ringkasan, atau terjemahan boleh dibiarkan seperti semula. Hanya permintaan yang melibatkan `tools` yang wajib pindah. Inilah alasan dampak perubahan ini terbagi per lapisan.
Q7: Bagaimana mengendalikan biaya konteks pada pemanggilan alat multi-putaran?
Utamakan `previous_response_id` untuk melanjutkan putaran sebelumnya, jangan mengirim ulang seluruh riwayat di setiap putaran. Dengan begitu awalan yang berulang lebih mudah kena cache, dan harga baca cache jauh lebih murah daripada harga input. Contohnya `gpt-6.1-sol`: input $2, baca cache $0,1. Selisihnya cukup besar.
Q8: Adakah jebakan yang sudah diketahui saat migrasi ke Responses?
Ada dua yang paling sering terjadi. Pertama, hanya struktur `tools` yang diubah, tetapi metode pemanggilannya tidak, sehingga permintaan tetap jatuh ke endpoint Chat. Kedua, saat mengirim balik hasil alat, penulisan lama dengan `role: “tool”` masih dipakai. Akibatnya model tidak menerima output dan memanggil alat yang sama berulang kali. Selain itu, kalau tim kamu mencampur model seperti GPT-6 Sol yang mensyaratkan `reasoning_effort` bernilai `none`, sebaiknya terapkan aturan yang seragam di lapisan pembungkus (wrapper). Dengan begitu tidak muncul kasus “alat yang sama jalan di sebagian model, tapi tidak di model lain”.
Poin Utama Pemanggilan Alat di GPT-6.1 (Key Takeaways)
- Endpoint sudah dipisah: Teks untuk GPT-6.1 Sol, Terra, dan GPT-6 Astra lewat Chat, sedangkan alat (tools) wajib lewat Responses.
- Satu pengecualian: GPT-6 Sol dan GPT-6 Luna masih bisa melakukan pemanggilan fungsi di Chat, tetapi
reasoning_effortharus diset kenone. - Lima perubahan: metode pemanggilan, wadah
input, deklarasitools, pengisian balikfunction_call_output, dan perangkaian lewatprevious_response_id. - ID model tidak berubah:
base_urldan Key tidak perlu diganti, migrasi hanya terjadi di lapisan pembungkus (wrapper). - Biaya tergantung cache: Prefiks pemanggilan alat biasanya sangat sering berulang, dan harga baca cache sekitar seperduapuluh dari harga input.
- Tiga langkah verifikasi: pastikan endpoint yang dipakai, pastikan ada
function_calldi dalamoutput, lalu pastikan jawaban akhir diterima setelah hasil alat diisi balik. - Jalur untuk mulai: manfaatkan kuota gratis di APIYI apiyi.com untuk menjalankan satu alat kecil pengecekan pesanan lebih dulu, baru ubah jalur produksi.
Kesimpulan
Perubahannya sebenarnya bisa diringkas dalam satu kalimat: GPT-6.1 memindahkan pemanggilan alat dari Chat Completions ke Responses, sementara kemampuan teks murni tetap di tempat semula. Dari situ ada tiga hal yang perlu diingat:
- Klasifikasikan dulu, baru migrasi: Layanan yang hanya mengolah teks tidak perlu disentuh, tetapi permintaan yang membawa
toolswajib pindah endpoint. - Ganti metode, bukan sekadar parameter: Yang menjadi “saklar” endpoint adalah
client.responses.create, sedangkan strukturtoolshanya pelengkap. - Pengisian balik hasil adalah titik paling rawan:
function_call_outputmenggantikanrole: "tool", dan urutan serta kelengkapannya harus benar.
Kalau proyekmu sudah menjalankan pemanggilan alat di produksi, sebaiknya ambil satu alat paling sederhana untuk rilis bertahap (canary). Setelah jalurnya terbukti aman, baru alihkan seluruh trafik. Supaya tidak repot mengurus banyak Key dan konfigurasi lingkungan di berbagai platform, kamu bisa memakai satu Key yang sama lewat APIYI apiyi.com untuk membandingkan respons asli dari Responses dan Chat. Cukup arahkan base_url ke https://api.apiyi.com/v1.
Referensi
- Dokumentasi model resmi OpenAI: Penjelasan kemampuan endpoint untuk seri GPT-6 dan GPT-6.1, termasuk batasan bahwa pemanggilan alat (tool calling) harus lewat Responses
- Tautan:
developers.openai.com/api/docs/guides/latest-model -
Keterangan: Sumber utama untuk memastikan apakah sebuah model bisa melakukan function calling di Chat Completions
-
Dokumentasi model dan harga APIYI: Harga input, output, dan cache read untuk tiap model, beserta endpoint yang direkomendasikan
- Tautan:
docs.apiyi.com/models - Keterangan: Untuk mengecek ketentuan penagihan yang berlaku mulai 2026-11-12 dan saran endpoint
Penulis: Tim Teknis APIYI
Diskusi teknis: Silakan hubungi kami lewat beranda APIYI apiyi.com. Penjelasan antarmuka lainnya tersedia di pusat dokumentasi docs.apiyi.com
