https://api.laozhang.ai/v1을 쓰고, Google Gen AI SDK와 Anthropic SDK는 호스트 루트를 쓰며 나머지 경로는 SDK가 붙입니다.
세 도메인은 같은 API 키, 경로, 파라미터를 받으므로 바꿔도 호스트 이름만 달라집니다. 콘솔도 세 도메인 모두에서 열립니다. 애플리케이션이 이미 쓰는 요청 형식을 고른 다음, API 키의 그룹이 호출할 수 있는 모델을 선택하세요.
API 키 발급
토큰 관리에서 API 키를 만듭니다. 만들 때 그룹과 과금 방식을 선택하며, 그룹에 따라 키가 호출할 수 있는 모델이 정해집니다. 과금 방식은 사용량 우선(콘솔 표시: 按量优先, 권장)을 선택하세요. 이 방식의 키는 아래 예제에서 쓰는 사용량 과금 텍스트 모델과 호출당 과금 이미지 모델을 모두 호출할 수 있습니다. 두 설정은 과금, 토큰 그룹, 인보이스에서 자세히 설명합니다. 예제를 실행할 터미널에서 키를 환경 변수로 설정합니다.YOUR_LAOZHANG_API_KEY는 발급받은 키로 바꾸세요. 키는 서버에만 두고, 브라우저 번들, 소스 저장소, 로그에는 남기지 마세요. 계정 관리용 AccessToken은 별개의 인증 정보이며 잔액 조회 API 같은 계정 엔드포인트에서만 씁니다.
예제에서 사용하는 모델은 다음과 같습니다.
- 텍스트:
gpt-5.4-mini - Gemini 네이티브 요청:
gemini-3.8-flash - Anthropic Messages:
glm-5.2 - 이미지 생성:
gpt-image-2.5-flare-vip, 이미지 편집:gpt-image-2.5-sunburst-vip
텍스트 요청 보내기
Chat Completions는messages 배열을 받습니다. API 키를 Bearer 토큰으로 보내고 본문은 JSON으로 작성합니다.
choices[0].message.content에 들어 있고, 이 프롬프트라면 connected가 나옵니다. 같은 요청을 애플리케이션에서 쓰려면 메시지 내용만 원하는 프롬프트로 바꾸면 됩니다. 메시지 필드, 스트리밍, 모델별 옵션은 OpenAI 프로토콜 레퍼런스에서 다룹니다.
OpenAI SDK
OpenAI SDK가 엔드포인트 경로를 직접 만들기 때문에, base URL은/chat/completions 없이 https://api.laozhang.ai/v1까지만 지정합니다.
- Python
- Node.js
SDK를 설치합니다.
o3-pro, GPT Image, 음성 모델을 포함해 LaoZhang API에서 OpenAI 모델 사용하기에 정리되어 있습니다.
기존 OpenAI 앱 옮기기
이미 OpenAI SDK를 쓰는 애플리케이션은 세 가지만 바꾸면 됩니다. 클라이언트의 API 키와 base URL(아래 diff 참고), 그리고 각 요청의model 값입니다. 나머지 요청 코드는 그대로 둡니다.
OPENAI_API_KEY와 OPENAI_BASE_URL을 읽습니다.
- 모델 ID: OpenAI에서 쓰던 모델 이름이 LaoZhang API에서는 ID나 그룹이 다를 수 있습니다. 정확한 ID는 모델 및 가격에서 복사하세요. OpenAI를 직접 호출할 때와 다른 점은 OpenAI 모델 가이드에 정리되어 있습니다.
- 선택 파라미터: 샘플링 옵션, 출력 길이 제한, 구조화된 출력, 도구 설정은 모델마다 다릅니다. 필수 필드만으로 시작해서 필요한 옵션을 하나씩 추가하세요. 지원하지 않는 파라미터라는 오류가 오면 오류가 가리키는 필드를 빼거나 조정합니다.
- 재시도: 재시도 로직은 한 곳에서만 관리하세요. SDK와 애플리케이션이 모두 재시도하면 사용자 동작 한 번에 API 호출이 여러 번 일어날 수 있습니다.
- 결과 확인: 위의 최소 요청을 보낸 뒤 호출 로그에서 해당 요청을 찾아 모델, 토큰 사용량, 청구 금액을 확인하세요.
Responses API
Responses API는 요청에input을 넣고 output 배열을 반환합니다. 요청 본문이 Chat Completions와 다르므로, 전환하는 애플리케이션은 요청과 응답 파서를 모두 고쳐야 합니다.
- cURL
- Python
output 배열 안에서 타입이 output_text인 콘텐츠 항목의 text 값을 모으면 됩니다. SDK의 output_text 헬퍼가 이 작업을 대신해 줍니다. 다른 출력 항목에는 추론 내용이나 도구 호출이 들어 있을 수 있으므로, 첫 번째 항목이 곧 텍스트 답변이라고 가정하면 안 됩니다.
LaoZhang API는 OpenAI의 Responses API를 지원하므로 GPT-6, GPT-5.6, GPT-5.4, o3-pro 같은 OpenAI 텍스트 모델에서 사용할 수 있습니다. 다른 제공사의 모델을 이 엔드포인트로 옮기기 전에는 최소 요청을 보내 동작을 확인하세요.
서버 측 대화 상태, previous_response_id, 내장 도구도 모델에 따라 지원 여부가 다릅니다. 대화 기록이 필요하면 다음 요청에 필요한 메시지를 애플리케이션에서 직접 보관하세요. 업스트림 필드 정의는 OpenAI Responses 레퍼런스에, 데이터 처리는 데이터 정책에 있습니다.
이미지 생성 및 편집
두 Images 엔드포인트 모두data 배열을 반환합니다. 모델에 따라 각 항목에는 이미지가 b64_json에 Base64로 들어 있거나 url에 다운로드 링크로 들어 있습니다.
예제는 GPT Image 2.5 VIP 모델을 사용합니다. 이 모델은 호출당 과금이고, 앞의 텍스트 예제는 사용량 과금입니다. 사용량 우선으로 설정한 키는 둘 다 호출할 수 있습니다. 이미지 요청이 거부되면 키의 과금 방식이 사용량 우선(按量优先) 또는 건당 과금(按次计费)인지 확인하세요.
이미지 생성
생성 엔드포인트에 JSON으로 프롬프트를 보냅니다.이미지 편집
현재 디렉터리에input.png라는 참조 이미지를 두고, 편집 지시문과 함께 multipart form 데이터로 업로드합니다.
@ 문법은 파일 내용을 업로드합니다. multipart 콘텐츠 타입과 boundary는 cURL이 설정하도록 두고, 이 요청에는 Content-Type: application/json을 추가하지 마세요.
결과 저장
응답 파일은 이미지가 아니라 JSON입니다. 아래 스크립트를save_images.py로 저장하세요. Python 표준 라이브러리만 사용합니다.
data에 있는 모든 이미지를 generation-1.png 같은 이름으로 저장하며, 다음 경우를 처리합니다.
data:image/...;base64,접두사가 붙어 있거나 끝의=패딩이 빠진 Base64url결과: API 키 없이 내려받습니다. URL 결과는 바로 저장하고 직접 사본을 보관하세요.
Gemini 네이티브 API 호출
Gemini 네이티브 API는 OpenAI의 messages 대신contents[].parts[] 구조를 씁니다.
candidates[].content.parts[]의 text 파트에서 읽습니다. 텍스트가 없으면 finishReason과 promptFeedback을 확인하세요.
Google Gen AI SDK에서는 호스트 루트 https://api.laozhang.ai와 api_version="v1beta"를 지정합니다. 모델 경로와 API 키 헤더는 SDK가 추가합니다. Gemini 프로토콜 레퍼런스에 전체 Python 예제, 두 가지 인증 헤더 방식, 이미지·PDF·오디오 입력 방법이 있습니다. MP4 영상의 프레임과 오디오를 분석하려면 비디오 이해 API를 보세요.
Anthropic Messages API 호출
Anthropic SDK를 비롯해 Anthropic Messages 형식으로 만든 애플리케이션은/v1/messages로 요청을 보냅니다.
- 필수 필드:
model,messages,max_tokens - 시스템 프롬프트:
messages가 아니라 최상위system필드에 넣습니다. - 응답:
content배열에는text,thinking,tool_use블록이 들어갈 수 있습니다. - 답변 텍스트: 첫 번째 블록이 답변이라고 가정하지 말고,
type이text인 블록을 읽습니다.
- 2026년 10월 18일부터 다시 제공되는 Claude 모델(
claude-sonnet-5-5,claude-opus-5-5등). Anthropic 자체 API와 다른 점은 Claude 모델 제한을 참고하세요. glm-5.2:default토큰 그룹에서 쓸 수 있으며, Anthropic 자체 Messages API의 동작과 매우 가깝습니다.deepseek-v4-pro,deepseek-v4-flash도 이 엔드포인트용으로 표시되어 있습니다.
base_url="https://api.laozhang.ai"와 LaoZhang API 키를 지정합니다. /v1/messages는 SDK가 붙입니다. SDK 사용법, 스트리밍, 도구 호출은 Claude 프로토콜 레퍼런스에서 다룹니다.
그 밖의 API
- Models API: 애플리케이션에서 쓸 모델 ID 조회
- 임베딩: 텍스트를 벡터로 변환
- 오디오 전사: 오디오를 업로드하고 전사 텍스트 받기
오류 해결
잘못된 요청은 고친 뒤에 재시도하세요. 일시적인 장애에는 횟수를 제한한 백오프를 쓰고, SDK 재시도와 애플리케이션 재시도가 겹치지 않게 하세요.
클라이언트 타임아웃이 나도 생성이 취소되는 것은 아니며, 과금 여부도 알 수 없습니다. 이미지 요청을 다시 보내기 전에 호출 로그를 확인하세요.
문의는 hi@laozhang.ai 또는 Telegram @laozhang_cn으로 보내 주세요. 요청 시각, 모델, 엔드포인트, 토큰 그룹, 민감 정보를 가린 오류 내용을 함께 알려 주시면 됩니다. 과금과 환불은 이용약관을 따릅니다.
AI 코딩 도구에서 이 문서 사용하기
코딩 어시스턴트에게 대상 모델, 작업 내용, 그리고 아래 파일 중 하나를 알려 주세요.- skill.md: 코딩 어시스턴트용 연결 규칙과 최소 요청 모음(영어)
- llms.txt와 llms-full.txt: 문서의 페이지 색인과 전체 텍스트 내보내기. 현재 둘 다 중국어 문서 기준
API 레퍼런스
LaoZhang API 레퍼런스입니다.- 텍스트 생성 API: 프로토콜과 모델 선택
- OpenAI 모델: 엔드포인트와 SDK 설정
- OpenAI 프로토콜: Chat Completions
- Claude 프로토콜: Anthropic Messages
- Gemini 프로토콜: generateContent
- Images API: 이미지 생성 및 편집
- Models API
- OpenAI: API reference, Chat Completions, Responses, models
- Anthropic: Messages API
- Google: Gemini API 문서, generateContent 레퍼런스