For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to the page URL.
기본 탐색 메뉴
Theme

Amazon Bedrock에서 OpenAI 모델 사용하기

AWS에서 OpenAI 모델을 사용하세요.

Amazon Bedrock은 AWS가 관리하는 인프라에서 지원 대상 OpenAI 모델을 실행합니다. 이 가이드에서 OpenAI API 기능별 지원 여부를 비교하고 OpenAI SDK로 연결하는 방법을 알아보세요. 배포 설정 방법은 이 페이지에 안내된 AWS 문서를 참고하세요.

애플리케이션에서 사용할 수 있는 기능은 모델의 기능과 API 호환성에 따라 달라집니다. Bedrock 배포의 모델 액세스, 리전별 가용성, 라우팅, 요금 청구 및 운영 제어는 AWS가 관리합니다.

Bedrock 엔드포인트별 모델 및 기능 지원

OpenAI 모델은 Amazon Bedrock의 두 엔드포인트인 bedrock-runtime과 bedrock-mantle에서 사용할 수 있습니다. 두 엔드포인트 모두 지원 대상 모델에 대해 OpenAI와 호환되는 Responses API와 Chat Completions API를 제공하지만, 지원하는 기능은 서로 다릅니다.

애플리케이션에 필요한 기능에 맞춰 엔드포인트를 선택하세요. 예를 들어 현재 호스팅형 웹 검색을 사용하려면 Mantle이 필요합니다. Bedrock 고유의 기능과 엔드포인트 선택 기준은 이 페이지의 엔드포인트별 차이와 AWS의 엔드포인트 비교 문서를 참고하세요.

GPT-6 Sol과 GPT-6 Luna는 Bedrock Runtime에서 사용할 수 있으며, Mantle에서는 us-east-1(버지니아 북부)에서 사용할 수 있습니다. GPT-6 Astra는 Bedrock Runtime에서 사용할 수 있으며, Mantle에서는 us-west-2(오리건)에서 사용할 수 있습니다. 이 가이드의 예제는 us-east-2에서 GPT-5.6 Terra를 사용합니다. 모델을 변경하기 전에 해당 모델을 지원하는 리전을 선택하세요.

액세스 및 설정 방법은 AWS의 모델별 엔드포인트 지원 현황과 Runtime 엔드포인트 사용 안내를 참고하세요.

Responses API 요청 보내기

다음 예제에서는 OpenAI SDK로 Mantle 엔드포인트에 요청을 보냅니다. 배포 환경에 맞는 AWS 리전과 모델 ID를 선택하세요.

  • Bedrock 프로바이더를 제공하는 클라이언트 라이브러리는 AWS 리전을 기준으로 해당 리전의 Mantle 기본 URL을 결정합니다. JavaScript, Python, Go, Java 프로바이더는 기본 URL로 https://bedrock-mantle.us-east-2.api.aws/openai/v1을 사용합니다. 이는 이 가이드의 예제 리전인 us-east-2에 해당합니다. Ruby 예제에서는 이 /openai/v1 엔드포인트를 직접 설정합니다. Ruby 프로바이더의 기본 경로인 /v1은 이 모델을 지원하지 않기 때문입니다.
  • openai. 접두사가 붙은 Bedrock 모델 ID를 사용하세요. GPT-6 Sol과 Luna의 모델 ID는 각각 openai.gpt-6-sol과 openai.gpt-6-luna이며, 리전은 us-east-1을 사용하세요.

예제의 모델 ID는 openai.gpt-5.6-terra이고 리전은 us-east-2입니다. GPT-6 Sol 또는 Luna를 사용해 보려면 모델 ID와 리전을 모두 변경하세요. Ruby에서는 직접 지정한 base_url의 리전도 변경하세요. Bedrock Runtime에서는 미국 추론 프로파일 ID인 us.openai.gpt-6-sol과 us.openai.gpt-6-luna 또는 글로벌 ID인 global.openai.gpt-6-sol과 global.openai.gpt-6-luna를 사용하세요. AWS의 Responses API 엔드포인트 사용 안내에 따라 Runtime 기본 URL과 추론 프로파일을 선택하세요.

다음 예제에서는 AWS_BEARER_TOKEN_BEDROCK에 저장한 Bedrock API 키를 사용합니다. Bedrock API 키 생성 및 사용 방법은 Amazon Bedrock API 키 문서를 참고하세요.

두 Java 예제 중 어느 것을 사용하든 먼저 선택적 종속성인 Java용 Bedrock 프로바이더를 설치하세요.

<dependency>
  <groupId>com.openai</groupId>
  <artifactId>openai-java-bedrock</artifactId>
  <version>4.57.0</version>
</dependency>
Amazon Bedrock을 통해 Responses API 요청 보내기
import OpenAI from "openai";
import { bedrock } from "openai/providers/bedrock";

const client = new OpenAI({
  provider: bedrock({
    region: "us-east-2",
    apiKey: process.env.AWS_BEARER_TOKEN_BEDROCK,
  }),
});

const response = await client.responses.create({
  model: "openai.gpt-5.6-terra",
  input: "Write a haiku about cloud infrastructure.",
});

