Login ChatGPT untuk Developer: Panduan Alur OAuth, Manajemen Penggunaan Paket, dan Dampak Biaya API Anda

OpenAI's Sign in with ChatGPT, an OAuth 2.0 and OpenID Connect login available to ChatGPT users worldwide, now lets participating apps run AI requests against a user's Plus or Pro plan instead of the developer's own API key, subject to per-app weekly limits the user sets. The identity scopes `openid profile email` return only an ID token with account ID, name, email and profile picture, while plan usage requires the separate scopes `offline_access resource.invoke chatgpt.tokens.use.direct` with `resource=https://api.openai.com/v1`, yielding a 1-hour access token and a 30-day rotating refresh token. Commercial apps get limited beta access via an interest form, while open-source apps can self-serve.

Masuk dengan ChatGPT adalah login OAuth 2.0 dan OpenID Connect milik OpenAI yang tersedia bagi pengguna ChatGPT di seluruh dunia. Aplikasi Anda mendapatkan ID akun yang stabil, serta nama, alamat email, dan gambar profil pengguna. Sejak DevDay pada 29 September 2026, pengguna Plus dan Pro juga dapat mengizinkan aplikasi yang berpartisipasi menjalankan permintaan AI pada paket ChatGPT mereka, bukan menggunakan kunci API Anda, dengan batas mingguan yang mereka tetapkan per aplikasi. Aplikasi Anda tidak pernah menerima percakapan, memori, atau kunci API pengguna. Bagian ini berfokus pada dampak tagihan. Anda akan mempelajari alur OAuth, cara penggunaan paket terlihat bagi pengguna, kelayakan integrasi, kapan paket pengguna dapat menggantikan kunci API Anda, serta cara menguji alur masuk dan kegagalan di Apidog https://apidog.com?utm source=dev.to&utm medium=wanda&utm content=n8n-post-automation . Untuk konteks acara, baca rangkuman DevDay 2026 https://apidog.com/id/blog/openai-devday-2026?utm source=dev.to&utm medium=wanda&utm content=n8n-post-automation . Jika perbedaan identitas dan otorisasi belum jelas, mulai dari OAuth vs OpenID https://apidog.com/id/blog/oauth-vs-openid?utm source=dev.to&utm medium=wanda&utm content=n8n-post-automation . | Item | Yang didokumentasikan OpenAI | |---|---| | Cakupan identitas | openid profile email | | Cakupan penggunaan paket alur sumber terbuka | offline access resource.invoke chatgpt.tokens.use.direct , dengan resource=https://api.openai.com/v1 | | Yang diterima aplikasi Anda | Token ID; untuk penggunaan paket, token akses dan token refresh | | Kelayakan penggunaan paket | Plus dan Pro, pada aplikasi yang berpartisipasi | | Di mana penggunaan dihitung | Penggunaan ChatGPT Work dan Codex pada paket | | Kontrol per aplikasi | Batas mingguan sebagai bagian dari total penggunaan mingguan; kredit setelah batas dinonaktifkan secara default | | Token penggunaan paket | Token akses 1 jam; token refresh 30 hari dan diganti setiap kali refresh | | Akses pengembang | Aplikasi komersial: uji coba terbatas melalui formulir minat. Aplikasi sumber terbuka: layanan mandiri | Sumber: dokumen Masuk dengan ChatGPT https://developers.openai.com/siwc , referensi token https://developers.openai.com/siwc/token-sharing-open-source/token-reference , dan artikel bantuan OpenAI tentang menggunakan paket ChatGPT Anda di aplikasi lain https://help.openai.com/en/articles/20001542-using-your-chatgpt-plan-in-other-apps-and-sites . Identitas adalah kemampuan default. Klien yang meminta cakupan openid profile email mendapatkan token ID. Menurut panduan situs web https://developers.openai.com/siwc/website , cakupan profile dapat memberikan klaim seperti nama dan gambar profil, sedangkan email dapat memberikan klaim email dan status verifikasi email. Cakupan identitas tidak memberikan akses ke percakapan ChatGPT maupun sumber daya API OpenAI. Gunakan kombinasi iss , aud , dan sub terverifikasi untuk mengidentifikasi akun lokal. Jangan gunakan email sebagai satu-satunya kunci akun. OpenAI memperingatkan bahwa kecocokan email saja bukan bukti kepemilikan akun, jadi pengguna lama harus mengonfirmasi proses penautan akun. Penggunaan paket adalah hibah terpisah. Jika pengguna menyetujui cakupan tambahan, respons token menyertakan token akses untuk permintaan API Responses yang memenuhi syarat. Jika aplikasi Anda hanya membutuhkan identitas, Anda tidak memerlukan access token ; id token sudah cukup. Alur situs web menggunakan Authorization Code grant dengan PKCE https://apidog.com/id/blog/oauth-2-flows?utm source=dev.to&utm medium=wanda&utm content=n8n-post-automation dan OIDC. Muat metadata provider dari: https://auth.openai.com/.well-known/openid-configuration Nilai produksi yang didokumentasikan: Issuer: https://auth.openai.com Authorization endpoint: https://auth.openai.com/api/accounts/authorize Token endpoint: https://auth.openai.com/api/accounts/oauth/token JWKS URI: https://auth.openai.com/.well-known/jwks.json Implementasikan alur berikut di backend: state , PKCE verifier dengan challenge S256 , dan nonce baru. client id , redirect uri , dan scope yang sesuai. iss , aud , exp , dan Klien publik tidak boleh mengirim client secret. Klien rahasia yang menggunakan client secret basic hanya boleh mengirim secret melalui header HTTP Basic. Untuk alat sumber terbuka, proses pendaftarannya berbeda. Panduan masuk sumber terbuka https://developers.openai.com/siwc/token-sharing-open-source/sign-in menggunakan: client id=dynamic agent client agent name hint berisi nama aplikasi Anda ext agent host id yang persisten untuk setiap host Callback mengembalikan ID klien yang diterbitkan, misalnya oaiapp ... . Simpan ID tersebut dan gunakan kembali pada login berikutnya. URI pengalihan menggunakan loopback 127.0.0.1 , tanpa client secret. Dokumentasi dan UI aplikasi Anda perlu menjelaskan hal berikut. Pengguna mengelola pengaturan melalui Pengaturan ChatGPT, Penggunaan chatgpt.com/settings/usage . Panduan UI OpenAI https://developers.openai.com/siwc/ui-ux-guidelines meminta aplikasi menautkan pengguna ke halaman tersebut melalui tombol atau tautan Kelola penggunaan . Rangkuman DevDay https://openai.com/index/devday-2026-recap/ OpenAI menyebut 16 mitra penggunaan paket, termasuk Devin dari Cognition, Notion, Vercel, T3, OpenClaw, dan Dactyl. The New Stack https://thenewstack.io/sign-in-with-chatgpt/ juga mencantumkan Amp, Warp, Kilo Code, dan OpenCode, dengan Lovable ditandai sebagai “segera hadir”. Jika Anda menjalankan OpenClaw https://apidog.com/id/blog/openclaw-free?utm source=dev.to&utm medium=wanda&utm content=n8n-post-automation , proyek tersebut muncul di kedua daftar. Seperti dilaporkan The New Stack, Sam Altman menyampaikan: “sekarang Anda tidak perlu menanggung biaya token mereka untuk memulai.” Cara bergabung bergantung pada jenis aplikasi Anda: Dengan kunci API sendiri, Anda membayar per token dan biasanya memulihkan biaya melalui harga produk. Dengan penggunaan paket, biaya model berpindah ke langganan pengguna. Margin Anda tidak lagi bergantung langsung pada jumlah token yang digunakan pengguna, tetapi Anda kehilangan sebagian kontrol atas ketersediaan kuota. | | Kunci API Anda | Paket ChatGPT pengguna | |---|---|---| | Siapa yang membayar | Anda, per token | Paket pengguna; kredit hanya jika pengguna memilihnya | | Siapa yang dapat menggunakannya | Setiap pengguna | Pengguna Plus dan Pro yang memberikan chatgpt.tokens.use.direct | | Batasan | Rate limit akun API Anda | Penggunaan mingguan paket, batas per aplikasi, dan jendela lima jam Plus | | Bentuk permintaan | API Responses penuh | Wajib store: false dan stream: true ; tidak mendukung temperature , max output tokens , pencarian file, atau Code Interpreter | | Kegagalan umum | HTTP 429 saat melampaui tier | 429 subscription sharing usage limit exceeded , atau kode yang sama dalam response.failed saat streaming | | Cadangan | Anda yang merancang | Tidak otomatis; OpenAI tidak mengganti metode penagihan | | Yang perlu ditampilkan | Penggunaan dan harga Anda | “Menggunakan paket ChatGPT”, tautan Kelola penggunaan, dan paket yang didukung | Pembatasan ini berasal dari halaman batasan pratinjau https://developers.openai.com/siwc/token-sharing-open-source/preview-limitations : fitur yang memerlukan status percakapan tersimpan atau alat yang di-host belum berjalan pada paket pengguna. Konfigurasi yang praktis adalah model hibrida: Lihat juga perbandingan Kunci API vs OAuth https://apidog.com/id/blog/api-key-vs-oauth?utm source=dev.to&utm medium=wanda&utm content=n8n-post-automation dan OAuth untuk agen AI https://apidog.com/id/blog/ai-agent-oauth-on-behalf-of-user?utm source=dev.to&utm medium=wanda&utm content=n8n-post-automation . Apidog tidak melakukan login dengan ChatGPT untuk Anda. Gunakan Apidog untuk menguji konfigurasi OAuth, pertukaran token, request API, dan penanganan error. Unduh Apidog https://apidog.com/download?utm source=dev.to&utm medium=wanda&utm content=n8n-post-automation , lalu buat environment khusus untuk integrasi ini. Tambahkan variabel environment berikut sebagai nilai sensitif: SIWC CLIENT ID SIWC REDIRECT URI SIWC CLIENT SECRET ACCESS TOKEN SIWC CLIENT SECRET hanya diperlukan untuk klien rahasia. Referensikan nilai dengan sintaks seperti: {{SIWC CLIENT ID}} Dengan begitu, secret tidak tersimpan langsung dalam koleksi request. Pada tab Auth : openid profile email Untuk panduan konfigurasi setiap field, lihat panduan OAuth 2.0 Apidog https://apidog.com/id/blog/test-oauth-2-apis-apidog?utm source=dev.to&utm medium=wanda&utm content=n8n-post-automation . Simpan pertukaran token sebagai request POST terpisah ke token endpoint. Kirim authorization code, PKCE verifier, redirect URI, dan client ID. Tambahkan post-processor berikut untuk memeriksa respons dasar: js const body = pm.response.json ; pm.test "token exchange returned an ID token", = { pm.expect pm.response.code .to.eql 200 ; pm.expect body.id token .to.be.a "string" ; } ; const decode = require "atob" ; const part = body.id token .split "." 1 .replace /-/g, "+" .replace / /g, "/" ; const claims = JSON.parse decode part + "=".repeat 4 - part.length % 4 % 4 ; pm.test "ID token claims match this client", = { pm.expect claims.iss .to.eql "https://auth.openai.com" ; pm.expect claims.aud .to.include pm.environment.get "SIWC CLIENT ID" ; pm.expect claims.sub .to.be.a "string" .and.not.empty; pm.expect claims.exp 1000 .to.be.above Date.now ; } ; Jangan membuat assertion wajib untuk name , email , atau picture , karena klaim tersebut hanya tersedia jika dikembalikan provider. Catat nilainya untuk inspeksi. Untuk penggunaan paket, pastikan body.scope memuat: chatgpt.tokens.use.direct Validasi tanda tangan JWT dan nonce tetap harus dilakukan oleh backend Anda. Akun Plus asli tidak cocok untuk menguji seluruh kasus kegagalan. Gunakan mock server Apidog untuk mengembalikan respons berikut. scope tanpa chatgpt.tokens.use.direct . Aplikasi harus tetap mempertahankan sesi login dan menawarkan aktivasi penggunaan paket atau jalur penagihan lain. error.code bernilai subscription sharing usage limit exceeded . Simulasikan juga kode yang sama dalam event streaming response.failed . Aplikasi harus menghentikan request paket. subscription sharing user not eligible . Jangan melakukan retry atau membuat loop OAuth. invalid grant , atau API mengembalikan HTTP 401 dengan subscription sharing invalid user . Hapus token lokal dan minta pengguna login kembali. Rangkai kasus ini menjadi skenario pengujian dan jalankan pada CI menggunakan Apidog CLI. Halaman kesalahan dan pemulihan https://developers.openai.com/siwc/token-sharing-open-source/errors-and-recovery memuat daftar error lengkap. Dengan token paket asli, kirim request streaming ke API Responses. Di Apidog, gunakan: Bearer {{ACCESS TOKEN}} Request harus berakhir dengan response.completed , yang merupakan satu-satunya sinyal keberhasilan. curl --no-buffer https://api.openai.com/v1/responses \ -H "Authorization: Bearer ${ACCESS TOKEN}" \ -H "Content-Type: application/json" \ -d '{ "model": "gpt-6.1-sol", "input": {"role": "user", "content": "Say exactly: Hello, world "} , "store": false, "stream": true }' Bisakah pengguna Gratis masuk dengan ChatGPT? Ya. Masuk dengan ChatGPT tersedia bagi pengguna ChatGPT secara global. Namun, penggunaan paket di aplikasi lain memerlukan Plus atau Pro. Apakah aplikasi saya mendapatkan kunci API OpenAI pengguna? Tidak. Aplikasi menerima token ID dan, jika penggunaan paket disetujui, token akses OAuth untuk request API Responses yang memenuhi syarat. Apa yang terjadi ketika pengguna mencapai batas penggunaan? Request gagal dengan subscription sharing usage limit exceeded : sebagai HTTP 429, atau event response.failed jika streaming sudah dimulai. Hentikan proses dan tampilkan tautan Kelola penggunaan . Bisakah pengguna Plus menjalankan GPT-6.1 Sol melalui aplikasi mitra? Contoh dokumentasi menggunakan gpt-6.1-sol dengan token paket. Namun, daftar model yang tersedia harus diperiksa dengan token akun tersebut sebelum model ditawarkan di aplikasi. Baca juga apakah GPT-6.1 Sol gratis https://apidog.com/id/blog/gpt-6-1-sol-free?utm source=dev.to&utm medium=wanda&utm content=n8n-post-automation . Jika Anda menjalankan aplikasi komersial, bergabunglah dengan daftar tunggu dan mulai bangun penanganan batas serta pemutusan akses menggunakan mock sekarang. Perlakukan penggunaan paket sebagai opsi tambahan di samping penagihan API Anda, bukan pengganti langsung. Simpan assertion token dan skenario kegagalan di Apidog https://apidog.com?utm source=dev.to&utm medium=wanda&utm content=n8n-post-automation . Saat ID klien Anda tersedia, variabel baru yang perlu diuji hanyalah token asli.