GENERATIVE AI • LESSON 5

What Is an AI API?

An AI API is a way for your application to communicate with an AI model. Your application sends a request, the AI model processes it, and your application receives the generated response.

CORE IDEA

An AI API is the bridge between your application and an AI model.

Your application does not directly control the model. It sends information through an API and receives the model's response.

01 — WHAT IS AN API?

What Is an API?

API stands for Application Programming Interface.

Don't worry about the technical name. The simplest way to understand an API is:

Simple definition

An API is a way for one software application to communicate with another software service.

Think about ordering food at a restaurant. You tell the waiter what you want. The waiter communicates with the kitchen and brings the food back to you.

The waiter is similar to an API.

You
 ↓
API
 ↓
Service
 ↓
API
 ↓
You

You don't need to directly interact with the service. The API provides the communication mechanism.

02 — SIMPLE SOFTWARE EXAMPLE

How Does an API Work?

Imagine you are building a weather application. Your Python application wants to know:

What's the weather today?

Your application does not have its own weather sensors. Instead, it communicates with a weather service through an API.

Python Application
        ↓
    Weather API
        ↓
   Weather Service
        ↓
    Weather Data
        ↓
    Python Application

The application can then display:

Example response

Today is 29°C.

03 — WHAT IS AN AI API?

What Is an AI API?

Now replace the weather service with an AI model.

Your application wants the AI to answer:

Explain machine learning simply.

Your application sends this request to an AI API.

Python Application
       ↓
     AI API
       ↓
      LLM
       ↓
     Answer
       ↓
     AI API
       ↓
Python Application

Therefore:

Simple definition

An AI API allows your application to send information to an AI model and receive the model's response.

04 — THE MOST IMPORTANT FLOW

Request → AI API → LLM → Response

This is the most important flow to remember.

USER
 ↓
APPLICATION
 ↓
REQUEST
 ↓
AI API
 ↓
LLM
 ↓
RESPONSE
 ↓
APPLICATION
 ↓
USER

This basic flow is the foundation of many Generative AI applications.

05 — WHAT IS A REQUEST?

What Is a Request?

A request is the information your application sends to the AI service.

A simple request could be:

Explain Generative AI in simple English.

An actual API request can contain more information.

Request
├── Model
├── Prompt
├── Instructions
└── Other settings

For example:

Model:
gpt-5.6

Prompt:
Explain Generative AI.

Instruction:
Use simple English.

Your Python application sends this information to the AI API.

06 — WHAT IS A RESPONSE?

What Is a Response?

The response is the information that the AI service sends back to your application.

For example:

Request

Explain Generative AI in simple English.
Response

Generative AI is a type of AI that can create
new content such as text, images, audio, video,
and code.

So the basic idea is:

Request
   ↓
AI
   ↓
Response
07 — REQUEST → LLM → RESPONSE

What Happens When Your Application Calls an AI API?

Imagine your Python program contains:

question = "What is Generative AI?"

Your application sends this question to the AI API.

question
   ↓
REQUEST
   ↓
AI API
   ↓
LLM
   ↓
RESPONSE
   ↓
answer

The LLM processes the input and generates an answer.

Request:

"What is Generative AI?"

        ↓

LLM

        ↓

Response:

"Generative AI is AI that can create
new content such as text, images and code."
08 — PRACTICAL PYTHON EXAMPLE

Make Your First AI API Request

Now let's actually connect a Python application to an AI service.

from openai import OpenAI

client = OpenAI()

response = client.responses.create(
    model="gpt-5.6",
    input="What is Generative AI?"
)

print(response.output_text)

This is the basic pattern you will use when building an AI application with an AI SDK.

Step 1 — Import the AI SDK

from openai import OpenAI

This gives your Python application access to the SDK used to communicate with the AI service.

Python
   ↓
AI SDK
   ↓
AI API

Step 2 — Create the Client

client = OpenAI()

The client is the object your Python application uses to communicate with the API.

Step 3 — Send the Request

response = client.responses.create(
    model="gpt-5.6",
    input="What is Generative AI?"
)

This is where the actual API request is made.

You are telling the AI service which model to use and what input to process.

Step 4 — Receive the Response

print(response.output_text)

The generated text is extracted from the response and displayed by your Python application.

09 — COMPLETE FLOW WITH CODE

See the Whole Process Together

Python Application
        │
        │  "What is Generative AI?"
        ▼
     Request
        │
        ▼
      AI API
        │
        ▼
       LLM
        │
        │ Generates answer
        ▼
     Response
        │
        ▼
Python Application
        │
        ▼
      print()
        │
        ▼
       User