console.log(response.output_text);

장시간 실행되는 애플리케이션에는 고정 Bearer 토큰 대신 표준 AWS 자격 증명 체인을 사용하는 것이 좋습니다. JavaScript, Python, Go, Java, Ruby SDK의 프로바이더는 최신 AWS 자격 증명을 가져오고 요청을 시도할 때마다 SigV4로 서명합니다. 이 체인에는 aws login으로 설정한 자격 증명, 공유 프로파일, 워크로드 역할, 인스턴스 또는 컨테이너 자격 증명이 포함될 수 있습니다.

AWS 자격 증명 체인을 사용하는 예제를 실행하려면 먼저 다음 선택적 종속성을 설치하세요.

npm install @aws-sdk/credential-provider-node @smithy/hash-node @smithy/signature-v4
pip install 'openai[bedrock]'
go get github.com/openai/openai-go/v3/bedrock
bundle add aws-sdk-core

.NET SDK는 현재 이에 해당하는 Bedrock 프로바이더나 AWS SigV4 인증 정책을 제공하지 않습니다. .NET에서는 Bedrock API 키를 사용하세요. 애플리케이션에 AWS 자격 증명 체인이 필요하다면 AWS가 지원하는 클라이언트로 서명된 HTTP 요청을 보내세요.

AWS가 관리하는 Bedrock 자격 증명으로 요청 보내기
import OpenAI from "openai";
import { defaultProvider } from "@aws-sdk/credential-provider-node";
import { bedrock } from "openai/providers/bedrock/aws";

const client = new OpenAI({
  provider: bedrock({
    region: "us-east-2",
    endpoint: "mantle",
    credentialProvider: defaultProvider(),
  }),
});

const response = await client.responses.create({
  model: "openai.gpt-5.6-terra",
  input: "Write a haiku about cloud infrastructure.",
});

console.log(response.output_text);

Responses API 기능별 지원 여부

다음 표에서 OpenAI API와의 차이를 확인하세요. 지원 여부는 모델과 엔드포인트에 따라 달라집니다. API를 지원하더라도 일부 도구나 응답 모드는 지원하지 않을 수 있습니다.

기능 OpenAI API Amazon Bedrock
텍스트 생성 지원 지원
이미지 입력 지원 지원
파일 입력 지원 지원
구조화된 출력값 지원 지원
함수 호출 지원 지원
비동기 도구 호출 지원 대상 모델에서 사용 가능 미지원
스트리밍 응답 지원 지원
WebSocket 연결 지원 미지원
턴 진행 중 지시 변경 지원 대상 모델에서 사용 가능 미지원
컨텍스트 윈도우 모델에 따라 다름 모델에 따라 다름
추론 수준 지원 지원
추론 설정 업데이트 지원 대상 모델에서 사용 가능 미지원
Pro 모드 지원 대상 모델에서 사용 가능 미지원
추론 상태 저장 지원 대상 모델에서 사용 가능 지원 대상 모델에서 사용 가능
프롬프트 캐싱 지원 지원
프로그래밍 방식의 도구 호출 지원 대상 모델에서 사용 가능 미지원
멀티 에이전트 지원 대상 모델에서 베타 제공 미지원
사용자 정의 도구 지원 지원
클라이언트 측 tool_search 지원 지원
호스팅형 웹 검색 지원 Mantle에서만 지원
호스팅형 파일 검색 지원 미지원
컴퓨터 사용 지원 지원
셸 도구 지원 미지원
이미지 생성 도구 지원 미지원
원격 MCP 서버 지원 미지원

Amazon Bedrock은 비동기 도구 호출(async: true)과 추론 설정 업데이트(configuration_update 입력 항목)를 지원하지 않습니다. 턴 진행 중 지시를 변경하려면 WebSocket 연결이 필요하며, 두 Bedrock 엔드포인트 모두 이 기능을 지원하지 않습니다.

클라이언트 측 tool_search는 호스팅형 도구 및 원격 MCP 서버 지원과 별개의 기능입니다. Mantle에서는 호스팅형 웹 검색을 사용할 수 있습니다. 호스팅형 파일 검색과 원격 MCP 서버는 어느 엔드포인트에서도 사용할 수 없습니다.

Runtime과 Mantle 모두 지원 대상 모델에서 컴퓨터 사용 기능을 제공합니다. 애플리케이션이 컴퓨터 조작을 실행하고 결과를 모델에 반환하므로 Bedrock에서 호스팅하는 실행 환경은 필요하지 않습니다.

Amazon Bedrock에서 GPT-5.4와 GPT-5.5의 컨텍스트 윈도우는 100만 토큰입니다. GPT-5.6 Sol, Terra, Luna와 GPT-6 Astra는 105만 토큰을 지원합니다. 모델별 한도는 AWS의 OpenAI 모델 카드에서 확인하세요.

엔드포인트별 차이

Runtime과 Mantle 중 하나를 선택할 때는 다음과 같은 Responses API 기능 차이를 고려하세요.

