开始
概览
思畅 AI 开发者 API 让你用一把 API Key,从脚本、编程 Agent 或聊天客户端调用思畅的模型。文本对话、图片与视频共用一个积分余额,与网页端相同。
三种用法
- 编程 Agent:Claude Code、OpenCode 等直接把思畅当作模型服务商,用支持工具调用的模型读写代码。见接入工具总览。
- 聊天客户端:SillyTavern、Cherry Studio 等选「OpenAI 兼容」连接,接无审查对话模型做角色扮演与创作。见接入工具总览。
- 脚本出图出视频:图片与视频是异步任务,提交后长轮询拿结果,价格与网页同价、失败自动退款。见5 分钟快速开始。
两个 Base URL
| 协议 | Base URL | 用于 |
|---|---|---|
| OpenAI 兼容 | https://sichang.xyz/api/v1 | /chat/completions、图片、视频、任务查询等全部端点 |
| Anthropic 兼容 | https://sichang.xyz/api | Claude Code 等 Anthropic 客户端(客户端会自己拼上 /v1/messages) |
每个请求都带 Authorization: Bearer <API Key>。Key 在设置 → API 创建,条件见 API Key 与准入。
计费一句话
文本对话按 token 计费,输入、缓存命中、输出各有单价;图片按张、视频按时长与分辨率计,与网页同价。细则见计费与积分。
全部端点
| 方法 | 路径 | 说明 |
|---|---|---|
GET | /v1/me | 自检:余额、订阅、当前 key 与限额 |
GET | /v1/models | 模型目录(与网页端同一公开投影) |
POST | /v1/uploads | 签发直传 R2 的 PUT 预签名 URL |
POST | /v1/images | 提交图片生成 / 编辑(异步,202) |
POST | /v1/videos | 提交视频生成(异步,202) |
POST | /v1/chat/completions | 文本对话(OpenAI 兼容) |
POST | /v1/messages | Anthropic Messages 兼容的文本对话(Claude Code) |
POST | /v1/messages/count_tokens | 估算 Anthropic Messages 请求的输入 token 数 |
GET | /v1/jobs/{id} | 查询单个任务(可长轮询) |
GET | /v1/jobs | 列出任务(含网页端提交的,按 origin 区分) |
完整字段定义见 openapi.yaml。