Cara Menggunakan API GPT-6.1 Terra

TLDR

GPT-6.1 Terra (gpt-6.1-terra) adalah model GPT-6.1 tingkat menengah dari OpenAI yang dirilis pada 26 Oktober 2026. Model ini menghadirkan penalaran visual yang kuat, penggunaan komputer yang presisi, dan penulisan yang natural dengan harga setengah dari GPT-6.1 Sol dan GPT-5.6 Terra ($1 input / $5 output per 1 juta token standar). Dengan jendela konteks 1,05M token, upaya penalaran yang dapat dikonfigurasi (none hingga max), input gambar, serta dukungan alat penuh melalui Responses API, model ini ideal untuk alur kerja agen berskala tinggi seperti pemrosesan faktur, interpretasi gambar teknis, interaksi layar, dan revisi dokumen. Panduan ini mencakup penyiapan rinci, contoh kode, strategi penalaran, praktik terbaik, perbandingan, dan cara mengaksesnya dengan lebih hemat melalui CometAPI.

Key Takeaways

• Model ID: gpt-6.1-terra — jendela konteks 1.050.000, 128.000 token output maksimum, batas pengetahuan 1 Juni 2026.
• Harga (OpenAI standar): $1 / $5 per 1M token input/output; input yang di-cache $0,05; konteks panjang (>272K input) dan mode Fast lebih mahal.
• Terbaik untuk tugas visual + penggunaan komputer; jauh melampaui GPT-5.6 Terra sekaligus menyamai atau mendekati model tingkat lebih tinggi dengan biaya jauh lebih rendah dan kecepatan lebih tinggi.
• Lebih disarankan menggunakan Responses API untuk pemanggilan alat, penggunaan komputer, output terstruktur, dan kontrol penalaran.
• CometAPI menawarkan model yang sama dengan harga diskon (sekitar $0,80 / $4,00) dengan satu kunci kompatibel OpenAI untuk 500+ model, memudahkan switching dan memberi penghematan berkelanjutan 20–40%.

What Is GPT-6.1 Terra?

GPT-6.1 Terra adalah model tingkat menengah GPT-6.1 dari OpenAI yang cepat dan efisien, diposisikan di antara tier Luna yang ringan dan Sol/Astra yang lebih andal. Posisi resmi menekankan penalaran visual yang terperinci, penggunaan komputer yang presisi (interaksi layar, pengisian formulir, kontrol aplikasi), dan penulisan yang lebih jelas dan natural.

Model ini menerima input teks dan gambar serta menghasilkan output teks. Model ini tidak secara native mendukung input/output audio atau video. Kapabilitas utama mencakup streaming, output terstruktur, pemanggilan fungsi, caching prompt, penelusuran web, pencarian file, penggunaan komputer, code interpreter, dan lainnya—terutama melalui Responses API.

OpenAI menyoroti peningkatan besar dibanding GPT-5.6 Terra: skor lebih tinggi pada Agents’ Last Exam (tugas penggunaan komputer profesional) dengan biaya sekitar sepertiga, hampir setara dengan GPT-6 Astra pada beberapa tolok ukur visual dan agen dengan harga per token sekitar ~1/10, tingkat halusinasi yang jauh lebih rendah, serta penyelesaian tugas lebih dari 3× lebih cepat dibanding Sol atau Astra untuk beban kerja terkait.

GPT-6.1 Terra Specifications and Pricing

Harga Standar OpenAI (per 1M token)

• Input: $1,00
• Cached input: $0,05
• Cache writes (retensi 30 menit): $1,25
• Output: $5,00

Catatan: Prompt yang melebihi 272K token input dikenai tarif input/cache 2× dan output 1,5× untuk seluruh permintaan. Batch/Flex 50% lebih rendah; mode Fast 2×. Pemrosesan regional dapat menambah biaya.

CometAPI saat ini mencantumkan GPT-6.1 Terra sekitar $0,80 untuk input / $4,00 untuk output (konfirmasi di dashboard), memberikan penghematan bermakna dengan endpoint terpadu yang kompatibel dengan OpenAI.

How to Set Up GPT-6.1 Terra API

Direct OpenAI

• Buat atau gunakan proyek OpenAI dengan akses API (tier Build ke atas; tier Gratis tidak didukung untuk model ini).
• Hasilkan kunci API dan simpan dengan aman (variabel lingkungan atau pengelola rahasia).
• Pasang SDK OpenAI terbaru: pip install --upgrade openai (Python) atau npm install openai (Node.js).

Via CometAPI (Direkomendasikan untuk sebagian besar produksi dan penggunaan multi-model)

