# Sakuranbo AI

> Sakuranbo AI는 텍스트, 이미지, 영상 생성 모델을 사용하는 개발자를 위한 API입니다. 하나의 카탈로그, 하나의 오류 형식, 하나의 선불 USD 잔액으로 모든 모델을 다룹니다.

핵심 사실:

- 상태: 프리뷰.
- 과금: 선불 USD 잔액. 가격은 업스트림 원가에 서비스 마진을 더한 금액이며 충전 수수료는 없습니다. 실패하거나 취소되거나 만료되거나 콘텐츠 정책으로 거부된 실행에는 요금이 청구되지 않습니다. 채팅에서는 모델이 출력(추론 출력 포함)을 생성하기 시작한 뒤에는 스트림이 끊기거나 클라이언트가 연결을 닫아도 생성된 출력이 과금됩니다. 최종 사용량이 도착하지 않으면 입력은 확보에 사용한 상한으로 계산합니다.
- 인증: Authorization: Bearer API 키. 모델 목록·조회와 비용 계산에는 API 키가 필요하지 않고, 생성에는 API 키가 필요합니다.
- 언어: 영어, 일본어, 중국어 간체, 한국어.

## 문서

- [문서](https://sakuranbo.ai/ko/docs/): Sakuranbo AI API의 가이드와 레퍼런스: 빠른 시작, 인증, 채팅, 이미지, 영상, 작업, 웹훅, 잔액과 API 키 사용 한도, 모델, 예상 비용, 오류, 과금.
- [빠른 시작](https://sakuranbo.ai/ko/docs/quickstart/): 계정과 API 키를 만들고, 잔액을 충전하고, 첫 채팅 요청을 보낸 뒤 잔액을 확인합니다.
- [인증](https://sakuranbo.ai/ko/docs/authentication/): API 키로 Sakuranbo AI API 요청을 인증하는 방법, 키가 필요한 엔드포인트, 키를 안전하게 보관하는 방법입니다.
- [채팅](https://sakuranbo.ai/ko/docs/chat/): OpenAI 호환 POST /v1/chat/completions와 Anthropic 호환 POST /v1/messages로 텍스트를 생성합니다: 요청, 스트리밍, 사용량, 오류.
- [이미지](https://sakuranbo.ai/ko/docs/images/): POST /v1/images/generations와 POST /v1/images/edits로 이미지를 생성하고 편집합니다: 결과 대기, 비동기 작업, 출력 파일, 오류.
- [영상](https://sakuranbo.ai/ko/docs/videos/): POST /v1/videos로 영상을 생성합니다: 텍스트, 첫 프레임, 참조 이미지 입력, 폴링, 파일 다운로드, 취소, 오류.
- [작업](https://sakuranbo.ai/ko/docs/jobs/): 이미지와 영상 생성 작업을 추적합니다: 상태, 폴링, 목록 조회, 취소, 출력 파일.
- [웹훅](https://sakuranbo.ai/ko/docs/webhooks/): 작업, 입금, 잔액 부족 이벤트를 HTTPS 엔드포인트로 받고, 전송마다 서명을 검증합니다.
- [잔액과 API 키 사용 한도](https://sakuranbo.ai/ko/docs/balance-and-key-limits/): GET /v1/balance와 GET /v1/key로 선불 잔액과 API 키의 사용 한도를 확인하고, 402 오류에 대응합니다.
- [모델 API](https://sakuranbo.ai/ko/docs/models-api/): GET /v1/models 레퍼런스: 모델 목록 조회, 모달리티나 작업으로 필터링, 단일 모델 조회.
- [비용 계산 API](https://sakuranbo.ai/ko/docs/estimate-api/): POST /v1/estimate 레퍼런스: 실행 전에 요청 비용을 계산합니다.
- [MCP 서버](https://sakuranbo.ai/ko/docs/mcp/): Claude Code, Cursor, VS Code, Codex를 Sakuranbo AI의 MCP 서버에 연결해 문서 검색, 모델 조회, 비용 계산, 잔액과 이용 내역 조회를 할 수 있습니다.
- [오류](https://sakuranbo.ai/ko/docs/errors/): Sakuranbo AI의 오류 형식, HTTP 상태 코드, 반환되는 모든 오류 코드.
- [요금과 과금](https://sakuranbo.ai/ko/docs/pricing-and-billing/): 선불 과금 방식: 잔액, 단가, 결제 수단, 기본값, 과금되지 않는 경우.

## 모델

- [CherryText 1.0 Flash](https://sakuranbo.ai/ko/models/sakuranbo/cherrytext-1.0-flash.md): 100만 토큰 컨텍스트, 도구 호출, 추론을 지원하는 빠르고 저렴한 언어 모델. ([llms.txt](https://sakuranbo.ai/ko/models/sakuranbo/cherrytext-1.0-flash/llms.txt))
- [Cherry 1.0 Pro](https://sakuranbo.ai/ko/models/sakuranbo/cherry-1.0-pro.md): 텍스트나 이미지로 2~30초, 1080p·2K·4K의 오디오 포함 영상을 생성. ([llms.txt](https://sakuranbo.ai/ko/models/sakuranbo/cherry-1.0-pro/llms.txt))
- [CherryImage 1.0 Pro](https://sakuranbo.ai/ko/models/sakuranbo/cherryimage-1.0-pro.md): 최대 2K 해상도의 고품질 텍스트-이미지 생성과 참조 이미지 기반 편집. ([llms.txt](https://sakuranbo.ai/ko/models/sakuranbo/cherryimage-1.0-pro/llms.txt))
- [모든 모델(HTML)](https://sakuranbo.ai/ko/models/)
- [요금](https://sakuranbo.ai/ko/pricing/)

## 기계 판독용

- [OpenAPI 정의](https://api.sakuranbo.ai/openapi.json)
- [API 카탈로그](https://api.sakuranbo.ai/.well-known/api-catalog)
- [API 레퍼런스(HTML)](https://api.sakuranbo.ai/reference)
- MCP 서버(Streamable HTTP, 읽기 전용): https://api.sakuranbo.ai/mcp

## 다른 언어

- [English](https://sakuranbo.ai/llms.txt)
- [日本語](https://sakuranbo.ai/ja/llms.txt)
- [简体中文](https://sakuranbo.ai/zh/llms.txt)