Kembali ke blog

MemulaiPanduan

Request pertama ke API yang kompatibel dengan OpenAI di Postman

Kirim request chat/completions dari Postman dengan kunci Bearer yang disimpan dalam variabel, dan baca jawaban serta kolom usage.

Oleh CheapTokens TeamDiterbitkan 4 menit baca

Body request Postman dengan id model dan satu pesan untuk API CheapTokens
Di halaman ini
  1. Siapkan dalam empat langkah
  2. Tekan Send dan baca responsnya
  3. Berapa biaya request pertama
  4. Jika tidak berhasil

Anda punya kunci API dan ingin melihat apa yang sebenarnya dikirim sebelum menulis satu baris kode. Postman cocok untuk itu: Anda isi URL, kunci, dan body JSON, tekan Send, dan jawabannya muncul tepat di bawah. Untuk CheapTokens, request-nya adalah POST https://api.cheaptokens.dev/v1/chat/completions dengan kunci Authorization: Bearer dan body JSON yang menyebutkan model.

Langkah-langkah di bawah mengikuti dokumentasi Postman sendiri (v12, versi terbaru di situs docs, dicek 31 Oktober 2026). Jika Anda lebih suka terminal, request yang sama ada di Your first API request with CheapTokens.

Body request di Postman: id model, satu pesan pengguna, max_tokens
Body JSON mentah dari request pertama

Siapkan dalam empat langkah#

Anda hanya perlu beberapa hal: base URL, kunci Anda, id model, dan satu pesan. Postman menyimpan dua yang pertama dalam variabel, jadi kunci tidak pernah ditempel ke request itu sendiri.

Urutkan

Urutkan setup Postman

  1. Definisikan variabel base_url dan api_key
  2. Buat request HTTP: POST ke {{base_url}}/chat/completions
  3. Di tab Authorization pilih Bearer Token dan masukkan {{api_key}}
  4. Di tab Body pilih raw > JSON, tempel body, tekan Send

Beberapa detail untuk setiap langkah.

Buat request. Klik ikon Add di sidebar kiri dan pilih HTTP. Dropdown method default-nya GET, jadi ubah ke POST dan masukkan URL. Variabel Postman ditulis {{variable_name}}; dokumentasi menggunakan {{base_url}} sebagai contoh. Definisikan base_url sebagai https://api.cheaptokens.dev/v1 dan kolom URL menjadi {{base_url}}/chat/completions. Postman menyimpan variabel sebagai string, yang tidak masalah di sini.

Tambahkan kunci. Buka tab Authorization, pilih Bearer Token di dropdown Auth Type dan masukkan {{api_key}} di kolom Token. Postman mengirimnya sebagai header Authorization dalam format Bearer. Dokumentasi merekomendasikan tepat ini: simpan token dalam variabel dan rujuk dengan namanya. Mengapa kebiasaan itu penting ada di Store an API key safely.

Tulis body. Di tab Body pilih raw, lalu JSON di dropdown. Untuk body raw, Postman mengatur Content-Type yang sesuai sendiri, jadi Anda tidak perlu menambahkan header itu. Tempel ini:

json
{
  "model": "deepseek-ai/DeepSeek-V4-Flash-0731",
  "messages": [
    { "role": "user", "content": "Explain in one sentence what a token is." }
  ],
  "max_tokens": 200
}

Id model adalah gateway_id lengkap dari dokumentasi CheapTokens; nama pendek seperti deepseek-flash tidak diterima. max_tokens membatasi panjang jawaban, jadi tes pertama tidak bisa berjalan lama. Satu detail Postman lagi: komentar // dan /* */ dalam body JSON dihapus sebelum dikirim, jadi Anda bisa memberi anotasi pada body untuk rekan tim.

Tekan Send dan baca responsnya#

Jika semuanya benar, panel respons menampilkan objek JSON dalam format OpenAI Chat Completions. Dua tempat penting:

  • choices[0].message.content adalah teks jawaban.
  • usage berisi prompt_tokens (yang Anda kirim) dan completion_tokens (yang ditulis model). Ini yang Anda ditagih, jadi lihatlah pada request pertama.

Periksa juga choices[0].finish_reason. stop berarti model selesai sendiri; length berarti jawaban mencapai max_tokens dan terpotong. Jika Anda melihat itu, naikkan batas atau baca AI answer cut off? Fix finish_reason "length".

Coba sebelum Anda membuka jawabannya:

Coba sendiriCoba: Anda set max_tokens ke 5 dan tekan Send. Apa yang Anda harapkan di finish_reason?Tampilkan jawaban

Anda mendapat length: lima token tidak cukup untuk kalimat lengkap, jadi jawaban terpotong. Kembalikan ke 200 dan hasilnya menjadi stop.

Berapa biaya request pertama#

Katakanlah request di atas menggunakan sekitar 30 token input dan jawabannya memakan sekitar 100 token output (contoh, bukan pengukuran; kolom usage Anda menunjukkan angka sebenarnya). Pada DeepSeek-V4-Flash itu $0.00001 dengan harga saat ini, dan harganya sama pada jam berapa pun. Harga per 1M token ada di tabel langsung di halaman harga.

Request Postman yang sama dapat mencoba model lain. Ganti hanya baris model, misalnya dengan zai-org/GLM-5.3-Flash (konteks 390K, hingga 8.192 token output), dan tekan Send lagi. Satu saldo mencakup semua model, jadi tidak ada yang berubah: URL sama, kunci sama.

Jika tidak berhasil#

Postman menampilkan kode status di samping respons. Ini tersangka yang biasa:

Cocokkan pasangan

Cocokkan gejala dengan penyebabnya

  • 401 UnauthorizedKunci hilang, salah ketik, atau {{api_key}} kosong karena variabel tidak didefinisikan
  • 404 Not FoundURL salah: periksa bahwa base_url diakhiri dengan /v1 dan path-nya /chat/completions
  • Error yang menyebut modelId model dipendekkan; gunakan id lengkap seperti deepseek-ai/DeepSeek-V4-Flash-0731

Dua hal khusus Postman patut diperiksa. Jika Anda mendapat 401 atau URL tampak salah, periksa bahwa base_url dan api_key didefinisikan di environment yang Anda pilih. Dan jika kunci tampak benar tetapi Anda masih mendapat 401, buka lagi tab Authorization: Auth Type harus Bearer Token, bukan No Auth. Lebih lanjut tentang kode ini: API 401 or 404 error. Tidak yakin id mana yang harus dipakai? List models with GET /v1/models mengembalikan semuanya.

Jika sudah puas, tekan Save, beri nama request dan pilih koleksi. Lain kali Anda hanya mengedit kolom content, atau baris model untuk membandingkan jawaban. Referensi API lengkap ada di dokumentasi CheapTokens.

Tag: