# Sakuranbo AI

> Sakuranbo AI は、テキスト・画像・動画の生成モデルを使う開発者向けの API です。1 つのカタログ、1 つのエラー形式、1 つの前払い USD 残高で、すべてのモデルを扱えます。

主な事実:

- 状態: プレビュー。
- 課金: 前払いの USD 残高。価格は上流の原価にサービスのマージンを加えた額で、入金手数料はありません。失敗・キャンセル・時間切れ・コンテンツポリシーによる拒否の実行は課金されません。チャットでは、モデルが出力（推論の出力を含みます）を生成し始めたあとは、ストリームが途切れても、接続を閉じても、生成した出力が課金されます。最終的な使用量が届かないときは、入力を確保に使った上限で数えます。
- 認証: Authorization: Bearer API キー。モデルの一覧・取得と見積は API キーが不要で、生成には API キーが必要です。
- 言語: 英語、日本語、簡体字中国語、韓国語。

## ドキュメント

- [ドキュメント](https://sakuranbo.ai/ja/docs/): Sakuranbo AI API のガイドとリファレンス: クイックスタート、認証、チャット、画像、動画、ジョブ、webhook、残高とキーの利用上限、モデル、見積、エラー、課金。
- [クイックスタート](https://sakuranbo.ai/ja/docs/quickstart/): アカウントと API キーを作成し、残高を追加して、最初のチャットのリクエストを送り、残高を確認します。
- [認証](https://sakuranbo.ai/ja/docs/authentication/): API キーで Sakuranbo AI API のリクエストを認証する方法、キーが必要なエンドポイント、キーを安全に保つ方法です。
- [チャット](https://sakuranbo.ai/ja/docs/chat/): OpenAI 互換の POST /v1/chat/completions と Anthropic 互換の POST /v1/messages でテキストを生成します: リクエスト、ストリーミング、使用量、エラー。
- [画像](https://sakuranbo.ai/ja/docs/images/): POST /v1/images/generations と POST /v1/images/edits で画像を生成・編集します: 結果の待ち方、非同期ジョブ、出力ファイル、エラー。
- [動画](https://sakuranbo.ai/ja/docs/videos/): POST /v1/videos で動画を生成します: テキスト、最初のフレーム、参照画像の入力、ポーリング、ファイルのダウンロード、キャンセル、エラー。
- [ジョブ](https://sakuranbo.ai/ja/docs/jobs/): 画像と動画の生成ジョブを追跡します: ステータス、ポーリング、一覧、キャンセル、出力ファイル。
- [Webhook](https://sakuranbo.ai/ja/docs/webhooks/): ジョブ、入金、残高不足のイベントを HTTPS のエンドポイントで受け取り、各配信の署名を検証します。
- [残高とキーの利用上限](https://sakuranbo.ai/ja/docs/balance-and-key-limits/): GET /v1/balance と GET /v1/key で前払い残高と API キーの利用上限を読み取り、402 エラーに対処します。
- [モデル API](https://sakuranbo.ai/ja/docs/models-api/): GET /v1/models のリファレンス: モデルの一覧、モダリティやタスクでの絞り込み、1 件の取得。
- [見積 API](https://sakuranbo.ai/ja/docs/estimate-api/): POST /v1/estimate のリファレンス: 実行前にリクエストの料金を計算します。
- [MCP サーバー](https://sakuranbo.ai/ja/docs/mcp/): Claude Code、Cursor、VS Code、Codex から Sakuranbo AI の MCP サーバーに接続し、ドキュメントの検索、モデルの確認、料金の見積、残高と履歴の参照を行います。
- [エラー](https://sakuranbo.ai/ja/docs/errors/): Sakuranbo AI のエラー形式、HTTP ステータス、返されるすべてのエラーコード。
- [料金と課金](https://sakuranbo.ai/ja/docs/pricing-and-billing/): 前払い課金の仕組み: 残高、単価、支払い手段、既定値、課金されないもの。

## モデル

- [CherryText 1.0 Flash](https://sakuranbo.ai/ja/models/sakuranbo/cherrytext-1.0-flash.md): 100 万トークンの文脈長、tool calls、推論に対応した、高速・低価格の言語モデル。 ([llms.txt](https://sakuranbo.ai/ja/models/sakuranbo/cherrytext-1.0-flash/llms.txt))
- [Cherry 1.0 Pro](https://sakuranbo.ai/ja/models/sakuranbo/cherry-1.0-pro.md): 2〜30 秒、1080p・2K・4K の音声付き動画をテキストや画像から生成。 ([llms.txt](https://sakuranbo.ai/ja/models/sakuranbo/cherry-1.0-pro/llms.txt))
- [CherryImage 1.0 Pro](https://sakuranbo.ai/ja/models/sakuranbo/cherryimage-1.0-pro.md): 最大 2K 解像度の高品質な画像生成と、参照画像にもとづく画像編集。 ([llms.txt](https://sakuranbo.ai/ja/models/sakuranbo/cherryimage-1.0-pro/llms.txt))
- [すべてのモデル（HTML）](https://sakuranbo.ai/ja/models/)
- [料金](https://sakuranbo.ai/ja/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/zh/llms.txt)
- [한국어](https://sakuranbo.ai/ko/llms.txt)