Your Python application does not generate the answer itself. The LLM generates the answer.

IMPORTANT

The API provides the communication path. The LLM generates the response.

This distinction becomes very important when you start building real AI applications.

10 — REAL-WORLD EXAMPLE

Customer Support Application

Imagine you are building an e-commerce customer support application.

A customer asks:

When will my order arrive?

Your application may have the following information:

Order:
#12345

Status:
Shipped

Expected delivery:
August 28

Your application sends the relevant information to the AI model.

REQUEST

Customer question:
When will my order arrive?

Context:
Order #12345
Status: Shipped
Expected delivery: August 28

The LLM can then generate a natural-language response:

Generated response

Your order #12345 has been shipped and is expected to arrive on August 28.

The architecture becomes:

Customer
   ↓
Your Application
   ↓
Order Database
   ↓
Relevant Information
   ↓
AI API
   ↓
LLM
   ↓
Response
   ↓
Customer

Notice something important: the LLM did not retrieve the order itself.

Your application retrieved the order information and provided it to the model.

11 — DOCUMENT ASSISTANT

Another Real-World Example

Imagine a company has 1,000 pages of documentation.

A user asks:

How many days do I have to request a refund?

Your application can first search the company's documents and find the relevant information.

User Question
      ↓
Search Documents
      ↓
Find Relevant Information
      ↓
Send Information + Question
      ↓
AI API
      ↓
LLM
      ↓
Answer
Example answer

You can request a refund within 30 days.

This is a common architecture used in Generative AI applications and is closely related to RAG, which you will learn later.

12 — API VS LLM

Don't Confuse an API With an LLM

These two things are related, but they are not the same thing.

LLM

The AI model that processes input and generates output.

LLM
 ↓
Processes input
 ↓
Generates response
API

The communication mechanism that allows an application to interact with the model.

Your App
 ↓
API
 ↓
LLM
Simple mental model

LLM = Brain    |    API = Communication channel    |    Application = Your software

13 — API VS CHATGPT

API vs ChatGPT

ChatGPT and an AI API are not the same thing.

ChatGPT is an application/interface designed for humans to interact with AI.

An API allows your own application to interact with an AI model.

Using ChatGPT

You
 ↓
ChatGPT
 ↓
AI Model
Building Your Own Application

Your Website
 ↓
Your Backend
 ↓
AI API
 ↓
AI Model
 ↓
Response
 ↓
Your Website

This is why developers use APIs when building AI-powered products.

14 — WHAT CAN YOU BUILD?

What Can You Build With an AI API?

Once you understand the basic API flow, you can build many different applications.

AI Chatbot

User
 ↓
Question
 ↓
LLM
 ↓
Answer
AI Email Assistant

Email
 ↓
LLM
 ↓
Summary / Reply
Document Q&A

Document
 ↓
Relevant Information
 ↓
LLM
 ↓
Answer
Coding Assistant

Code + Question
 ↓
LLM
 ↓
Explanation / Fix
Content Generator

Topic
 ↓
LLM
 ↓
Article / Description / Summary
15 — IMPORTANT REALITY

Calling an API Does Not Automatically Create an AI Product

This:

Python
 ↓
AI API
 ↓
LLM

is only the basic connection.

A useful production application often looks more like:

User
 ↓
Your Application
 ↓
Authentication
 ↓
Business Logic
 ↓
Database / Search / APIs
 ↓
Relevant Context
 ↓
Prompt
 ↓
AI API
 ↓
LLM
 ↓
Response Processing
 ↓
User

The LLM is only one component.

IMPORTANT REALITY

Calling an LLM API gives you access to an AI model. It does not automatically give you a complete AI product.

A real application still needs application logic, data, security, error handling, validation, and a useful user experience.

WHAT YOU SHOULD REMEMBER

An AI API connects your application to an AI model.

Your application sends a request, the AI model processes the request, and the API returns the generated response to your application.

Your App Request AI API LLM Response
QUICK CHECK

Test Your Understanding

1. What does API stand for?

Answer: Application Programming Interface.

2. What does an AI API allow your application to do?

Answer: Communicate with an AI model by sending requests and receiving responses.

3. Is an API the same thing as an LLM?

Answer: No. The LLM is the AI model, while the API is the communication interface used by applications to interact with the model.

4. Does an LLM automatically know a customer's latest order status?

Answer: No. Your application normally retrieves the current order information and provides it to the LLM.

NEXT TOPIC

Using an AI API with Python

Now that you understand the communication between an application, an AI API, and an AI model, the next step is to make your first API request from Python.