How Do You Access the GPT-6.1 Terra API in CometAPI?

Account and credentials

Masuk ke CometAPI, buat kunci API, dan pastikan gpt-6.1-terra tersedia. Simpan kredensial sebagai variabel lingkungan, bukan di kode sumber aplikasi Anda.

Satu kunci CometAPI mengautentikasi permintaan ke CometAPI. Simpan di lingkungan pengembangan atau backend; jangan sematkan di halaman web publik atau commit ke source control. Variabel lingkungan harus tersedia di terminal yang menjalankan skrip Anda.

Setel kunci di Bash.
export COMETAPI_KEY="your_cometapi_api_key"

Di Windows, setel variabel yang sama di PowerShell.

$env:COMETAPI_KEY="your_cometapi_api_key"

A small, specific first request

Gunakan satu prompt teks pendek dan satu respons sebelum menambahkan data gambar, skema JSON, atau fungsi. Konfirmasikan akses model dan base URL https://api.cometapi.com/v1. Jika akun Anda menawarkan beberapa rute, pilih rute yang dokumentasinya mencakup fitur yang ingin Anda gunakan.

How Do You use a GPT-6.1 Terra API Response?

Send the first text request

Tambahkan kode berikut setelah penyiapan klien dan simpan skrip gabungan sebagai first_request.py. Skrip ini meminta jawaban singkat, memeriksa penyelesaian, dan menulis teks ke file UTF-8.

Hasilkan respons teks, verifikasi penyelesaian, dan simpan answer.txt.

from pathlib import Path

response = client.responses.create(
   model="gpt-6.1-terra",
    instructions="Anda adalah asisten penulisan teknis yang ringkas.",
    input="Ringkas tiga penyebab umum kegagalan integrasi API dan solusinya.",
    reasoning={"effort": "medium"},
    max_output_tokens=2000,
)

if response.status != "completed":
    raise RuntimeError(
        f"Response status: {response.status}; "
        f"details: {response.incomplete_details}"
    )
if not response.output_text.strip():
    raise RuntimeError("No text returned; inspect response.output")

Path("answer.txt").write_text(response.output_text, encoding="utf-8")
print(response.output_text)
print("Saved answer.txt")
print(response.usage)
Run the combined client-and-request script.
python first_request.py

Check the saved answer

Buka answer.txt dan pastikan jawaban menanggapi prompt serta memuat ketiga penyebab dan solusinya. Respons API berstatus completed menandakan generasi telah selesai; aplikasi Anda tetap perlu memeriksa apakah konten memenuhi persyaratan. Simpan catatan usage yang dikembalikan jika Anda membandingkan biaya permintaan.

Use cURL for a direct HTTP check

Untuk pemeriksaan endpoint cepat tanpa SDK, jalankan perintah ini di Bash dengan COMETAPI_KEY yang sudah disetel. Periksa JSON yang dikembalikan, termasuk status, output, dan usage. Jangan berasumsi bahwa item output pertama selalu memuat teks final.

curl -sS https://api.cometapi.com/v1/responses \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-6.1-terra",
    "input": "Jelaskan bagaimana AI dapat mengurangi kesalahan pemrosesan faktur dalam 100 kata.",
    "reasoning": {"effort": "medium"},
    "max_output_tokens": 600
  }'

Choose request settings

Gunakan bidang permintaan Responses di bawah ini sebagai referensi ringkas. Mulailah dengan model, input, dan anggaran output yang moderat; tambahkan format atau pengaturan alat hanya ketika alur kerja membutuhkannya.

Pilih low untuk tugas ekstraksi sederhana, atau mulai dengan medium untuk analisis dokumen. Tingkatkan effort jika contoh Anda sendiri menunjukkan peningkatan yang bermanfaat. Berdasarkan aturan kompatibilitas parameter GPT-6, hilangkan temperature, top_p, dan top_logprobs ketika effort bukan none.

Token penalaran dihitung dalam anggaran output. Jika respons tidak lengkap, periksa status dan incomplete_details sebelum parsing atau menampilkannya. Panduan token penalaran menjelaskan mengapa nilai max_output_tokens kecil dapat habis sebelum jawaban terlihat selesai.

Controlling Reasoning Effort

Pilih effort secara sengaja untuk menyeimbangkan kualitas, latensi, dan biaya:

• none: Paling cepat, untuk ekstraksi/klasifikasi sederhana.
• low: Tugas rutin.
• medium (default): Sebagian besar pekerjaan campuran atau multi-langkah.
• high / xhigh / max: Ketidaksesuaian visual kompleks, perencanaan, atau tugas berisiko tinggi—gunakan hanya ketika evaluasi membenarkan token/latensi ekstra.

