Початок роботиПосібник
Перший запит до OpenAI-сумісного API в Postman
Надішліть запит chat/completions із Postman із Bearer-ключем, збереженим у змінній, і прочитайте відповідь та поле usage.
На цій сторінці
У вас є API-ключ, і ви хочете побачити, що насправді передається мережею, перш ніж написати хоч рядок коду. Postman саме для цього й годиться: ви заповнюєте URL, ключ і JSON-тіло, натискаєте Send, і відповідь з'являється одразу нижче. Для CheapTokens запит — це POST https:/ з ключем Authorization: Bearer і JSON-тілом, у якому вказано модель.
Кроки нижче відповідають документації Postman (v12, найновіша версія на сайті документації, перевірено 31 жовтня 2026). Якщо ви віддаєте перевагу терміналу, той самий запит є в Your first API request with CheapTokens.
Налаштуйте за чотири кроки#
Вам потрібно лише кілька речей: базовий URL, ваш ключ, id моделі та одне повідомлення. Postman зберігає перші дві у змінних, тож ключ ніколи не вставляється в сам запит.
Розставте по порядку
Упорядкуйте налаштування Postman
Перетягніть елементи або скористайтеся стрілками
- Визначте змінні base_url і api_key
- Створіть HTTP-запит: POST на {{base_url}}/chat/completions
- На вкладці Authorization виберіть Bearer Token і введіть {{api_key}}
- На вкладці Body виберіть raw > JSON, вставте тіло, натисніть Send
Кілька деталей для кожного кроку.
Створіть запит. Натисніть іконку Add на лівій бічній панелі й виберіть HTTP. У випадаючому списку методів за замовчуванням стоїть GET, тож перемкніть його на POST і введіть URL. Змінні Postman записуються як {{variable_; у документації як приклад використовується {{base_url}}. Визначте base_url як https:/, і поле URL стане {{base_. Postman зберігає змінні як рядки, і тут це цілком доречно.
Додайте ключ. Відкрийте вкладку Authorization, виберіть Bearer Token у випадаючому списку Auth Type і введіть {{api_key}} у поле Token. Postman надсилає його як заголовок Authorization у форматі Bearer. Документація радить саме це: тримайте токен у змінній і посилайтеся на нього за назвою. Чому ця звичка важлива, описано в Store an API key safely.
Напишіть тіло. На вкладці Body виберіть raw, а потім JSON у випадаючому списку. Для сирих тіл Postman сам встановлює відповідний Content-Type, тож цей заголовок ви не додаєте. Вставте це:
{
"model": "deepseek-ai/DeepSeek-V4-Flash-0731",
"messages": [
{ "role": "user", "content": "Explain in one sentence what a token is." }
],
"max_tokens": 200
}Id моделі — це повний gateway_id з документації CheapTokens; коротка назва на кшталт deepseek-flash не приймається. max_tokens обмежує довжину відповіді, тож перший тест не може затягнутися. Ще одна деталь Postman: коментарі // і /* */ у JSON-тілі видаляються перед надсиланням, тож ви можете залишити анотації до тіла для колеги.
Натисніть Send і прочитайте відповідь#
Якщо все правильно, панель відповіді покаже JSON-об'єкт у форматі OpenAI Chat Completions. Важливі два місця:
choices[0].— це текст відповіді.message. content usageміститьprompt_tokens(те, що ви надіслали) іcompletion_(те, що написала модель). Саме за це ви платите, тож подивіться на це вже в першому запиті.tokens
Також перевірте choices[0].. stop означає, що модель завершила сама; length означає, що відповідь досягла max_tokens і була обрізана. Якщо ви це бачите, збільште ліміт або прочитайте AI answer cut off? Fix finish_reason "length".
Спробуйте, перш ніж відкривати відповідь:
Спробуйте саміСпробуйте: ви встановили max_tokens на 5 і натискаєте Send. Що ви очікуєте побачити в finish_reason?Показати відповідь
Ви отримаєте length: п'яти токенів недостатньо для повного речення, тож відповідь обрізана. Поверніть 200, і це стане stop.
Скільки коштує перший запит#
Припустімо, запит вище використовує близько 30 вхідних токенів, а відповідь займає близько 100 вихідних токенів (це приклад, а не вимірювання; ваше поле usage показує реальні числа). На DeepSeek-V4-Flash це $0.00001 за поточною ціною, і ціна однакова в будь-яку годину. Ціни за 1M токенів є в живій таблиці на the pricing page.
Той самий запит у Postman може спробувати іншу модель. Замініть лише рядок model, наприклад на zai- (контекст 390K, до 8,192 вихідних токенів), і натисніть Send знову. Один баланс покриває всі моделі, тож більше нічого не змінюється: той самий URL, той самий ключ.
Якщо не працює#
Postman показує код стану поруч із відповіддю. Ось звичайні підозрювані:
З'єднайте пари
Зіставте симптом із його причиною
Торкніться елемента ліворуч, потім його пари
- 401 UnauthorizedКлюч відсутній, введений з помилкою, або {{api_key}} порожній, бо змінна не визначена
- 404 Not FoundURL неправильний: перевірте, що base_url закінчується на /v1, а шлях — /chat/completions
- Помилка, яка згадує модельId моделі скорочено; використовуйте повний id, наприклад deepseek-ai/DeepSeek-V4-Flash-0731
Варто перевірити дві речі, специфічні для Postman. Якщо ви отримуєте 401 або URL виглядає неправильно, перевірте, що base_url і api_key визначені в середовищі, яке ви вибрали. А якщо ключ виглядає правильним, але ви все одно отримуєте 401, знову відкрийте вкладку Authorization: Auth Type має бути Bearer Token, а не No Auth. Більше про ці коди: API 401 or 404 error. Не впевнені, який id використовувати? List models with GET /v1/models повертає їх усі.
Коли вас усе влаштовує, натисніть Save, дайте запиту назву й виберіть колекцію. Наступного разу ви редагуватимете лише поле content або рядок model, щоб порівняти відповіді. Повний довідник API є в the CheapTokens docs.
