# Sakuranbo AI

> Sakuranbo AI 是面向开发者的文本、图像和视频生成模型 API。一个目录、一种错误格式和一份预付 USD 余额即可覆盖所有模型。

关键信息:

- 状态：预览。
- 计费：预付 USD 余额。价格为上游成本加服务加价，不收取充值手续费。失败、已取消、已过期以及被内容政策拒绝的运行不计费。对于对话，模型开始生成输出（包括推理输出）后，即使流中断或客户端关闭连接，也会对已生成的输出计费。最终用量未送达时，输入按预留时使用的上限计算。
- 认证：Authorization: Bearer API 密钥。列出和获取模型以及费用预估无需 API 密钥，生成需要 API 密钥。
- 语言：英语、日语、简体中文、韩语。

## 文档

- [文档](https://sakuranbo.ai/zh/docs/): Sakuranbo AI API 的指南与参考：快速开始、认证、对话、图像、视频、任务、Webhook、余额与 API 密钥限额、模型、费用预估、错误和计费。
- [快速开始](https://sakuranbo.ai/zh/docs/quickstart/): 创建账户和 API 密钥，充值，发送第一个对话请求，并查看余额。
- [认证](https://sakuranbo.ai/zh/docs/authentication/): 如何使用 API 密钥认证 Sakuranbo AI API 请求、哪些端点需要密钥，以及如何妥善保管密钥。
- [对话](https://sakuranbo.ai/zh/docs/chat/): 使用兼容 OpenAI 的 POST /v1/chat/completions 和兼容 Anthropic 的 POST /v1/messages 生成文本：请求、流式输出、用量和错误。
- [图像](https://sakuranbo.ai/zh/docs/images/): 使用 POST /v1/images/generations 和 POST /v1/images/edits 生成和编辑图像：等待结果、异步任务、输出文件和错误。
- [视频](https://sakuranbo.ai/zh/docs/videos/): 使用 POST /v1/videos 生成视频：文本、首帧和参考图像输入，轮询、下载文件、取消和错误。
- [任务](https://sakuranbo.ai/zh/docs/jobs/): 跟踪图像和视频生成任务：状态、轮询、列出、取消和输出文件。
- [Webhook](https://sakuranbo.ai/zh/docs/webhooks/): 在你的 HTTPS 端点接收任务、充值和低余额事件，并验证每次推送的签名。
- [余额与 API 密钥限额](https://sakuranbo.ai/zh/docs/balance-and-key-limits/): 使用 GET /v1/balance 和 GET /v1/key 读取预付余额和 API 密钥的支出上限，并处理 402 错误。
- [模型 API](https://sakuranbo.ai/zh/docs/models-api/): GET /v1/models 参考：列出模型、按模态或任务筛选、读取单个模型。
- [费用预估 API](https://sakuranbo.ai/zh/docs/estimate-api/): POST /v1/estimate 参考：在运行前计算请求的费用。
- [MCP 服务器](https://sakuranbo.ai/zh/docs/mcp/): 将 Claude Code、Cursor、VS Code 和 Codex 连接到 Sakuranbo AI 的 MCP 服务器，即可搜索文档、查看模型、预估费用，并读取余额和历史记录。
- [错误](https://sakuranbo.ai/zh/docs/errors/): Sakuranbo AI 的错误格式、HTTP 状态码以及返回的所有错误代码。
- [定价与计费](https://sakuranbo.ai/zh/docs/pricing-and-billing/): 预付计费的运作方式：余额、单价、支付方式、默认值，以及不计费的情形。

## 模型

- [CherryText 1.0 Flash](https://sakuranbo.ai/zh/models/sakuranbo/cherrytext-1.0-flash.md): 支持 100 万 token 上下文、工具调用和推理的高速、低成本语言模型。 ([llms.txt](https://sakuranbo.ai/zh/models/sakuranbo/cherrytext-1.0-flash/llms.txt))
- [Cherry 1.0 Pro](https://sakuranbo.ai/zh/models/sakuranbo/cherry-1.0-pro.md): 根据文本或图像生成 2 至 30 秒、1080p、2K 或 4K 的带音频视频。 ([llms.txt](https://sakuranbo.ai/zh/models/sakuranbo/cherry-1.0-pro/llms.txt))
- [CherryImage 1.0 Pro](https://sakuranbo.ai/zh/models/sakuranbo/cherryimage-1.0-pro.md): 最高 2K 分辨率的高保真文生图，以及基于参考图的图像编辑。 ([llms.txt](https://sakuranbo.ai/zh/models/sakuranbo/cherryimage-1.0-pro/llms.txt))
- [全部模型（HTML）](https://sakuranbo.ai/zh/models/)
- [定价](https://sakuranbo.ai/zh/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/ko/llms.txt)