API 문서

퀵스타트

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

Base URL

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

인증

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

모델 선택과 접근 정책

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

엔드포인트08

/v1/chat/completions

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

/v1/messages

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

/v1/responses

OpenAI Responses 호환 shim, background 잡 폴링·취소 포함.

/v1/images/generations

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

/v1/images/edits

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

/v1/videos/generations

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

GET

/v1/models

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

GET

/v1/outputs/{requestId}

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

가이드05

스트리밍

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

프롬프트 캐싱

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

비동기 작업

Responses background · 비디오 생성 폴링 · 웹훅 대안을 한 흐름으로.

Imagen 모델 주의사항

Imagen 계열의 장수 제한과 편집 전용 모델 구분.

웹 검색

모델이 직접 웹 검색을 실행합니다 — Google은 검색 쿼리당, Z.AI는 검색 요청당 과금.

도구 연동04

Claude Code / Anthropic SDK

ANTHROPIC_BASE_URL 로 붙이는 anthropic-native 연동.

Cursor

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

opencode

openai-compatible provider 설정 예시.