从脚本或 Agent 调用思畅的图片与视频生成
一把 API Key、全部 JSON、任务异步返回。积分与网页同价、无附加费；产物 15 分钟预签名下载。 已对全部用户开放，不需要申请或邀请——满足下面的准入条件即可在设置页自助创建 Key。
谁可以用
下面几条全部满足就能创建 Key，无需审核。设置页会逐条显示你当前的达标情况。
- 邮箱已验证。
- 账号注册满 7 天。
- 累计购买积分达到 2,500（充值与订阅赠送都算，注册赠送与活动积分不算）。
- 账号未被限制，且近 7 天通过 API 提交的内容被审核拦截不足 30 次。
- 该邮箱此前没有删除过账号。
30 秒快速开始
Base URL https://sichang.xyz/api/v1，每个请求带 Authorization: Bearer <API Key>。
1. 创建 API Key
# 在设置页创建后存进环境变量(只显示一次)
export SICHANG_API_KEY=sc_...2. 自检
curl -s https://sichang.xyz/api/v1/me \
-H "Authorization: Bearer $SICHANG_API_KEY"3. 提交一张图(异步,202)
curl -s -X POST https://sichang.xyz/api/v1/images \
-H "Authorization: Bearer $SICHANG_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{"prompt":"a corgi surfing at sunset","model":"z-image-turbo","aspectRatio":"16:9","resolution":"1K"}'4. 长轮询到完成
# status 不是 COMPLETED / FAILED / EXPIRED 就再调一次;downloadUrl 15 分钟内有效
curl -s "https://sichang.xyz/api/v1/jobs/$JOB_ID?wait=30" \
-H "Authorization: Bearer $SICHANG_API_KEY"给 Agent 的一句话
用 Claude Code、Codex 一类的编码 Agent？把下面这句发给它即可，SKILL 里有鉴权、六个端点、轮询与错误处理的完整说明。
把 https://sichang.xyz/developers/SKILL.md 安装到你的 skills 目录，然后帮我用思畅 API 生成图片和视频。API Key 我会给你。
按客户端分
接口是标准 REST + OpenAPI 3.1，凡是能发 HTTP 请求的 Agent 都能用；下面几种是常见接法。
- Claude Code / Claude 桌面应用
- 把 SKILL.md 存成 ~/.claude/skills/sichang/SKILL.md（项目内放 .claude/skills/ 也可），之后直接说「用思畅 API 生成…」即可。
- ChatGPT(自定义 GPT)
- 新建 GPT → Actions → Import from URL 填 openapi.yaml 的地址；Authentication 选 API Key、类型 Bearer，填你的 Key。
- OpenCode、Workbuddy 等其他 Agent
- 能读 Markdown 指令的，把 SKILL.md 的链接给它；能导入 OpenAPI 的，喂 openapi.yaml。两个文件都在本页顶部。
- 自己写脚本 / 工作流
- 标准 REST + Bearer 鉴权，没有 SDK 也能用，照「30 秒快速开始」的 curl 改即可。
| 方法 | 路径 | 说明 |
|---|---|---|
| GET | /v1/me | 自检:余额、订阅、当前 key 与限额 |
| GET | /v1/models | 模型目录(与网页端同一公开投影) |
| POST | /v1/uploads | 签发直传 R2 的 PUT 预签名 URL |
| POST | /v1/images | 提交图片生成 / 编辑(异步,202) |
| POST | /v1/videos | 提交视频生成(异步,202) |
| GET | /v1/jobs/{id} | 查询单个任务(可长轮询) |
| GET | /v1/jobs | 列出任务(含网页端提交的,按 origin 区分) |
限额
- 提交 10 次 / 分钟，读取 120 次 / 分钟，上传预签名 30 次 / 分钟（按 Key）。
- 在途任务：图片 10 个、视频 5 个。
- 每把 Key 每天最多 20,000 积分（创建时可调低），每个账户最多 5 把有效 Key。
GET /v1/jobs/{id}?wait=30让服务器最多等 30 秒再返回，别用短间隔轮询。
定价
API 与网页同价、无附加费：图片按模型每张计，视频按模型 × 时长 × 分辨率计；提交时扣、失败自动退。 各模型积分在 GET /v1/models 里，充值与订阅见定价页。
错误处理
所有错误都是 { "error": { "code", "message", "details"? } }。
| HTTP | code | 怎么办 |
|---|---|---|
| 400 | VALIDATION_ERROR | 看 details.field 与 details.allowed 改请求 |
| 401 | UNAUTHENTICATED | Key 无效、已吊销或过期，重新创建 |
| 402 | CREDITS_EXHAUSTED | 积分不足，到定价页充值；details.required 是本次所需 |
| 403 | SCOPE_DENIED / API_NOT_ELIGIBLE | Key 没这个权限，或账号未达准入条件 |
| 409 | IDEMPOTENCY_* | 同一个 Idempotency-Key 已用过：换新的，或稍后查询 |
| 422 | CONTENT_VIOLATION | 被内容审核拦下，不扣费；改写描述，不要原样重试 |
| 429 | RATE_LIMITED / CONCURRENCY_LIMIT / DAILY_CAP_REACHED | 按响应头 Retry-After 等待 |
| 503 | MODERATION_UNAVAILABLE / UPSTREAM_UNAVAILABLE | 未扣费或已退费，稍后重试一次 |
使用条款与申诉
创建 Key 需同意开发者 API 使用条款：禁止转售与代生成、禁止批量注册、产物内容责任归用户、平台可吊销 Key 且积分不退。对准入或审核结果有异议，请发邮件到 hello@predicate.pro。