OpenAI API от A до Z · Урок 1

Установка SDK и первый вызов

Ставим openai SDK, создаём клиент, делаем первый chat completion с gpt-4o. Разбираем структуру ответа, finish_reason и usage.

20 мин чтения3 вопроса в квизеГотовый промпт включёнВ работе

Практическое задание

Что сделать после урока

Сделайте первый вызов на TypeScript с gpt-4o. Выведите в консоль content, finish_reason и весь объект usage. Затем поставьте max_tokens: 10 и убедитесь, что finish_reason стал 'length'.

Готовый промпт

Шаблон под задачу урока

Скопируйте и адаптируйте под свой контекст. Текст в треугольных скобках — то, что нужно заменить.

Я подключаю OpenAI API в Node.js проект.
Стэк: <TypeScript / JS>
Задача интеграции: <…>

Дай минимальный рабочий пример: создание клиента OpenAI,
вызов chat.completions.create с gpt-4o, безопасное чтение
choices[0].message.content, логирование usage и обработка ошибок.
Без лишних абстракций.

Минимальный вызов на TypeScript

import OpenAI from "openai"; const client = new OpenAI({ apiKey: process.env.OPENAI_API_KEY, // подхватывается автоматически, но лучше явно }); const completion = await client.chat.completions.create({ model: "gpt-4o", messages: [ { role: "system", content: "Ты лаконичный технический ассистент." }, { role: "user", content: "Объясни замыкания в JS за 3 предложения." }, ], }); console.log(completion.choices[0].message.content);

Что в ответе

Объект ответа chat.completion содержит:

id — идентификатор (вида chatcmpl-...), пригодится для дебага в саппорте OpenAI.

choices — массив вариантов ответа (по умолчанию один). У каждого choices[i].message с полями role и content.

choices[i].finish_reason — "stop" (модель закончила сама), "length" (упёрлись в max_tokens), "tool_calls" (модель хочет вызвать функцию), "content_filter".

usage — prompt_tokens, completion_tokens, total_tokens для подсчёта стоимости.

model — точное имя модели, которое реально отработало (например gpt-4o-2024-08-06).

То же на Python

from openai import OpenAI client = OpenAI() # читает OPENAI_API_KEY из окружения completion = client.chat.completions.create( model="gpt-4o", messages=[ {"role": "system", "content": "Ты лаконичный ассистент."}, {"role": "user", "content": "Привет"}, ], ) print(completion.choices[0].message.content) print(completion.usage.total_tokens)

Ограничение длины ответа

Параметр max_tokens (для o-моделей — max_completion_tokens) ограничивает только длину ответа, не контекст. Если ответ обрезался — finish_reason будет "length". Без указания модель сама решает, когда остановиться, и ставит finish_reason: "stop".

Сообщить об ошибке

Установка SDK и первый вызов

Квиз — 3 вопроса