OpenAI ChatGPT API 사용법 (responses api)

alpha2025-04-23 12:32

ChatGPT API 사용법 튜토리얼

OpenAI의 ChatGPT API를 사용하여 텍스트 및 이미지 분석, 도구 활용 등 다양한 기능을 구현하는 방법을 안내합니다. 이 튜토리얼에서는 JavaScript, Python, 및 cURL을 사용한 예제를 소개합니다.

1. 기본 텍스트 생성

ChatGPT 모델을 사용하여 텍스트 생성을 시작합니다.

JavaScript

import OpenAI from "openai";
const client = new OpenAI();

const response = await client.responses.create({
    model: "gpt-4.1",
    input: "Write a one-sentence bedtime story about a unicorn."
});

console.log(response.output_text);

Python

from openai import OpenAI
client = OpenAI()

response = client.responses.create(
    model="gpt-4.1",
    input="Write a one-sentence bedtime story about a unicorn."
)

print(response.output_text)

cURL

curl "https://api.openai.com/v1/responses" \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer $OPENAI_API_KEY" \
    -d '{
        "model": "gpt-4.1",
        "input": "Write a one-sentence bedtime story about a unicorn."
    }'

2. 이미지 분석

모델에게 이미지 내용을 분석하도록 입력할 수 있습니다.

JavaScript

import OpenAI from "openai";
const client = new OpenAI();

const response = await client.responses.create({
    model: "gpt-4.1",
    input: [
        { role: "user", content: "What two teams are playing in this photo?" },
        {
            role: "user",
            content: [
                {
                    type: "input_image", 
                    image_url: "https://upload.wikimedia.org/wikipedia/commons/3/3b/LeBron_James_Layup_%28Cleveland_vs_Brooklyn_2018%29.jpg",
                }
            ],
        },
    ],
});

console.log(response.output_text);

Python

from openai import OpenAI
client = OpenAI()

response = client.responses.create(
    model="gpt-4.1",
    input=[
        {"role": "user", "content": "what teams are playing in this image?"},
        {
            "role": "user",
            "content": [
                {
                    "type": "input_image",
                    "image_url": "https://upload.wikimedia.org/wikipedia/commons/3/3b/LeBron_James_Layup_%28Cleveland_vs_Brooklyn_2018%29.jpg"
                }
            ]
        }
    ]
)

print(response.output_text)

3. 웹 검색 활용

모델에 최신 정보를 제공하기 위해 웹 검색을 활용할 수 있습니다.

JavaScript

import OpenAI from "openai";
const client = new OpenAI();

const response = await client.responses.create({
    model: "gpt-4.1",
    tools: [ { type: "web_search_preview" } ],
    input: "What was a positive news story from today?",
});

console.log(response.output_text);

Python

from openai import OpenAI
client = OpenAI()

response = client.responses.create(
    model="gpt-4.1",
    tools=[{"type": "web_search_preview"}],
    input="What was a positive news story from today?"
)

print(response.output_text)

4. 스트리밍 이벤트

빠른 응답을 위해 스트리밍 기능을 사용할 수 있습니다.

JavaScript

import { OpenAI } from "openai";
const client = new OpenAI();

const stream = await client.responses.create({
    model: "gpt-4.1",
    input: [
        {
            role: "user",
            content: "Say 'double bubble bath' ten times fast.",
        },
    ],
    stream: true,
});

for await (const event of stream) {
    console.log(event);
}

Python

from openai import OpenAI
client = OpenAI()

stream = client.responses.create(
    model="gpt-4.1",
    input=[
        {
            "role": "user",
            "content": "Say 'double bubble bath' ten times fast.",
        },
    ],
    stream=True,
)

for event in stream:
    print(event)

5. 에이전트 구축

OpenAI 플랫폼을 사용하여 사용자 대신 행동할 수 있는 에이전트를 구축합니다.

from agents import Agent, Runner
import asyncio

spanish_agent = Agent(
    name="Spanish agent",
    instructions="You only speak Spanish.",
)

english_agent = Agent(
    name="English agent",
    instructions="You only speak English",
)

triage_agent = Agent(
    name="Triage agent",
    instructions="Handoff to the appropriate agent based on language.",
    handoffs=[spanish_agent, english_agent],
)

async def main():
    result = await Runner.run(triage_agent, input="Hola, ¿cómo estás?")
    print(result.final_output)

if __name__ == "__main__":
    asyncio.run(main())

# Output: ¡Hola! Estoy bien, gracias por preguntar. ¿Y tú, cómo estás?

결론

ChatGPT API를 사용하여 다양한 AI 기능을 활용할 수 있습니다. 더 많은 예제와 API 참조를 통해 더 깊이 알아갈 수 있습니다.

이 튜토리얼에서는 기본적인 시작 방법을 설명했습니다. 추가적으로 텍스트 생성, 이미지 입력, 웹 검색, 스트리밍, 에이전트 구축 등 다양한 기능을 사용해 보세요.
OpenAI 문서 및 GitHub 예제를 참고하여 더 복잡한 응용 프로그램을 개발해 보세요.

더 많은 정보와 API 참조를 OpenAI 문서에서 확인하세요.