콘텐츠로 이동

문서

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

Sakuranbo AI는 OpenAI SDK로 사용할 수 있습니다. OpenAI API를 호출하는 기존 코드로 Sakuranbo AI를 사용해 보려면 기본 URL을 https://api.sakuranbo.ai/v1로, API 키를 Sakuranbo AI 키로 바꾸세요. model에는 예시처럼 Sakuranbo AI의 모델 ID를 지정합니다.

터미널 창
curl -X POST "https://api.sakuranbo.ai/v1/chat/completions" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $SAKURANBO_API_KEY" \
-d '{
"model": "sakuranbo/cherrytext-1.0-flash",
"messages": [
{
"role": "system",
"content": "You are a concise assistant."
},
{
"role": "user",
"content": "Summarize the benefits of prepaid API credits in two lines."
}
],
"max_tokens": 2048
}'

TypeScript와 Python 예시는 공식 OpenAI SDK를 사용합니다. 예시는 API 키를 환경 변수 SAKURANBO_API_KEY에서 읽고, 모델 sakuranbo/cherrytext-1.0-flash를 사용합니다. 키를 만드는 방법은 빠른 시작을 참고하세요. Anthropic SDK와 채팅의 다른 기능은 채팅을 참고하세요.

  • 빠른 시작: 계정과 API 키를 만들고, 잔액을 충전하고, 첫 채팅 요청을 보냅니다.
  • 인증: API 키로 요청을 인증하는 방법입니다.
  • 채팅: OpenAI 호환 엔드포인트와 Anthropic 호환 엔드포인트로 텍스트를 생성합니다(스트리밍 포함).
  • 이미지: 이미지를 생성하고 편집합니다.
  • 영상: 텍스트, 첫 프레임, 참조 이미지로 영상을 생성합니다.
  • 작업: 이미지와 영상 작업을 추적하고, 목록을 조회하고, 취소합니다.
  • 웹훅: 작업, 입금, 잔액 부족 이벤트를 받고 서명을 검증합니다.
  • 잔액과 API 키 사용 한도: 잔액과 API 키의 사용 한도를 확인합니다.
  • 모델 API: GET /v1/models와 GET /v1/models/{vendor}/{model}입니다.
  • 비용 계산 API: POST /v1/estimate입니다.
  • 오류: 오류 형식, HTTP 상태 코드, 모든 오류 코드입니다.
  • 요금과 과금: 선불 잔액, 충전, 단가, 과금되지 않는 경우입니다.
  • MCP 서버: 코딩 에이전트로 문서 검색, 모델 조회, 비용 계산, 잔액과 이용 내역 조회를 합니다.