API 문서

퀵스타트

curl · Python · Node.js 로 첫 요청 보내기.

Base URL

모든 요청의 기준 URL 과 /v1 경로 규칙, 요청 타임아웃.

인증

API 키 발급과 Bearer 헤더, 키별 한도·스코프.

모델 선택과 접근 정책

모델 ID, 기능 확인, 라우팅과 계정·조직의 접근 정책.

POST채팅 응답 생성

/v1/chat/completions

OpenAI 호환 채팅 완성. 스트리밍·도구 호출·구조화 출력 지원.

POST메시지 생성

/v1/messages

Anthropic Messages 호환 엔드포인트와 무과금 토큰 카운트.

POST응답 생성

/v1/responses

Responses 형식의 응답 생성과 비동기 작업.

POST이미지 생성

/v1/images/generations

이미지 생성. n 은 최대 10.

POST이미지 편집

/v1/images/edits

이미지 편집(인페인팅·아웃페인팅). multipart 와 JSON(base64) 모두 지원.

POST비디오 생성

/v1/videos/generations

비디오 생성(초당 과금). 제출 후 전용 폴링 엔드포인트로 결과를 받습니다.

GET모델 목록 조회

/v1/models

모델 목록과 개별 모델 조회. 슬래시 포함 slug 지원.

GET결과 다시 받기

/v1/outputs/{requestId}

요청 ID로 결과를 다시 조회하고 10분 유효한 URL을 발급받습니다.

스트리밍

토큰 단위 응답, SSE 종료·오류 처리와 최종 사용량.

프롬프트 캐싱

반복되는 앞부분을 캐시해 입력 비용 절감 — 켜기 전 비용 조건 확인.

비동기 작업

Responses background 잡과 비디오 생성 폴링을 한 흐름으로.

웹 검색

모델이 직접 웹 검색을 실행합니다 — 모델별 검색 과금과 응답 출처 확인.

Claude Code / Anthropic SDK

ANTHROPIC_BASE_URL 로 붙이는 anthropic-native 연동.

Cursor

OpenAI Base URL 오버라이드로 연동.

opencode

openai-compatible provider 설정 예시.

Continue / Cline / 기타 OpenAI 호환 도구

provider=openai + base URL 오버라이드 공통 패턴.

에러 형식 & 레이트리밋

OpenAI 호환 error envelope, 상태코드 표, 레이트리밋 헤더.

호환 편의 기능

모델명 prefix 생략, 비용 헤더, Idempotency-Key, 엔드포인트별 제약.