Catatan penulis: Dengan mengikuti alur di konsol, Anda bisa mengintegrasikan GPT-6.1 Terra API dalam 5 langkah. Artikel ini menjelaskan pemilihan endpoint, jebakan parameter, dan harga bertingkat 272K.
Kesimpulannya: hanya ada satu pilihan penting saat mengintegrasikan GPT-6.1 Terra, yaitu menggunakan Responses atau Chat Completions. Jika membutuhkan pemanggilan alat, Anda harus menggunakan Responses. Jika tidak, kode yang ada pada dasarnya bisa langsung digunakan—cukup ganti nama model.
GPT-6.1 Terra dirilis pada 2026-10-26 dengan ID model gpt-6.1-terra. Dokumentasi resmi sudah mencantumkan endpoint, parameter, dan aturan harga, jadi informasi ini bisa diverifikasi. Artikel ini mengikuti urutan tindakan di halaman konsol: daftar → buat token → cari Base URL → isi nama model → jalankan permintaan pertama. Setiap langkah dilengkapi kriteria verifikasi. Perintah terminal dan kode hanya disertakan sebagai opsi.
Manfaat utama: Setelah membaca artikel ini, Anda bisa memverifikasi seluruh alur integrasi GPT-6.1 Terra API melalui konsol sekaligus menghindari kesalahan 400 yang paling umum.
📌 Kondisi platform saat ini: Hingga 2026-10-27,
gpt-6.1-terrabelum tersedia di daftar model APIYI apiyi.com. Kami akan menghadirkan model ini sesegera mungkin. Model generasi yang sama, yaitugpt-6-astra,gpt-6-sol,gpt-6.1-sol, dangpt-6-luna, sudah tersedia. Anda bisa menggunakangpt-6.1-soluntuk memverifikasi alur integrasi terlebih dahulu. Untuk daftar model dan harga, lihat daftar model di platform.
Poin Utama API GPT-6.1 Terra
| Poin | Keterangan | Artinya bagi Anda |
|---|---|---|
| ID model | gpt-6.1-terra, dirilis pada 2026-10-26 |
Isi kolom model dalam permintaan dengan nilai ini |
| Endpoint yang tersedia | Responses, Chat Completions, Batch | Endpoint Realtime, Assistants, Embeddings, dan lainnya tidak didukung |
| Pemanggilan alat | Hanya didukung oleh Responses | Menyertakan tools di Chat akan langsung menyebabkan permintaan gagal |
| Konteks | Total 1.050.000, input per permintaan 922.000, output 128.000 | Cocok untuk dokumen panjang, tetapi perhatikan tingkatan harga 272K |
| Modalitas | Input berupa teks dan gambar, output berupa teks | Gambar dikirim melalui input_image di Responses |
| Batas pengetahuan | 2026-06-01 | Untuk mendapatkan informasi terbaru, gunakan alat web_search |
Penjelasan Terperinci tentang Batas Kemampuan GPT-6.1 Terra
GPT-6.1 Terra mendukung streaming, keluaran terstruktur, pemanggilan fungsi, file_search, input gambar, pencarian web, dan caching petunjuk. Model ini tidak mendukung fine-tuning maupun keluaran prediktif. Jika proyek lama Anda bergantung pada model yang telah di-fine-tune atau keluaran prediktif, Anda tidak bisa langsung memindahkannya ke model ini.
Endpoint Responses dapat menggunakan banyak alat, termasuk web_search, file_search, image_generation, code_interpreter, hosted_shell, apply_patch, skills, computer_use, mcp, dan tool_search. Inilah alasan utama untuk memilih Responses jika Anda membutuhkan alat: pada model ini, Chat Completions hanya menangani percakapan biasa.
Cara Memanggil API GPT-6.1 Terra: Alur 5 Langkah di Konsol
Langkah 1: Daftar akun
- Buka APIYI di apiyi.com, lalu ikuti petunjuk di halaman untuk mendaftar menggunakan informasi pribadi. Platform mengharuskan pengguna mendaftar sendiri.
- Akun baru mendapat saldo uji coba sebesar 0,05 dolar AS. Anda bisa mencoba satu pemanggilan ringan tanpa mengisi saldo.
- Kriteria keberhasilan: Setelah masuk, buka konsol. Saldo uji coba akan terlihat di halaman dompet atau saldo.
- Jika mengalami kendala: Jika saldo tidak terlihat, pastikan proses pendaftaran sudah selesai sebelum mengisi saldo.
Jika menggunakan jalur resmi, buat kunci di halaman API Keys platform OpenAI. Syaratnya, akun berada di wilayah yang didukung dan sudah mengisi saldo hingga tingkat Build, yaitu minimal 5 dolar AS.
Langkah 2: Buat token baru dan pilih grup yang tepat
- Buka halaman token di konsol:
api.apiyi.com/token, lalu klik Buat token baru. - Di bagian Pilih grup, pilih salah satu grup. Grup menentukan model yang tersedia, pengali biaya, dan jalur upstream.
defaultdansvipmenggunakan tarif yang sama dengan tarif resmi, sedangkanCodexReversemenggunakan sumber daya reverse. - Kriteria keberhasilan: Setelah disimpan, daftar token menampilkan satu Key yang diawali dengan
sk-. - Jika mengalami kendala: Grup di tingkat pengguna berbeda dengan grup token. Grup yang benar-benar berlaku adalah grup yang dipilih pada token.
Langkah 3: Temukan Base URL
Base URL perlu disesuaikan dengan SDK. Bagian ini paling sering keliru saat diisi:
- OpenAI SDK:
https://api.apiyi.com/v1, wajib menyertakan/v1 - Anthropic SDK: gunakan domain utama tanpa
/v1 - Google GenAI SDK: gunakan domain utama dan atur
api_versionkev1beta
Kriteria keberhasilan: Seri GPT-6.1 menggunakan OpenAI SDK atau klien yang kompatibel dengan OpenAI. Pastikan alamat yang diisi diakhiri dengan /v1. Jika mengalami kendala: Jika muncul error 404, kemungkinan besar /v1 terlewat atau ditulis dua kali.
Langkah 4: Isi nama model
Isi ID model pada kolom model di klien atau alat debugging. Sebaiknya mulai dengan model ringan seperti gpt-5.4-mini untuk memastikan alurnya berjalan, lalu beralih ke gpt-6.1-sol. Setelah gpt-6.1-terra tersedia di platform, Anda hanya perlu mengubah satu kolom. Platform tidak mendukung format perutean gratis seperti auto atau auto:free, jadi jangan mencobanya.
Kriteria keberhasilan: Nama model harus sama persis dengan yang tercantum di daftar model platform. Jika mengalami kendala: Jika muncul pesan bahwa model tidak tersedia, periksa ejaannya di daftar model terlebih dahulu, lalu pastikan grup token Anda mencakup model tersebut.
Langkah 5: Jalankan permintaan pertama
Berikut contoh minimal yang bisa langsung digunakan. Pilih salah satu dari dua cara penulisan berikut:
- Atur variabel lingkungan:
export OPENAI_API_KEY=sk-你的令牌 - Buat klien:
client = OpenAI(base_url="https://api.apiyi.com/v1")— Key akan dibaca otomatis dari variabel lingkungan. - Cara Responses:
r = client.responses.create(model="gpt-6.1-sol", input="用一句话介绍你自己", reasoning={"effort": "low"}, max_output_tokens=800) - Cara Chat:
c = client.chat.completions.create(model="gpt-6.1-sol", messages=[{"role": "developer", "content": "简洁回答"}, {"role": "user", "content": "你好"}], max_completion_tokens=800) - Cetak hasil untuk diperiksa:
print(c.model, c.usage.prompt_tokens)
Kriteria keberhasilan: Permintaan mengembalikan HTTP 200 dan usage.prompt_tokens berisi angka. Untuk Responses, periksa usage.input_tokens. Setelah mengganti model ke gpt-6.1-terra, pastikan kolom model pada respons menampilkan nama model tersebut.
🚀 Mulai cepat: Sebaiknya gunakan kuota uji coba di APIYI apiyi.com untuk memastikan
gpt-6.1-solberjalan. Pastikan kunci, grup, dan Base URL sudah benar. Setelah Terra tersedia, Anda cukup mengganti nama model untuk beralih. Acuan model dan harga adalah daftar model di platform.
| Langkah | Tindakan di konsol | Kriteria keberhasilan | Jika mengalami kendala, periksa |
|---|---|---|---|
| 1 Registrasi | Daftar dan masuk menggunakan akun sendiri | Terlihat kuota uji coba sebesar 0,05 dolar AS | Apakah proses registrasi sudah selesai |
| 2 Token | Buat token baru dan pilih grup | Daftar menampilkan Key yang diawali sk- |
Apakah grup token tertukar dengan grup pengguna |
| 3 Base URL | Isi alamat /v1 di OpenAI SDK |
Alamat diakhiri dengan /v1 |
Jika muncul 404, periksa /v1 |
| 4 Nama model | Isi model seperti gpt-6.1-sol |
Sama persis dengan yang tercantum di daftar model | Ejaan dan cakupan model pada grup |
| 5 Permintaan | Kirim pemanggilan pertama | Respons 200 dan usage berisi angka | Kode status, isi respons, dan x-request-id |
Anda juga bisa langsung menggunakan Magpie untuk integrasi yang lebih mudah. Cukup isi Key dan Base URL di antarmuka grafis. Magpie akan menghubungkan agen pemrograman seperti Claude Code, Codex, Pi, dan Hermes ke gateway yang sama secara otomatis, tanpa perlu mengubah berkas konfigurasi satu per satu.
Pemilihan Endpoint API GPT-6.1 Terra: Responses vs. Chat Completions
| Aspek perbandingan | Responses（v1/responses） | Chat Completions（v1/chat/completions） |
|---|---|---|
| Pemanggilan alat | Didukung, dapat menggunakan 10 jenis alat bawaan | Tidak didukung; permintaan yang menyertakan tools akan gagal |
| Instruksi sistem | instructions |
Peran developer di dalam messages, lebih andal daripada system |
| Tingkat penalaran | reasoning: {effort: ...} |
reasoning_effort |
| Batas output | max_output_tokens |
max_completion_tokens |
| Format input | String atau array pesan; gambar menggunakan input_image | Array messages |
| Pemutaran ulang beberapa giliran | include: ["reasoning.encrypted_content"], lalu sertakan output dari giliran sebelumnya secara utuh |
Gabungkan sendiri riwayat pesan |
| Usage streaming | Dikembalikan secara default | Perlu menambahkan stream_options: {include_usage: true} |
Analisis perbandingan Chat Completions: Endpoint Chat unggul dalam kompatibilitas dengan kode lama; sebagian besar proyek bisa berjalan hanya dengan mengganti nama model. Namun, di Terra, endpoint ini tidak dapat memanggil alat, dan beberapa grup juga akan mengabaikan pesan system. Sebaliknya, Responses mendukung alat secara bawaan dan pemutaran ulang penalaran terenkripsi, sehingga lebih cocok untuk membangun Agent dan menangani skenario penalaran beberapa giliran.
Tingkat penalaran memiliki enam pilihan: none, low, medium (default), high, xhigh, dan max. Tidak ada pilihan minimal. Token penalaran dihitung dalam biaya output dan batas output. Karena itu, sisakan ruang yang cukup pada max_output_tokens; jika tidak, output bisa terpotong sebelum proses penalaran selesai.
Tiga Kesalahan Parameter pada GPT-6.1 Terra API
| Kesalahan | Penulisan yang salah | Penulisan yang benar | Dampak |
|---|---|---|---|
| Chat dengan tools | Mengirim tools melalui chat.completions | Beralih ke endpoint Responses | Permintaan gagal |
| Menggunakan parameter lama | Mengirim max_tokens di endpoint Chat |
Ganti dengan max_completion_tokens |
400 |
| Konflik parameter sampling | Mengirim temperature atau top_p saat effort bukan none | Hapus temperature, top_p, dan top_logprobs. Di endpoint Chat, hapus juga logprobs | 400 |
Selain tiga kesalahan ini, dokumentasi resmi juga mencantumkan beberapa kondisi yang bisa memicu error 400: mengatur effort ke minimal, memberikan nilai ilegal pada prompt_cache_options.ttl, atau mengirim input yang melebihi 922.000 token. Tautan gambar yang disertakan harus bisa diunduh oleh server. Situs dengan perlindungan anti-bot bisa menyebabkan permintaan gagal. Dalam kasus seperti ini, menggunakan data URL base64 biasanya lebih andal.
Saat menelusuri error, ada satu kebiasaan penting: teks error lengkap hanya muncul sekali, yaitu di badan respons. Log backend berfungsi sebagai catatan tagihan, dan panggilan yang gagal tidak dicatat di sana. Jadi, simpan kode status HTTP, seluruh badan respons asli, serta x-request-id di header respons. Jangan memanggil raise_for_status() sebelum membaca badan respons karena informasi error bisa hilang.
Harga API GPT-6.1 Terra dan tarif bertingkat 272K
Berikut harga resmi dalam dolar AS per sejuta token. Perlu diperhatikan, tarif bertingkat diterapkan berdasarkan keseluruhan permintaan: begitu jumlah input melebihi 272K, semua komponen biaya dalam permintaan tersebut dihitung menggunakan tarif tingkat kedua.
| Komponen biaya | Input ≤ 272K | Input > 272K |
|---|---|---|
| Input | 1 | 2 |
| Output (termasuk token penalaran) | 5 | 7.5 |
| Pembacaan cache | 0.05 | 0.1 |
| Penulisan cache (30 menit) | 1.25 | 2.5 |
| Penulisan cache (12 jam) | 2.50 | 5 |
Untuk memperkirakan biaya, hitung keempat komponen: input, output, pembacaan cache, dan penulisan cache. Penulisan cache juga perlu dibedakan berdasarkan durasi 30 menit dan 12 jam. Jika hanya memperhitungkan harga input dan output, estimasi biaya untuk penggunaan jendela konteks panjang dengan cache akan lebih rendah dari biaya sebenarnya. Model generasi yang sama yang tersedia di platform memiliki harga yang sama persis dengan harga resmi untuk keempat komponen biaya dan juga menerapkan tarif bertingkat berdasarkan keseluruhan permintaan.
Batas laju untuk paket Standard resmi adalah: Build sebesar 5.000 RPM / 1 juta TPM, Launch sebesar 10.000 RPM / 4 juta TPM, dan Grow sebesar 15.000 RPM / 40 juta TPM.
💰 Saran biaya: Untuk tugas dengan dokumen panjang, usahakan membatasi input setiap permintaan hingga 272K, lalu gunakan prompt caching agar harga per unit turun secara signifikan. Pilih grup
defaultatausvipmelalui APIYI apiyi.com untuk mendapatkan tarif yang sama dengan harga resmi. Model dan harga spesifik dapat dilihat di daftar model platform.
Pengingat Keamanan API GPT-6.1 Terra
Simpan kunci API di variabel lingkungan atau layanan pengelola rahasia. Jangan menuliskannya langsung di kode sumber, apalagi mengunggahnya ke repositori Git. Sebaiknya kecualikan file .env di .gitignore. Jika kunci API bocor, segera hapus dan buat ulang melalui halaman token. Pastikan juga memilih grup token yang tepat: salah memilih grup bisa menyebabkan model tidak tersedia atau biaya dihitung dengan pengali yang tidak terduga. Sebaiknya gunakan token berbeda untuk setiap proyek agar kuota dan penonaktifannya bisa dikelola secara terpisah.
FAQ
Q1: Apa itu GPT-6.1 Terra?
GPT-6.1 Terra adalah model yang dirilis OpenAI pada 2026-10-26 dengan ID `gpt-6.1-terra`. Model ini memiliki jendela konteks sepanjang 1.050.000 token, mendukung teks dan gambar sebagai input, serta menghasilkan teks. Model ini bisa dipanggil melalui tiga endpoint: Responses, Chat Completions, dan Batch.
Q2: Kapan sebaiknya menggunakan Responses atau Chat Completions untuk GPT-6.1 Terra?
Pilih Responses jika membutuhkan pemanggilan alat, seperti function calling atau web_search. Untuk percakapan biasa, Chat juga bisa digunakan, tetapi parameternya harus diganti menjadi max_completion_tokens dan Anda tidak dapat menyertakan tools.
Q3: Apakah APIYI sudah mendukung pemanggilan gpt-6.1-terra?
Per 2026-10-27, model ini belum tersedia. Kami akan segera menghadirkannya. Sementara itu, Anda bisa menguji alur integrasi menggunakan `gpt-6.1-sol` dari generasi yang sama di APIYI apiyi.com. Model dan harganya mengacu pada daftar model di platform.
Q4: Mengapa permintaan menghasilkan error 400 saat saya menyertakan temperature?
Jika tingkat penalaran bukan none, Anda tidak boleh menyertakan temperature, top_p, atau top_logprobs. Hapus parameter tersebut atau atur effort ke none.
Q5: Bisa melakukan pengujian tanpa mengisi saldo?
Bisa. Akun baru yang didaftarkan di APIYI apiyi.com mendapatkan kredit uji coba sebesar 0,05 dolar, cukup untuk menjalankan satu pemanggilan ringan. Sebaiknya uji alur integrasi terlebih dahulu dengan `gpt-5.4-mini`, lalu beralih ke model yang dituju.
Q6: Apa saja batasan GPT-6.1 Terra yang sudah diketahui?
Model ini tidak mendukung fine-tuning dan predicted outputs. Model ini juga tidak mendukung endpoint Realtime, Assistants, Embeddings, Images, Audio, dan lainnya. Jika input melebihi 272K token, seluruh permintaan akan dikenai tarif tingkat kedua. Input yang melebihi 922.000 token akan langsung menghasilkan error 400.
Poin-Poin Utama API GPT-6.1 Terra
- Satu pilihan utama: jika perlu menggunakan tools, pilih Responses. Jika tidak, gunakan Chat dan cukup ganti nama model.
- Tiga hal terkait parameter yang perlu diperhatikan: Chat tidak mendukung
tools, gunakanmax_completion_tokens, dan jangan kirim parameter sampling jikaeffortbukannone. - Lima langkah di konsol: daftar, buat token dan pilih grup, isi Base URL dengan
/v1, masukkan nama model, lalu kirim permintaan. - Tanda permintaan berhasil: kunci diawali
sk-, permintaan mengembalikan status 200 dengan angka padausage, dan kolommodelmenampilkan nama model. - Empat komponen harga: input, output, pembacaan cache, dan penulisan cache. Jika melebihi 272K, seluruh permintaan dihitung dengan tarif tingkat kedua.
- Cara mulai: uji alur terlebih dahulu dengan
gpt-6.1-soldi APIYI. Setelah Terra tersedia, cukup ganti nama model.
Kesimpulan
Poin penting integrasi API GPT-6.1 Terra dapat dirangkum menjadi tiga hal:
- Tentukan endpoint terlebih dahulu: pilih Responses atau Chat karena pilihan ini menentukan format parameter dan apakah tools bisa digunakan.
- Verifikasi setiap langkah: token, Base URL, nama model, dan permintaan pertama masing-masing memiliki indikator keberhasilan yang jelas.
- Pahami biayanya: batas 272K dihitung berdasarkan keseluruhan permintaan. Masukkan keempat komponen biaya cache ke dalam anggaran.
Sebaiknya uji seluruh alur terlebih dahulu dengan gpt-6.1-sol di APIYI, apiyi.com. Per 27 Oktober 2026, platform belum menyediakan gpt-6.1-terra. Kami akan menghadirkan model ini sesegera mungkin. Nama model dan harga mengikuti daftar model di platform.
📚 Referensi
- Halaman Model OpenAI – GPT-6.1 Terra: Spesifikasi model dan dukungan endpoint
- Tautan:
platform.openai.com/docs/models/gpt-6.1-terra -
Keterangan: Informasi resmi tentang konteks, modalitas, dan alat yang tersedia
-
Panduan Model Terbaru OpenAI: Migrasi parameter dan batasan
- Tautan:
platform.openai.com/docs/guides/latest-model -
Keterangan: Aturan parameter seperti reasoning.effort dan max_completion_tokens
-
Halaman Harga OpenAI: Tarif bertingkat dan harga cache
- Tautan:
platform.openai.com/docs/pricing - Keterangan: Dua tingkat harga untuk 272K dan harga berdasarkan durasi penulisan cache
Penulis: Tim Teknis APIYI
Diskusi teknis: Hubungi kami melalui halaman beranda situs APIYI. Informasi integrasi selengkapnya tersedia di pusat dokumentasi docs.apiyi.com.
