​
选择接口

API 参考分为“账号中心”“智能任务”“大模型”和“海外社媒”。请以具体接口页展示的请求方法、完整地址、参数和返回说明为准。

​
选择请求方法和路径

请直接复制具体接口页显示的 HTTP 方法和完整地址，不要根据接口名称猜测 GET 或 POST。

​
发送参数

  • GET 请求通过 query 参数传值。
  • POST、PUT、PATCH 等请求通过 JSON body 传值，并设置 Content-Type: application/json。
  • 所有普通鉴权业务接口都在 X-Legacy-Token 中携带 Token。
  • 两个 /v1/* 大模型对话接口例外：仅服务端使用 Authorization: Bearer APP_SECRET，浏览器 Playground 已关闭。
  • 时间字段若要求 ISO 8601，应带明确时区，例如 2026-09-01T10:00:00+08:00。
  • 素材 URL 必须能被平台服务直接访问，不能依赖当前浏览器登录态。

​
请求前检查

  • 使用 API 参考页指定的 HTTP 方法和完整路径。
  • POST JSON 已设置 Content-Type: application/json。
  • Token 只放在 X-Legacy-Token 请求头。
  • 必填参数、类型、枚举、长度和 URL 格式符合接口页说明。
  • 创建类请求已考虑超时后的结果不确定性，避免无条件自动重放。

​
处理响应

接口页会展示返回字段与成功、错误示例。示例中的 ID、URL、时间和 Token 均为演示值，不表示线上资源。 客户端按以下顺序判断：
  1. HTTP 是否成功；非 2xx 先按传输或服务器错误处理。
  2. JSON success 是否为 true；为 false 时读取 code、message 和 requestId。
  3. 智能任务再判断 data.status；创建成功不等于任务完成。
  4. 海外社媒再判断帖子或评论的字符串状态，直到进入终态。
异步智能任务和海外社媒状态也可以通过 Webhook 接收。配置、验签、确认与重试规则见配置与接收 Webhook。

​
超时与重试

  • 查询类请求可在网络超时或限流后退避重试。
  • 创建任务、发帖、评论等可能产生资源或费用的请求，在未确认幂等语义前不要自动重放。
  • 收到 10001 时应指数退避并加入随机抖动。
  • 收到 10104 或 1001 时先获取新 Token，再重试原业务请求。
  • 遇到结果不确定状态，优先查询已有任务或资源；仍无法确认时携带 requestId 联系支持。