Postman'de OpenAI uyumlu bir API'ye ilk istek

Bir API anahtarınız var ve bir satır kod yazmadan önce gerçekte nelerin ağ üzerinden geçtiğini görmek istiyorsunuz. Postman tam da bunun için iyidir: bir URL, bir anahtar ve bir JSON gövdesi girersiniz, Send'e basarsınız ve yanıt hemen altında belirir. CheapTokens için istek, bir Authorization: Bearer anahtarı ve modeli belirten bir JSON gövdesiyle POST https://api.cheaptokens.dev/v1/chat/completions şeklindedir.

Aşağıdaki adımlar Postman'in kendi belgelerini izler (v12, belge sitesindeki en son sürüm, 31 Ekim 2026'da kontrol edildi). Terminali tercih ediyorsanız, aynı istek CheapTokens ile ilk API isteğiniz sayfasındadır.

Dört adımda kurun#

Yalnızca birkaç şeye ihtiyacınız var: temel URL, anahtarınız, bir model kimliği ve bir mesaj. Postman ilk ikisini değişkenlerde tutar, böylece anahtar hiçbir zaman isteğin kendisine yapıştırılmaz.

Her adım için birkaç ayrıntı.

İsteği oluşturun. Sol kenar çubuğundaki Add simgesine tıklayın ve HTTP'yi seçin. Yöntem açılır menüsü varsayılan olarak GET'tir, bu yüzden POST'a geçirin ve URL'yi girin. Postman değişkenleri {{variable_name}} şeklinde yazılır; belgeler örnek olarak {{base_url}} kullanır. base_url değişkenini https://api.cheaptokens.dev/v1 olarak tanımlayın, URL alanı {{base_url}}/chat/completions olur. Postman değişkenleri dize olarak saklar, bu burada sorun değildir.

Anahtarı ekleyin. Authorization sekmesini açın, Auth Type açılır menüsünde Bearer Token'ı seçin ve Token alanına {{api_key}} girin. Postman bunu Bearer biçiminde Authorization başlığı olarak gönderir. Belgeler tam olarak bunu önerir: token'ı bir değişkende tutun ve adıyla başvurun. Bu alışkanlığın neden önemli olduğu Bir API anahtarını güvenle saklayın sayfasındadır.

Gövdeyi yazın. Body sekmesinde raw'ı, ardından açılır menüde JSON'u seçin. Ham gövdeler için Postman eşleşen Content-Type başlığını kendisi ayarlar, bu yüzden o başlığı eklemezsiniz. Şunu yapıştırın:

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

Model kimliği, CheapTokens belgelerindeki tam gateway_id'dir; deepseek-flash gibi kısa bir ad kabul edilmez. max_tokens yanıtın uzunluğunu sınırlar, böylece ilk test uzun süremez. Bir Postman ayrıntısı daha: bir JSON gövdesindeki // ve /* */ yorumları gönderilmeden önce çıkarılır, böylece gövdeyi bir ekip arkadaşı için açıklayabilirsiniz.

Send'e basın ve yanıtı okuyun#

Her şey doğruysa, yanıt bölmesi OpenAI Chat Completions biçiminde bir JSON nesnesi gösterir. İki yer önemlidir:

• choices[0].message.content yanıt metnidir.
• usage, prompt_tokens (gönderdiğiniz) ve completion_tokens (modelin yazdığı) değerlerini tutar. Faturalandırıldığınız şey budur, bu yüzden ilk istekte buna bakın.

Ayrıca choices[0].finish_reason değerini kontrol edin. stop modelin kendi kendine bitirdiği anlamına gelir; length yanıtın max_tokens sınırına ulaştığı ve kesildiği anlamına gelir. Bunu görürseniz, sınırı yükseltin veya AI yanıtı kesildi mi? finish_reason "length" sorununu düzeltin sayfasını okuyun.

Yanıtı açmadan önce deneyin:

İlk isteğin maliyeti#

Yukarıdaki isteğin yaklaşık 30 giriş token'ı kullandığını ve yanıtın yaklaşık 100 çıkış token'ı aldığını varsayalım (bu bir örnektir, ölçüm değildir; gerçek sayıları usage alanınız gösterir). DeepSeek-V4-Flash'te bu, mevcut fiyatla $0.00001 tutarındadır ve fiyat her saatte aynıdır. 1M token başına fiyatlar fiyatlandırma sayfasındaki canlı tabloda yer alır.

Aynı Postman isteği başka bir modeli deneyebilir. Yalnızca model satırını değiştirin, örneğin zai-org/GLM-5.3-Flash ile (390K bağlam, 8.192 çıkış token'ına kadar) ve tekrar Send'e basın. Tek bir bakiye tüm modelleri kapsar, bu yüzden başka hiçbir şey değişmez: aynı URL, aynı anahtar.

Çalışmazsa#

Postman durum kodunu yanıtın yanında gösterir. Bunlar olağan şüphelilerdir:

Postman'e özgü iki şeyi kontrol etmeye değer. 401 alırsanız veya URL yanlış görünüyorsa, base_url ve api_key'in seçili ortamınızda tanımlı olduğunu kontrol edin. Anahtar doğru görünüyor ama yine de 401 alıyorsanız, Authorization sekmesini tekrar açın: Auth Type, No Auth değil Bearer Token olmalıdır. Bu kodlar hakkında daha fazlası: API 401 veya 404 hatası. Hangi kimliği kullanacağınızdan emin değil misiniz? GET /v1/models ile modelleri listeleyin hepsini döndürür.

Memnun kaldığınızda Save'e basın, isteğe bir ad verin ve bir koleksiyon seçin. Bir dahaki sefere yalnızca content alanını veya yanıtları karşılaştırmak için model satırını düzenlersiniz. Tam API referansı CheapTokens belgelerinde yer alır.