OpenAI • Python • Tutorial

Getting Started with OpenAI API: Text & Conversations

A complete beginner's guide to using OpenAI's powerful API for text generation and conversations with practical Python examples.

May 21, 2026 10 min read Beginner Friendly OpenAI API

OpenAI has revolutionized how we interact with artificial intelligence. Whether you're building chatbots, generating creative content, or summarizing data, the OpenAI API makes it accessible to everyone.

In this comprehensive tutorial, we'll walk through two core capabilities: generating creative text and building conversational AI with GPT-4. Each section includes step-by-step explanations and working, beginner-friendly code examples.

1. Setting Up Your OpenAI Connection

Before we can start using OpenAI's powerful models, we need to install the official Python library and set up our API client.

📦 Installation Step

First, we'll install the OpenAI Python library. Open your terminal and run the following command.

# Step 1: Install the OpenAI library
pip install openai

Next, we need to import the library and configure the API. You can get your API key from the OpenAI platform dashboard.

# Step 2: Import and configure OpenAI
from openai import OpenAI

# Initialize the client with your API key
client = OpenAI(api_key="YOUR_API_KEY_HERE")

The OpenAI library provides simple Python functions to interact with GPT-4, GPT-3.5, and DALL-E
Your API key authenticates your requests and tracks your usage

The OpenAI API transforms complex AI models into simple function calls. What once required PhD-level expertise now takes just a few lines of Python.

2. Text Generation & Token Tracking

Let's start with text generation. We'll ask GPT-4 to write a short creative story about artificial intelligence. We will also look at how to extract the AI's actual response and check how many "tokens" (pieces of words) the request consumed.

response = client.chat.completions.create(
    model="gpt-4",
    messages=[
        {"role": "system", "content": "You are a creative writer."},
        {"role": "user", "content": "Write a 3-paragraph short story about an AI learning to understand human emotions."}
    ],
    temperature=0.8,
    max_tokens=500
)

# Print the AI's response text
print(response.choices[0].message.content)

# Print how many tokens were consumed
print("Tokens used:", response.usage.total_tokens)

🎯 Understanding the Parameters

model: Specifies which AI model to use (gpt-4, gpt-3.5-turbo, etc.)
messages: Conversation history with roles (system, user, assistant)
temperature: Controls randomness (0 = focused, 1 = creative)
max_tokens: Maximum length of the response
response.usage: A helpful object that tells you exactly how many tokens your prompt and the generated answer used, which helps track costs.

3. Chat Completion: Intelligent Q&A

Chat completions allow us to have multi-turn conversations with the AI. The model maintains context across messages, making it perfect for building chatbots, tutoring systems, or interactive assistants.

questions = [
    "What is a Python decorator in simple terms?",
    "Can you give me a real-world use case?",
    "How is it different from a regular function?"
]

# We start our conversation history with a system prompt
conversation = [
    {"role": "system", "content": "You are a helpful Python tutor."}
]

for question in questions:
    print("User:", question)
    
    # 1. Add user question to history
    conversation.append({"role": "user", "content": question})
    
    # 2. Ask the AI
    response = client.chat.completions.create(
        model="gpt-4",
        messages=conversation
    )
    
    # 3. Print the answer
    answer = response.choices[0].message.content
    print("AI:", answer, "\n")
    
    # 4. Add the AI's answer back into the history so it remembers context
    conversation.append({"role": "assistant", "content": answer})

Conversation history allows the AI to maintain context across multiple exchanges
The system message sets the AI's behavior and persona
Building the messages array progressively creates a natural dialogue flow

Summary & Key Takeaways

We've explored the fundamental capabilities of the OpenAI API. Each serves a different purpose but shares the same simple, beginner-friendly interface.

1 Text Generation & Tokens

Perfect for creating content, writing assistance, and code generation. Always check response.usage.total_tokens to monitor your usage and optimize your prompts.

2 Chat Completion

Build conversational AI that remembers context by appending both user and assistant messages to a continuous list. Ideal for chatbots, tutoring systems, customer support, and interactive assistants.

Next Steps:
1: Create an interface with Gradio or Streamlit,
2: Implement streaming for real-time responses,
3: Integrate these capabilities into web applications.
Happy coding!

Baig Academy