Chat Completions berfungsi untuk teks/gambar murni tanpa alat, tetapi pemanggilan alat dan beberapa fitur lanjutan memerlukan Responses.

How Can GPT-6.1 Terra API Analyze Images?

Model menerima gambar bersama teks. Ini mendukung interpretasi tangkapan layar, ekstraksi dokumen, ulasan gambar teknik, dan perbandingan materi visual. Dokumentasi input vision OpenAI menjelaskan blok konten input_image.

Analyze a local invoice image with Python

Letakkan invoice.png di direktori kerja.

Enkode PNG lokal dan kirim bersama prompt ekstraksi faktur. Terra unggul pada pencocokan foto produk, gambar teknik, tangkapan layar, dan QA visual.

response = client.responses.create(   
 model="gpt-6.1-terra",
    reasoning={"effort": "medium"},
    input=[{
        "role": "user",
        "content": [
            {"type": "input_text", "text": "Tinjau gambar kampanye ini. Cantumkan hanya masalah yang terlihat terkait pemangkasan, penempatan teks, kontras, dan keamanan logo. Sebutkan region dan usulkan perbaikan."},
            {"type": "input_image", "image_url": "https://example.com/image.jpg", "detail": "high"}
        ]
    }]
)
print(response.output_text)

Format yang didukung mencakup PNG, JPEG, WEBP, GIF non-animasi. Gunakan detail: "high" atau "low" sesuai kebutuhan; detail lebih tinggi menghabiskan lebih banyak token. URL data base64 juga didukung.

Tool Calling, Computer Use, and Structured Outputs

Pemanggilan alat (function calling, penggunaan komputer, penelusuran web, pencarian file, code interpreter, MCP, dll.) memerlukan Responses API.

Praktik terbaik untuk penggunaan komputer:

• Jalankan di lingkungan terisolasi (browser/VM).
• Terapkan daftar izin ketat untuk situs/tindakan.
• Minta persetujuan manusia untuk tindakan berisiko tinggi (pembelian, penghapusan, ekspor data).
• Tetapkan batas langkah/waktu/biaya.
• Verifikasi keadaan akhir alih-alih hanya mempercayai ringkasan model.
• Perlakukan konten halaman sebagai tidak tepercaya (ketahanan terhadap prompt-injection diklaim kuat, tetapi pertahanan berlapis tetap penting).

Should You Use Responses or Chat Completions?

Untuk GPT-6.1 Terra, Chat Completions mendukung permintaan teks dan gambar tanpa alat. Pemanggilan alat memerlukan Responses, yang juga direkomendasikan untuk alur kerja agen multi-langkah, manajemen status percakapan, pelestarian konteks penalaran di seluruh pemanggilan alat, dan event streaming lanjutan. Gunakan Responses untuk contoh di bawah dan untuk alur kerja yang mengandalkan output terstruktur atau manajemen status. Gateway yang kompatibel juga harus mendukung endpoint dan field yang Anda kirim. Lihat panduan migrasi resmi.

Saat memindahkan integrasi yang ada, periksa tiga hal sebelum mengalihkan trafik: model ID, endpoint, dan parameter permintaan Anda. Permintaan Chat Completions dengan alat memerlukan implementasi Responses; mengganti nama model saja tidak cukup. Di Responses, gunakan reasoning.effort; di Chat Completions, gunakan reasoning_effort.

Comparison Table: GPT-6.1 Terra vs Related Models

Handle Errors in a GPT-6.1 Terra API Workflow

Pertama, pisahkan permintaan yang perlu dikoreksi dari kegagalan koneksi atau layanan sementara. Mulai dari permintaan terkecil yang berfungsi saat mendiagnosis parameter opsional, dan simpan detail error di log sisi server tanpa menyertakan kunci API.

• Kegagalan autentikasi atau akses: verifikasi kunci, host tujuan, akses akun, dan saldo tersedia sebelum mencoba lagi.
• Parameter tidak didukung: hapus field opsional, konfirmasi endpoint dan model, lalu tambahkan satu per satu.
• Generasi tidak lengkap: periksa status dan incomplete_details; sesuaikan anggaran output atau sederhanakan tugas sebelum menggunakan hasil.
• Batas laju atau kegagalan sementara: gunakan backoff terbatas dan batas percobaan ulang. Percobaan ulang dapat menimbulkan respons berbiaya lagi.
• Stream terputus: simpan teks parsial sebagai output yang terputus. Jangan menganggapnya jawaban lengkap atau mengeksekusi tindakan berdasarkan permintaan alat yang parsial.
• Kegagalan alat atau hilir: periksa respons yang disimpan dan catatan operasi sebelum mengulangi sebuah business