기능 Bedrock Runtime Mantle
GPT-6 Astra 지원 us-west-2(오리건)에서 지원
GPT-6 Sol과 GPT-6 Luna 미국 및 글로벌 추론 프로파일 지원 us-east-1(버지니아 북부)에서 지원
컴퓨터 사용 지원 대상 모델에서 사용 가능 지원 대상 모델에서 사용 가능
스트리밍 응답 지원 지원
백그라운드 모드(background: true) 미지원 데이터 보관 설정에 따라 사용 가능
호스팅형 웹 검색 미지원 지원 대상 모델에서 사용 가능
previous_response_id로 이전 응답에 이어 요청하기 요청마다 model 포함 이전 응답의 모델을 이어서 사용 가능

Runtime에서는 model이 필수입니다. previous_response_id를 지정해도 마찬가지입니다. 백그라운드 모드는 스트리밍과 별개의 기능이며, 비동기 함수 호출을 뜻하지 않습니다. 엔드포인트의 전체 API 명세는 AWS의 Responses API 문서를 참고하세요. 웹 검색 권한과 설정 방법은 AWS의 웹 검색 가이드에서 확인하세요.

가용성 및 운영

Amazon Bedrock의 배포 옵션과 가용성은 AWS가 관리합니다. 다음 문서를 참고해 배포 방식을 선택하고 설정하세요.

AWS 관리 항목 AWS 문서
모델 ID 및 지원 API OpenAI 모델 카드
AWS 리전별 모델 및 엔드포인트 가용성 모델 가용성 및 엔드포인트 가용성
지리적 권역별 및 글로벌 요청 라우팅 교차 리전 추론
계정 할당량 및 증액 요청 Amazon Bedrock 할당량

AWS 리전은 OpenAI의 데이터 레지던시 관할 구역과 다릅니다. 워크로드에 위치 요건이 있다면 엔드포인트 URL에 표시된 리전뿐 아니라 추론 프로파일의 대상 리전과 적용되는 AWS 약관도 확인하세요.

데이터 액세스 및 보관

Amazon Bedrock은 운영자의 액세스와 데이터 보관을 별도로 제어합니다.

  • 운영자 접근 차단(ZOA) 상태에서는 AWS 운영자가 Mantle의 기반 컴퓨팅 시스템에 로그인하거나 해당 시스템의 고객 데이터에 접근할 기술적 수단이 없습니다. AWS의 ZOA 설계 문서를 참고하세요.
  • 데이터 비보관(ZDR) 적용 조건은 실제 보관 모드가 none인 경우입니다. 이때 AWS는 요청 데이터와 응답 데이터를 영구 스토리지에 기록하지 않습니다.

store: false로 설정해도 ZDR이 보장되지는 않습니다. Responses API 요청에 적용되는 보관 모드가 none이면 AWS는 store: true로 설정한 요청을 거부하며, 백그라운드 모드도 사용할 수 없습니다.

Amazon Bedrock에서 OpenAI 모델을 사용할 때 실제 적용되는 보관 모드가 default 또는 none이면 AWS는 요청이나 응답 내용을 OpenAI와 공유하지 않습니다. 사용 가능한 모드, 적용 요건, 계정 또는 프로젝트 설정 방법은 AWS의 데이터 보관 문서를 참고하세요. 모델별 보관 요건과 예외는 Amazon Bedrock 악용 탐지 문서에서 확인하세요.

AWS는 이미지 입력에서 아동 성착취물로 의심되는 자료를 탐지하면 해당 입력 또는 출력을 ZOA 환경 밖으로 옮길 수 있습니다. 이 경우 아동 성착취물에 해당하는지 판단할 목적으로만 해당 자료를 저장하고 검토할 수 있습니다. AWS는 국가 당국에 신고할 수도 있습니다.

인증 및 운영

AWS 관리자가 계정, 모델, 기능에 대한 액세스를 제어합니다. 자격 증명의 생성 및 수명 주기 관리는 AWS의 API 키 문서를, 자격 증명 주체와 권한은 IAM 문서를 참고하세요. 이 페이지의 OpenAI SDK 예제는 자격 증명을 전달하는 방법을 보여 줍니다. AWS 권한은 별도로 설정해야 합니다.

요금

Amazon Bedrock 사용 요금은 AWS에서 청구합니다. 상용 리전의 Bedrock 요금은 동등한 서비스를 OpenAI에서 직접 사용할 때의 요금과 같습니다. Bedrock에서 특정 리전의 서비스를 사용하면 OpenAI API의 리전별 처리와 동일한 요율이 적용됩니다. Bedrock 사용에는 Amazon의 상업 약관이 적용됩니다.

OpenAI API를 직접 사용할 때의 요금은 API 요금에서 확인하세요. Bedrock 요율, 지원하는 서비스 등급, 결제 옵션은 Amazon Bedrock 요금과 해당 모델 카드를 참고하세요.

Bedrock Managed Agents

AWS에서 관리형 에이전트 세션을 사용하려면 Bedrock Managed Agents를 참고하세요.

다음 단계

ChatGPT Work와 Codex의 설정 방법은 Amazon Bedrock에서 ChatGPT Work와 Codex 사용하기를 참고하세요.