最新完整调用合同、各服务剩余额度与不可用原因见 统一素材调用说明。

创作者 API：报价、任务与素材

能力与真实状态 · Playground · 生成历史 · 我的素材 · API Keys · OpenAPI

云端提供素材服务，本地工具继续负责工程、时间线与整片渲染。新增能力有独立的代码、配置、真实验收和商业开放标记；实现 adapter 不代表已经开通。以 /api/v1/capabilities 的 models 为准。新供应商默认关闭，P2 的识别、声音复刻、数字人和支付尚未开放。

一次生成

  1. POST /api/v1/quotes：提交 capability、model、结构化 input，取得十分钟报价。报价本身不生成、不扣点。
  2. POST /api/v1/generations：发送报价返回的标准化 input、quote_id 和 max_credits；必须带 Idempotency-Key。同一用户同一键异输入返回409，同一请求重放返回原任务。
  3. GET /api/v1/tasks/{id}：轮询任务。只有通过校验、成功保存的实际结果才结算，部分图片按实际张数计费。查询、重取文件不重新生成。
  4. GET /api/v1/tasks/{id}/receipt：核对报价版本、原额度桶、预占、实际扣点、释放与退款。result_assets 包含真实规格。
  5. 使用 GET /api/v1/assets/{ast_id}/download 取本人媒体，可用 Range。API Key 始终放在授权头中。
{
  "capability": "images.generate",
  "model": "native-image",
  "input": { "prompt": "抽象几何背景", "size": "1024x1024", "count": 1 }
}

可用参数以目录中的模型限制为准。未知参数、未支持的尺寸、音色、参考或 seed 会被拒绝。native-image 沿用现有图像服务；旧 POST /api/v1/images 保留同步响应和数字素材 URL，内部使用相同报价、任务与账务流程。旧同步请求也可带幂等键重放已完成结果。

模型目录的 price_options 列出已配置价格。视频可按480p、720p、1080p分别定价，此时旧字段 price 为null，不能把最低档当作通用售价。请求报价按标准化后的分辨率选择档位，未指定时默认720p；必须提交报价返回的 input 和版本。页面会逐档展示价格，TEST标记仅表示测试价。新价格不改变已确认报价的扣点上限或成本版本。

额度、取消与失败

积分是平台使用额度，可用余额来自充值购买、已解锁的消费奖励和历史账本记录；月度、注册、验证邮箱、访问或提交点子不赠分。充值或购买模板，本人与符合条件的邀请人各获实付金额对应积分的 5%（1 元对应 10 积分，向下取整）。支付后显示待解锁金额和预计日期；实际支付满 14 天、验证邮箱且无退款或异常，支付渠道核验成功后到账。退款停止或扣回奖励，历史订单不补发。充值可用性以实际支付配置为准。预占只减少一次可花余额，不等于已扣点；历史免费积分的释放不恢复免费额度。新旧调用读取同一余额，避免双花。

所有点数为整数。图片按可交付张数；标准配音按标准化输入的 Unicode 码点计数，包含标点、内部空白，首尾空白在报价前移除，每100字符向上取整；P1 视频采用明确配置的固定时长合同。供应商实际 token、媒体规格与原币种成本分开记录，未知成本为未记录，不是零。报价是用户扣点上限，不能静默超扣。

取消 API 同时校验 usage.read 与任务对应的生成/模型权限；只读 Key 不能改变任务状态。排队任务可直接取消并释放。提交后取消只是请求，供应商继续执行时仍可能按报价结算。reconciling 表示提交结果或交付状态待核对，预占保留；不自动重发付费请求。没有上游查询标识时需要管理员根据供应商证据处理，不能声称跨网络完全 exactly-once。

用户可以在 Playground 明确创建新任务。它会重新报价并产生新操作，不能把它当成免费重试。已撤销 Key 停止新提交且不能下载；有效账户仍能从个人页面查看自己的记录与素材。已有任务的合法对账不会因撤销 Key 被抹去。

Key、素材与来源

Key 可以选择 scopes、有效期、单次/每日/月度预算及模型白名单。历史 Key 仅保留贴纸、生图、制作登记、本人素材读取和用量查询；视频、配音、外部搜索及上传需明确选择。撤销是终态，到期不能通过重新启用绕过。明文仅创建时显示，私密页面不缓存。

模型白名单同时约束生成、素材搜索与选用；网页试用使用所选Key的相同限制。旧贴纸搜索、匹配和下载也检查 local-stickers 模型权限，不能通过旧入口绕过白名单。本人素材读取仍由 assets.read 和所有者权限保护。

GET /api/v1/search 支持 image/video/music/sfx/sticker，搜索来源是白名单，不接受任意 URL。结果的 source_ref 绑定用户、十分钟有效；POST /api/v1/assets/select 需要该引用和 purpose=local_creation。Pixabay 搜索缓存24小时，选用后按来源策略获取；Unsplash 选用记录下载事件且只保留 hotlink 引用；Pexels 保留醒目来源与作者署名。结果提供作者主页 author_url 和来源平台 provider_url；Unsplash 链接保留应用归因参数。source_specs 是原素材规格，actual_specs 是所选版本规格，未知时为空；下载选用后以实际媒体探测结果为准。Pixabay 不支持 square 或视频方向筛选，传入时明确拒绝。素材用于创作，不提供图库转售保证。

现有贴纸通过 kind=sticker&provider=local 检索；许可未知时明确返回 unknown。下载仍使用 GET /api/v1/stickers/{preset} 和 stickers.file 权限，每次成功取文件扣1点，重复取文件仍计费；生成素材的重复下载则不重复扣点。贴纸不自动转入个人素材库，也不补造许可证据。

BGM/SFX 只使用商业使用、改编、独立再分发均有证据允许的服务端清单。未知、NC、ND 或证据缺失素材不进入白名单。第三方搜索结果的权利状态不会因为“搜索到了”变成可商用保证。

背景音乐提供按类型、情绪、风格和实际时长筛选的多首候选，以及认证试听、完整下载和私人素材选用。详见 背景音乐 API 调用说明；搜索、试听、选用、下载目前均为0点，实时状态以 licensed-music 模型目录为准。

生成、上传和选用的个人媒体默认保留30天；上传会话十分钟有效，最大32MB，图片最大16MB。字节校验、真实尺寸/时长、SHA-256 和 owner 权限通过后才成为 ready。删除/过期停止媒体访问，保留必要收据和不可逆摘要。活跃任务的输入用于执行；完成七天后清除任务原文，报价仅持久化输入指纹。

历史与限制

/api/v1/tasks、/requests、/transactions、/assets 均为本人分页，单页最多50条；支持的过滤字段见 OpenAPI。个人页面可导出最近1000条账务 CSV，服务端校验所有者并处理公式注入。旧记录保留在 API Keys 页面，不补造未知模型和上游成本。

HTTP 限速、账号任务上限、每个供应商单并发、供应商每日积分预算和上传限额共同保护服务。新供应商还需明确的启用名单、凭据、授权、真实验收与版本化价格全部通过。没有配置时返回 disabled/price_pending/rights_pending，不返回模拟成功。

接口实现参考 Ark 图像接口、Ark 视频接口、标准 TTS 接口、Pexels 文档、Pixabay 文档 和 Unsplash 文档。正式账号的协议、费率及对外提供服务资格须在启用时再次核定。