This notebook is from OpenAI Cookbooks, enhanced with Portkey observability and features

The GPT-4o Model

GPT-4o (“o” for “omni”) is designed to handle a combination of text, audio, and video inputs, and can generate outputs in text, audio, and image formats.

Current Capabilities

Currently, the API supports {text, image} inputs only, with {text} outputs, the same modalities as gpt-4-turbo. Additional modalities, including audio, will be introduced soon.

This guide will help you get started with using GPT-4o for text, image, and video understanding.

Getting Started

Install OpenAI SDK for Python

pip install --upgrade --quiet openai portkey-ai

Configure the OpenAI Client

First, grab your OpenAI API key here. Now, let’s start with a simple input to the model for our first request. We’ll use both system and user messages for our first request, and we’ll receive a response from the assistant role.

from openai import OpenAI

from portkey_ai import PORTKEY_GATEWAY_URL, createHeaders

import os

## Set the API key and model name

MODEL="gpt-4o"

client = OpenAI(

    api_key=os.environ.get("OPENAI_API_KEY", ""),

    base_url=PORTKEY_GATEWAY_URL,

    default_headers=createHeaders(

        provider="openai",

        api_key="PORTKEY_API_KEY" # defaults to os.environ.get("PORTKEY_API_KEY")

    )

  )
completion = client.chat.completions.create(

  model=MODEL,

  messages=[

    {"role": "system", "content": "You are a helpful assistant. Help me with my math homework!"}, # <-- This is the system message that provides context to the model

    {"role": "user", "content": "Hello! Could you solve 2+2?"}  # <-- This is the user message for which the model will generate a response

  ]

)

print("Assistant: " + completion.choices[0].message.content)

Image Processing

GPT-4o can directly process images and take intelligent actions based on the image. We can provide images in two formats:

  1. Base64 Encoded
  2. URL

Let’s first view the image we’ll use, then try sending this image as both Base64 and as a URL link to the API

from IPython.display import Image, display, Audio, Markdown

import base64

IMAGE_PATH = "data/triangle.png"

# Preview image for context

display(Image(IMAGE_PATH))

Base64 Image Processing

# Open the image file and encode it as a base64 string

def encode_image(image_path):

    with open(image_path, "rb") as image_file:

        return base64.b64encode(image_file.read()).decode("utf-8")

base64_image = encode_image(IMAGE_PATH)

response = client.chat.completions.create(

    model=MODEL,

    messages=[

        {"role": "system", "content": "You are a helpful assistant that responds in Markdown. Help me with my math homework!"},

        {"role": "user", "content": [

            {"type": "text", "text": "What's the area of the triangle?"},

            {"type": "image_url", "image_url": {

                "url": f"data:image/png;base64,{base64_image}"}

            }

        ]}

    ],

    temperature=0.0,

)

print(response.choices[0].message.content)

URL Image Processing

response = client.chat.completions.create(

    model=MODEL,

    messages=[

        {"role": "system", "content": "You are a helpful assistant that responds in Markdown. Help me with my math homework!"},

        {"role": "user", "content": [

            {"type": "text", "text": "What's the area of the triangle?"},

            {"type": "image_url", "image_url": {

                "url": "https://upload.wikimedia.org/wikipedia/commons/e/e2/The_Algebra_of_Mohammed_Ben_Musa_-_page_82b.png"}

            }

        ]}

    ],

    temperature=0.0,

)

print(response.choices[0].message.content)

Video Processing

While it’s not possible to directly send a video to the API, GPT-4o can understand videos if you sample frames and then provide them as images. It performs better at this task than GPT-4 Turbo.

Since GPT-4o in the API does not yet support audio-in (as of May 2024), we’ll use a combination of GPT-4o and Whisper to process both the audio and visual for a provided video, and showcase two usecases:

  1. Summarization
  2. Question and Answering

Setup for Video Processing

We’ll use two python packages for video processing - opencv-python and moviepy.

These require ffmpeg, so make sure to install this beforehand. Depending on your OS, you may need to run brew install ffmpeg or sudo apt install ffmpeg

pip install opencv-python --quiet

pip install moviepy --quiet

Process the video into two components: frames and audio

