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

​

모델과 엔드포인트

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 설정

export LAOZHANG_API_KEY="YOUR_LAOZHANG_API_KEY"

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

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)

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);

• 텍스트: 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

​

Chat Completions와 Responses 중 선택

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

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)

​

GPT-6과 GPT-5.6 가격

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

​

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

• API 키: LaoZhang API 토큰 관리에서 만드세요. OpenAI 플랫폼 키는 LaoZhang API에서 작동하지 않고, LaoZhang API 키도 api.openai.com에서 작동하지 않습니다.
• 모델 ID: 기준은 모델 및 가격이며, 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를 참고하세요.
• 과금: 요금은 카탈로그 가격으로 LaoZhang API 잔액에서 차감되며 OpenAI 계정 크레딧이나 청구서와는 별개입니다. 호출 로그에서 요청별 사용량과 비용을 볼 수 있고, 규칙은 과금과 가격에 정리되어 있습니다.
• 그 밖의 엔드포인트: Batch, Files, Realtime처럼 표에 없는 엔드포인트가 필요하면 먼저 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 종료를 참고하세요.
• 데이터 처리: LaoZhang API를 거쳐 보낸 요청에는 LaoZhang API 데이터 정책이 적용됩니다.

​

오류 해결

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

​

관련 문서

• 텍스트 생성 API: 프로토콜과 모델
• OpenAI 프로토콜: Chat Completions
• API 연동 가이드: Responses, 이미지 생성, 이미지 편집 예제
• Images API
• Models API
• OpenAI: 모델, Responses 레퍼런스, Chat Completions 레퍼런스, 지원 중단 안내