Conclusion

GPT-6.1 Terra mewakili lompatan praktis bagi pengembang yang membangun agen visual dan penggunaan komputer ber-volume tinggi. Kombinasi kapabilitas yang meningkat, efisiensi biaya yang jauh lebih baik, dan penalaran yang dapat dikonfigurasi menjadikannya pilihan default untuk banyak beban produksi yang sebelumnya memerlukan model lebih mahal.

Mulailah dengan Responses API, gunakan effort penalaran medium, terapkan output terstruktur dan pagar pengaman, serta rute trafik melalui platform terpadu seperti CometAPI untuk biaya optimal dan fleksibilitas. Dengan penyiapan dan pola yang diuraikan di atas, Anda dapat bergerak dari nol ke integrasi siap produksi dalam hitungan menit sambil menjaga biaya jangka panjang tetap terkendali.

Untuk harga, batas laju, dan ketersediaan fitur terbaru, selalu silang periksa dokumentasi resmi OpenAI dan dashboard CometAPI Anda. Selamat membangun!

FAQs

Dapatkah beberapa pengguna berbagi percakapan GPT-6.1 Terra API?

Jaga riwayat percakapan tetap terisolasi berdasarkan pengguna atau ruang kerja yang berwenang. Backend bersama dapat menyimpan kredensial API, tetapi itu tidak memberi setiap pengguna izin untuk membaca setiap percakapan. Sebelum memuat pesan sebelumnya atau hasil yang disimpan, periksa bahwa pengguna saat ini dapat mengakses percakapan tersebut. Untuk alur kerja kolaboratif, definisikan siapa yang dapat melihat dan memperluas riwayat bersama.

Apakah prompt GPT-6.1 Terra API yang sama akan mengembalikan teks identik?

Jangan bergantung pada output identik byte-per-byte dari generasi berulang. Simpan prompt, model ID, pengaturan, dan hasil yang diterima saat reproduksibilitas penting. Jika alur kerja memerlukan susunan kata yang persis sama di kemudian hari, ambil jawaban yang disimpan alih-alih menghasilkan lagi. Evaluasi respons baru terhadap persyaratan tugas, bukan sekadar perbedaan susunan kata.

Apakah store=False mendefinisikan kebijakan privasi untuk seluruh alur kerja API?

Tidak. Pengaturan penyimpanan pada tingkat permintaan tidak menggambarkan setiap log, cache, atau kebijakan retensi di seluruh aplikasi dan gateway API Anda. Tinjau syarat dan kontrol data yang berlaku untuk setiap layanan sebelum mengirim dokumen rahasia. Batasi data yang Anda kirim dan hindari merekam konten prompt sensitif di log aplikasi hanya demi kemudahan debugging.

Bagaimana cara mendapatkan kunci GPT-6.1 Terra API?

Anda dapat mengakses GPT-6.1 Terra API melalui CometAPI. Buat akun, hasilkan kunci API, dan konfigurasikan SDK Anda dengan base URL https://api.cometapi.com/v1 dan model ID gpt-6.1-terra. Tidak diperlukan kunci API OpenAI terpisah.

Berapa biaya GPT-6.1 Terra API?

Per 28 Oktober 2026, harga resmi OpenAI adalah $1,00 per 1 juta token input, $0,05 per 1 juta token input yang di-cache, dan $5,00 per 1 juta token output. Tarif CometAPI yang dipublikasikan adalah $0,80 untuk input dan $4,00 untuk output, sekitar 20% lebih rendah. Untuk 10.000 token input yang tidak di-cache dan 2.000 token output, perkiraan biaya adalah $0,016 melalui CometAPI vs $0,020 melalui OpenAI, belum termasuk biaya tambahan.

Apakah GPT-6.1 Terra API gratis digunakan?

Tidak. Menurut dokumentasi model OpenAI, GPT-6.1 Terra tidak tersedia di tier API Gratis dan dapat diakses mulai tier berbayar Build. Pengguna ChatGPT Plus, Pro, Enterprise, dan Edu dapat mengakses Terra melalui ChatGPT Work dan Codex, tetapi penggunaan API ditagih terpisah dari langganan ChatGPT. Alternatifnya, pengembang dapat mengakses GPT-6.1 Terra melalui CometAPI dengan kunci API yang valid dan kredit yang cukup, tergantung pada ketersediaan penyedia.