import cv2

from moviepy.editor import VideoFileClip

import time

import base64

# We'll be using the OpenAI DevDay Keynote Recap video. You can review the video here: https://www.youtube.com/watch?v=h02ti0Bl6zk

VIDEO_PATH = "data/keynote_recap.mp4"
def process_video(video_path, seconds_per_frame=2):

    base64Frames = []

    base_video_path, _ = os.path.splitext(video_path)

    video = cv2.VideoCapture(video_path)

    total_frames = int(video.get(cv2.CAP_PROP_FRAME_COUNT))

    fps = video.get(cv2.CAP_PROP_FPS)

    frames_to_skip = int(fps * seconds_per_frame)

    curr_frame=0

    # Loop through the video and extract frames at specified sampling rate

    while curr_frame < total_frames - 1:

        video.set(cv2.CAP_PROP_POS_FRAMES, curr_frame)

        success, frame = video.read()

        if not success:

            break

        _, buffer = cv2.imencode(".jpg", frame)

        base64Frames.append(base64.b64encode(buffer).decode("utf-8"))

        curr_frame += frames_to_skip

    video.release()

    # Extract audio from video

    audio_path = f"{base_video_path}.mp3"

    clip = VideoFileClip(video_path)

    clip.audio.write_audiofile(audio_path, bitrate="32k")

    clip.audio.close()

    clip.close()

    print(f"Extracted {len(base64Frames)} frames")

    print(f"Extracted audio to {audio_path}")

    return base64Frames, audio_path

# Extract 1 frame per second. You can adjust the `seconds_per_frame` parameter to change the sampling rate

base64Frames, audio_path = process_video(VIDEO_PATH, seconds_per_frame=1)

## Display the frames and audio for context

display_handle = display(None, display_id=True)

for img in base64Frames:

    display_handle.update(Image(data=base64.b64decode(img.encode("utf-8")), width=600))

    time.sleep(0.025)

Audio(audio_path)

Example 1: Summarization

Now that we have both the video frames and the audio, let’s run a few different tests to generate a video summary to compare the results of using the models with different modalities. We should expect to see that the summary generated with context from both visual and audio inputs will be the most accurate, as the model is able to use the entire context from the video.

  1. Visual Summary
  2. Audio Summary
  3. Visual + Audio Summary

Visual Summary

The visual summary is generated by sending the model only the frames from the video. With just the frames, the model is likely to capture the visual aspects, but will miss any details discussed by the speaker.

response = client.chat.completions.create(

    model=MODEL,

    messages=[

    {"role": "system", "content": "You are generating a video summary. Please provide a summary of the video. Respond in Markdown."},

    {"role": "user", "content": [

        "These are the frames from the video.",

        *map(lambda x: {"type": "image_url",

                        "image_url": {"url": f'data:image/jpg;base64,{x}', "detail": "low"}}, base64Frames)

        ],

    }

    ],

    temperature=0,

)

print(response.choices[0].message.content)

The model is able to capture the high level aspects of the video visuals, but misses the details provided in the speech.

Audio Summary

The audio summary is generated by sending the model the audio transcript. With just the audio, the model is likely to bias towards the audio content, and will miss the context provided by the presentations and visuals.

{audio} input for GPT-4o isn’t currently available but will be coming soon! For now, we use our existing whisper-1 model to process the audio

# Transcribe the audio

transcription = client.audio.transcriptions.create(

    model="whisper-1",

    file=open(audio_path, "rb"),

)

## OPTIONAL: Uncomment the line below to print the transcription

#print("Transcript: ", transcription.text + "\n\n")

response = client.chat.completions.create(

    model=MODEL,

    messages=[

    {"role": "system", "content":"""You are generating a transcript summary. Create a summary of the provided transcription. Respond in Markdown."""},

    {"role": "user", "content": [

        {"type": "text", "text": f"The audio transcription is: {transcription.text}"}

        ],

    }

    ],

    temperature=0,

)

print(response.choices[0].message.content)

The audio summary might be biased towards the content discussed during the speech, but comes out with much less structure than the video summary.

Audio + Visual Summary

The Audio + Visual summary is generated by sending the model both the visual and the audio from the video at once. When sending both of these, the model is expected to better summarize since it can perceive the entire video at once.

## Generate a summary with visual and audio

response = client.chat.completions.create(

    model=MODEL,

    messages=[

    {"role": "system", "content":"""You are generating a video summary. Create a summary of the provided video and its transcript. Respond in Markdown"""},

    {"role": "user", "content": [

        "These are the frames from the video.",

        *map(lambda x: {"type": "image_url",

                        "image_url": {"url": f'data:image/jpg;base64,{x}', "detail": "low"}}, base64Frames),

        {"type": "text", "text": f"The audio transcription is: {transcription.text}"}

        ],

    }

],

    temperature=0,

)

print(response.choices[0].message.content)

After combining both the video and audio, you’ll be able to get a much more detailed and comprehensive summary for the event which uses information from both the visual and audio elements from the video.

Example 2: Question and Answering

For the Q&A, we’ll use the same concept as before to ask questions of our processed video while running the same 3 tests to demonstrate the benefit of combining input modalities:

  1. Visual Q&A
  2. Audio Q&A
  3. Visual + Audio Q&A
QUESTION = "Question: Why did Sam Altman have an example about raising windows and turning the radio on?"
qa_visual_response = client.chat.completions.create(

    model=MODEL,

    messages=[

    {"role": "system", "content": "Use the video to answer the provided question. Respond in Markdown."},

    {"role": "user", "content": [

        "These are the frames from the video.",

        *map(lambda x: {"type": "image_url", "image_url": {"url": f'data:image/jpg;base64,{x}', "detail": "low"}}, base64Frames),

        QUESTION

        ],

    }

    ],

    temperature=0,

)

print("Visual QA:\n" + qa_visual_response.choices[0].message.content)
Visual QA:

Sam Altman used the example about raising windows and turning the radio on to demonstrate the function calling capability of GPT-4 Turbo. The example illustrated how the model can interpret and execute multiple commands in a more structured and efficient manner. The "before" and "after" comparison showed how the model can now directly call functions like `raise_windows()` and `radio_on()` based on natural language instructions, showcasing improved control and functionality.
qa_audio_response = client.chat.completions.create(

    model=MODEL,

    messages=[

    {"role": "system", "content":"""Use the transcription to answer the provided question. Respond in Markdown."""},

    {"role": "user", "content": f"The audio transcription is: {transcription.text}. \n\n {QUESTION}"},

    ],

    temperature=0,

)

print("Audio QA:\n" + qa_audio_response.choices[0].message.content)
Audio QA:

The provided transcription does not include any mention of Sam Altman or an example about raising windows and turning the radio on. Therefore, I cannot provide an answer based on the given transcription.
qa_both_response = client.chat.completions.create(

    model=MODEL,

    messages=[

    {"role": "system", "content":"""Use the video and transcription to answer the provided question."""},

    {"role": "user", "content": [

        "These are the frames from the video.",

        *map(lambda x: {"type": "image_url",

                        "image_url": {"url": f'data:image/jpg;base64,{x}', "detail": "low"}}, base64Frames),

                        {"type": "text", "text": f"The audio transcription is: {transcription.text}"},

        QUESTION

        ],

    }

    ],

    temperature=0,

)

print("Both QA:\n" + qa_both_response.choices[0].message.content)
Both QA:

Sam Altman used the example of raising windows and turning the radio on to demonstrate the improved function calling capabilities of GPT-4 Turbo. The example illustrated how the model can now handle multiple function calls more effectively and follow instructions better. In the "before" scenario, the model had to be prompted separately for each action, whereas in the "after" scenario, the model could handle both actions in a single prompt, showcasing its enhanced ability to manage and execute multiple tasks simultaneously.

Comparing the three answers, the most accurate answer is generated by using both the audio and visual from the video. Sam Altman did not discuss the raising windows or radio on during the Keynote, but referenced an improved capability for the model to execute multiple functions in a single request while the examples were shown behind him.

Conclusion

Integrating many input modalities such as audio, visual, and textual, significantly enhances the performance of the model on a diverse range of tasks. This multimodal approach allows for more comprehensive understanding and interaction, mirroring more closely how humans perceive and process information.