> ## Documentation Index
> Fetch the complete documentation index at: https://docs.laozhang.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# OpenAI 모델 연동: GPT-6·GPT-5.6·o3-pro 사용법

> OpenAI SDK의 base URL, API 키, 모델 ID만 바꿔 GPT-6, GPT-5.6, o3-pro와 OpenAI 이미지·오디오·임베딩 모델을 LaoZhang API로 호출하는 방법입니다.

공식 OpenAI SDK를 그대로 쓰고 base URL, API 키, 모델 ID만 바꾸면 됩니다. 엔드포인트는 모델에 따라 다릅니다. 예를 들어 `o3-pro` 계열은 Responses만 사용합니다.

| 항목 | 내용 |
| - | - |
| base URL | `https://api.laozhang.ai/v1` |
| API 키 | [토큰 관리](https://api.laozhang.ai/token)에서 만든 LaoZhang API 키(콘솔에서는 '토큰'이라고 부릅니다) |
| 모델 ID | [모델 및 가격](https://docs.laozhang.ai/ko/models.md)의 OpenAI 항목에서 복사하세요 |
| 엔드포인트 | 텍스트 모델은 Chat Completions 또는 Responses, GPT Image는 Images, 음성 모델은 Audio, 임베딩 모델은 Embeddings. 아래 모델과 엔드포인트 절 참고 |
| 가격 | GPT-6과 GPT-5.6은 아래 가격 절, 그 밖의 모델은 [모델 및 가격](https://docs.laozhang.ai/ko/models.md)의 OpenAI 항목 |

## 모델과 엔드포인트

2026년 9월 24일 기준 LaoZhang API 공개 가격표에 있는 OpenAI 모델을 엔드포인트별로 묶었습니다.

| 모델 | 엔드포인트 | 가이드 |
| - | - | - |
| GPT-6: `gpt-6-astra`, `gpt-6-sol`, `gpt-6-luna` | Chat Completions, Responses | [GPT-6 출시 공지](https://docs.laozhang.ai/en/announcements/gpt-6-launch-2026-09.md) |
| GPT-6.1 Sol: `gpt-6.1-sol` | Chat Completions, Responses (도구 호출은 Responses에서만) | [GPT-6.1 Sol 출시 공지](https://docs.laozhang.ai/en/announcements/gpt-6-1-sol-2026-10.md) |
| GPT-5.6: `gpt-5.6-luna`, `gpt-5.6-terra`, `gpt-5.6-sol` | Chat Completions, Responses | [OpenAI 프로토콜](https://docs.laozhang.ai/ko/api-reference/chat-completions.md) |
| GPT-5.4: `gpt-5.4`, `gpt-5.4-mini`, `gpt-5.4-nano`, `gpt-5.4-pro` | Chat Completions, Responses | [OpenAI 프로토콜](https://docs.laozhang.ai/ko/api-reference/chat-completions.md) |
| `o3-pro`, `o3-pro-2025-06-10` | Responses | [API 연동 가이드](https://docs.laozhang.ai/ko/api-manual.md)의 Responses API |
| GPT Image 2.5, GPT Image 2 | Images | [GPT Image 2.5](https://docs.laozhang.ai/ko/api-capabilities/gpt-image-2-5.md), [GPT Image 2](https://docs.laozhang.ai/ko/api-capabilities/gpt-image-2.md) |
| `gpt-4o-transcribe`, `gpt-4o-mini-transcribe` | Audio transcription | [Audio API](https://docs.laozhang.ai/en/api-capabilities/audio-transcription.md) |
| `tts-1`, `tts-1-hd`, `gpt-4o-mini-tts` | Audio speech | [Audio API](https://docs.laozhang.ai/en/api-capabilities/audio-transcription.md) |
| `text-embedding-3-large`, `text-embedding-3-small`, `text-embedding-ada-002` | Embeddings | [Embeddings](https://docs.laozhang.ai/en/api-capabilities/text-embedding.md) |

`gpt-5.5`, `gpt-4.1`, `o4-mini`처럼 카탈로그에 있는 다른 OpenAI 텍스트 모델도 Chat Completions 또는 Responses로 호출할 수 있습니다. 전체 엔드포인트 URL은 다음과 같습니다.

```text theme={null}
Chat Completions   POST https://api.laozhang.ai/v1/chat/completions
Responses          POST https://api.laozhang.ai/v1/responses
이미지 생성        POST https://api.laozhang.ai/v1/images/generations
이미지 편집        POST https://api.laozhang.ai/v1/images/edits
음성 인식          POST https://api.laozhang.ai/v1/audio/transcriptions
음성 합성          POST https://api.laozhang.ai/v1/audio/speech
임베딩             POST https://api.laozhang.ai/v1/embeddings
```

## OpenAI SDK 설정

[토큰 관리](https://api.laozhang.ai/token)에서 과금 방식을 사용량 우선(콘솔 표시: 按量优先, 권장) 또는 사용량 과금(按量计费)으로 설정해 API 키를 만드세요. 같은 키로 `gpt-image-2.5-flare-vip` 같은 건당 과금 이미지 모델도 호출하려면 사용량 우선을 선택합니다. 그런 다음 터미널에서 키를 환경 변수로 설정합니다.

```bash theme={null}
export LAOZHANG_API_KEY="YOUR_LAOZHANG_API_KEY"
```

먼저 SDK를 설치하세요.

* Python: `python -m pip install openai`를 실행합니다.
* Node.js: `npm install openai`를 실행하고, 코드를 `openai-test.mjs`로 저장해 `node openai-test.mjs`로 실행합니다.

다음 예제는 `gpt-5.6-luna`에 메시지 하나를 보냅니다.

> [tab] Python
>
> ```python theme={null}
> import os
> from openai import OpenAI
>
> client = OpenAI(
>     api_key=os.environ["LAOZHANG_API_KEY"],
>     base_url="https://api.laozhang.ai/v1",
>     timeout=120.0,
>     max_retries=0,
> )
> response = client.chat.completions.create(
>     model="gpt-5.6-luna",
>     messages=[{"role": "user", "content": "connected라고만 답하세요"}],
> )
> print(response.choices[0].message.content)
> ```

> [tab] Node.js
>
> ```javascript theme={null}
> import OpenAI from "openai";
>
> const client = new OpenAI({
>   apiKey: process.env.LAOZHANG_API_KEY,
>   baseURL: "https://api.laozhang.ai/v1",
>   timeout: 120_000,
>   maxRetries: 0,
> });
> const response = await client.chat.completions.create({
>   model: "gpt-5.6-luna",
>   messages: [{ role: "user", content: "connected라고만 답하세요" }],
> });
> console.log(response.choices[0].message.content);
> ```

같은 클라이언트로 표의 모든 엔드포인트에 접근할 수 있으며, Python과 Node.js의 메서드 이름은 같습니다.

* 텍스트: `client.chat.completions.create`
* Responses: `client.responses.create`
* 이미지: `client.images.generate`, `client.images.edit`
* 음성 인식: `client.audio.transcriptions.create`
* 음성 합성: `client.audio.speech.create`
* 임베딩: `client.embeddings.create`

base URL이 이미 `/v1`로 끝나며 SDK가 `/chat/completions` 같은 경로를 붙여 줍니다. 직접 붙이면 404가 납니다. 예제는 재시도를 애플리케이션에서 제어할 수 있도록 자동 재시도를 꺼 두었습니다.

SDK를 환경 변수로만 설정하는 애플리케이션이라면 [API 연동 가이드](https://docs.laozhang.ai/ko/api-manual.md)의 기존 OpenAI 앱 옮기기 절에 나온 것처럼 `OPENAI_API_KEY`와 `OPENAI_BASE_URL`을 설정하세요.

## Chat Completions와 Responses 중 선택

* **Chat Completions**: 대부분의 OpenAI 형식 클라이언트가 이 엔드포인트를 쓰므로, `messages` 기반의 기존 코드는 그대로 두고 `choices[0].message.content`에서 답변을 읽습니다. GPT-6의 추론 강도, 샘플링 파라미터, 도구 호출에는 Chat Completions에서 OpenAI가 정한 추가 규칙이 있습니다. [GPT-6 출시 공지](https://docs.laozhang.ai/en/announcements/gpt-6-launch-2026-09.md)를 참고하세요.
* **Responses**: LaoZhang API는 OpenAI의 Responses API를 지원하며, 모든 OpenAI 텍스트 모델에서 쓸 수 있습니다. OpenAI는 [o3-pro를 Responses API에서만](https://developers.openai.com/api/docs/models/o3-pro) 제공하며, `gpt-6-astra`의 도구 호출에도 Responses가 필요합니다. `input`을 보내고 Python SDK에서는 `output_text`를 읽습니다.
* **이미 Responses로 만든 코드**: base URL과 API 키만 LaoZhang API로 바꾸고 나머지는 그대로 두세요. 다른 제공사의 모델로 옮기기 전에는 최소 요청으로 Responses 지원 여부를 확인하세요. [API 연동 가이드](https://docs.laozhang.ai/ko/api-manual.md)의 Responses API 예제가 그 방법을 보여 줍니다.
* **도구와 웹 검색**: [Function calling](https://docs.laozhang.ai/en/api-capabilities/function-calling.md)에서 두 엔드포인트와 모델별 지원 여부를 다룹니다. 웹 검색은 Responses의 `web_search` 도구로만 쓸 수 있습니다. [웹 검색](https://docs.laozhang.ai/en/api-capabilities/web-search.md)을 참고하세요.

OpenAI는 일부 `o3-pro` 요청이 몇 분씩 걸린다고 안내하므로, 아래 예제는 타임아웃을 600초로 잡았습니다.

```python theme={null}
import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["LAOZHANG_API_KEY"],
    base_url="https://api.laozhang.ai/v1",
    timeout=600.0,
    max_retries=0,
)
response = client.responses.create(
    model="o3-pro",
    input="connected라고만 답하세요",
)
print(response.output_text)
```

원본 JSON에서는 `output[]`의 `message` 항목 안에서 `output_text` 콘텐츠 항목의 `text`를 읽으세요. 추론 모델에서는 첫 번째 출력 항목이 답변이 아닐 수 있습니다.

## GPT-6과 GPT-5.6 가격

2026년 9월 24일 기준 LaoZhang API 공개 가격표의 GPT-6 표준 요금이며, 100만 토큰당 USD입니다.

| 모델 | 입력 | 출력 |
| - | -: | -: |
| `gpt-6-astra` | \$10 | \$50 |
| `gpt-6-sol` | \$2 | \$10 |
| `gpt-6-luna` | \$0.1 | \$0.5 |
| `gpt-6.1-sol` | \$2 | \$10 |

캐시와 긴 컨텍스트 요금은 [GPT-6 출시 공지](https://docs.laozhang.ai/en/announcements/gpt-6-launch-2026-09.md)와 [GPT-6.1 Sol 출시 공지](https://docs.laozhang.ai/en/announcements/gpt-6-1-sol-2026-10.md)에 있습니다. `gpt-6.1-sol`은 2026년 10월 5일부터 공개 가격표에 올라 있습니다.

아래는 2026년 9월 24일 기준 GPT-5.6 공개 가격입니다. `default` 토큰 그룹, 입력 272K 토큰 이하 요청에 해당하며 100만 토큰당 USD입니다.

| 모델 | 입력 | 출력 | 캐시 읽기 |
| - | -: | -: | -: |
| `gpt-5.6-luna` | \$0.2 | \$1.2 | \$0.02 |
| `gpt-5.6-terra` | \$2 | \$12 | \$0.2 |
| `gpt-5.6-sol` | \$4 | \$20 | \$0.4 |

* 요청 하나의 입력이 272K 토큰을 넘으면 요청 전체가 더 높은 구간 요금으로 과금됩니다. `gpt-5.6-sol`의 경우 입력 \$8, 출력 \$30, 캐시 읽기 \$0.8입니다. 모든 구간은 모델 카탈로그의 [구간별 가격](https://docs.laozhang.ai/ko/models.md) 표에 있습니다.
* 현재 `gpt-5.6-sol` 가격은 2026년 8월 21일 OpenAI의 가격 인하를 따른 것입니다. OpenAI는 이를 2026년 11월 21일까지 적어도 유지되는 프로모션 가격이라고 설명합니다([OpenAI API changelog](https://developers.openai.com/api/docs/changelog)). LaoZhang API는 2026년 9월 10일에 새 가격을 가격 설정에 반영했으며, [GPT-5.6 Sol 가격 인하 공지](https://docs.laozhang.ai/en/announcements/gpt-5-6-sol-price-cut-2026-09.md)에서 이전 요금과 새 요금을 비교합니다.
* GPT-5.4, `o3-pro`, 오디오·임베딩 모델의 가격은 [모델 및 가격](https://docs.laozhang.ai/ko/models.md)의 OpenAI 항목에 있습니다. GPT Image의 건당 과금과 토큰 과금은 [GPT Image 2.5](https://docs.laozhang.ai/ko/api-capabilities/gpt-image-2-5.md)를 참고하세요.

## OpenAI를 직접 호출할 때와 다른 점

* **API 키**: LaoZhang API [토큰 관리](https://api.laozhang.ai/token)에서 만드세요. OpenAI 플랫폼 키는 LaoZhang API에서 작동하지 않고, LaoZhang API 키도 `api.openai.com`에서 작동하지 않습니다.
* **모델 ID**: 기준은 [모델 및 가격](https://docs.laozhang.ai/ko/models.md)이며, OpenAI 카탈로그의 모든 모델을 쓸 수 있는 것은 아닙니다. `gpt-image-2.5-flare-vip`, `gpt-image-2.5-web` 같은 일부 ID는 OpenAI에는 없는 LaoZhang API 경로 ID입니다.
* **토큰 그룹**: 키의 토큰 그룹이 쓸 수 있는 모델과 경로를 결정합니다.
  * 이 페이지의 텍스트, 오디오, 임베딩 모델은 `default` 그룹에 있습니다.
  * GPT Image에는 `gpt-image-2.5-flare-vip` 같은 건당 과금 모델이 `default`에 있습니다.
  * 공식 API 포워딩은 `OpenAI Official`(구 Sora2Official) 그룹(OpenAI와 같은 가격)과 `OpenAI Official Enterprise`(구 GPTImage2 Sora2 Enterprise) 그룹(OpenAI 가격에 20% 추가)에서 실행되며 토큰으로 과금합니다. [GPT Image 2.5](https://docs.laozhang.ai/ko/api-capabilities/gpt-image-2-5.md)를 참고하세요.
* **과금**: 요금은 카탈로그 가격으로 LaoZhang API 잔액에서 차감되며 OpenAI 계정 크레딧이나 청구서와는 별개입니다. [호출 로그](https://api.laozhang.ai/log)에서 요청별 사용량과 비용을 볼 수 있고, 규칙은 [과금과 가격](https://docs.laozhang.ai/ko/pricing.md)에 정리되어 있습니다.
* **그 밖의 엔드포인트**: Batch, Files, Realtime처럼 표에 없는 엔드포인트가 필요하면 먼저 [hi@laozhang.ai](mailto:hi@laozhang.ai)로 문의하세요.
* **비디오**: OpenAI는 2026년 9월 24일에 Videos API와 `sora-2`, `sora-2-pro`를 API에서 제거했고, LaoZhang API는 2026년 7월 1일에 Sora 2 경로를 중단했습니다. 비디오 생성에는 Wan 2.7 또는 Seedance 2.0을 사용하세요. [Sora 2 API 종료](https://docs.laozhang.ai/ko/api-capabilities/sora2/official-forward.md)를 참고하세요.
* **데이터 처리**: LaoZhang API를 거쳐 보낸 요청에는 LaoZhang API [데이터 정책](https://www.laozhang.ai/data-policy)이 적용됩니다.

## 오류 해결

* **401**: LaoZhang API 키를 쓰고 있는지, 실행 중인 프로세스에 환경 변수가 설정되어 있는지 확인하세요.
* **404 또는 모델 사용 불가**: 전체 모델 ID, 엔드포인트, 토큰 그룹을 확인하세요. 예를 들어 `o3-pro` 요청은 Responses로 보내야 합니다. [모델 사용 가능 여부](https://docs.laozhang.ai/en/faq/model-availability.md)를 참고하세요.
* **400**: 추가한 선택 필드를 빼고 오류 본문에 맞게 요청을 고치세요. 모델마다 받는 파라미터가 다르므로 한 모델의 설정을 다른 모델에 그대로 복사하지 마세요.
* **응답은 오는데 앱에 아무것도 표시되지 않음**: 엔드포인트에 맞는 구조를 파싱하세요. Chat Completions는 `choices`, Responses는 `output`, Images는 `data`입니다.
* **클라이언트 타임아웃**: 요청이 아직 진행 중이거나 이미 끝났을 수 있습니다. 다시 제출하기 전에 [호출 로그](https://docs.laozhang.ai/en/faq/call-logs.md)를 확인하고, SDK와 애플리케이션이 모두 재시도하지 않게 하세요.

## 관련 문서

* [텍스트 생성 API: 프로토콜과 모델](https://docs.laozhang.ai/ko/api-capabilities/text-generation.md)
* [OpenAI 프로토콜: Chat Completions](https://docs.laozhang.ai/ko/api-reference/chat-completions.md)
* [API 연동 가이드](https://docs.laozhang.ai/ko/api-manual.md): Responses, 이미지 생성, 이미지 편집 예제
* [Images API](https://docs.laozhang.ai/ko/api-reference/images.md)
* [Models API](https://docs.laozhang.ai/en/api-reference/models.md)
* OpenAI: [모델](https://developers.openai.com/api/docs/models), [Responses 레퍼런스](https://developers.openai.com/api/reference/resources/responses/methods/create), [Chat Completions 레퍼런스](https://developers.openai.com/api/reference/resources/chat/subresources/completions/methods/create), [지원 중단 안내](https://developers.openai.com/api/docs/deprecations)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.