인증
API 키를 만들어 요청마다 보내고, 권한 범위와 엔드포인트를 이해하세요.
API 키
콘솔에서 이름과 만료 기간(만료 없음 포함)을 지정해 키를 생성하세요. 새 키에는 모든 표준 API 권한이 포함되며 로그인 후 다시 볼 수 있습니다. 키를 클라이언트 코드나 공개 저장소에 절대 넣지 마세요.
| 권한 | 허용 작업 |
|---|---|
jobs:create | 작업 제출 |
jobs:read | 작업 폴링 및 목록 |
media:write | 입력 이미지 또는 동영상 업로드 |
media:read | 결과 파일 다운로드 |
usage:read | 크레딧 및 내역 읽기 |
chat:create | Call chat completions |
키 보내기
키 전송 방식: Authorization: Bearer <key> 또는 x-api-key: <key> — 둘 다 사용하지 마세요. 웹 콘솔과 Playground는 로그인된 세션을 사용합니다.
키가 없거나 유효하지 않으면 401 AUTH_REQUIRED, 필요한 권한이 없는 키는 403 INSUFFICIENT_SCOPE를 반환합니다.
엔드포인트
| 메서드 | 경로 | 용도 | 인증 |
|---|---|---|---|
GET | /api/v1/models | 공개 모델 카탈로그 목록 | 공개 |
GET | /api/v1/models/{slug} | 입력 스키마를 포함한 모델 하나 | 공개 |
GET | /api/v1/prices | 설정된 작업당 가격(USD 마이크로 단위) | 공개 |
POST | /api/v1/media | 이미지 또는 동영상 바이트를 업로드하고 media:<uuid> 반환 | media:write |
POST | /api/v1/jobs | 비동기 모델 작업 하나 제출 | jobs:create |
GET | /api/v1/jobs/{id} | 작업 하나의 상태와 결과 폴링 | jobs:read |
GET | /api/v1/jobs | 최근 100개 작업 | jobs:read |
GET | /api/v1/results/{id} | 소유한 결과 파일 다운로드 | media:read |
GET | /api/v1/usage | 크레딧 잔액 및 최근 내역 | usage:read |
GET | /api/v1/chat/models | Callable chat models with token prices (OpenAI list format) | 공개 |
POST | /api/v1/chat/completions | OpenAI-compatible chat completion, billed per token | chat:create |
GET | /api/v1/chat/requests | Your chat requests with charges, limit (1–100) and before cursor | usage:read |
GET | /api/v1/chat/requests/{id} | One chat request belonging to your account | usage:read |
AI 에이전트
AI 에이전트는 키 대신 MCP 서버를 통해 OAuth로 로그인할 수 있습니다. MCP 및 Skill