API 文档

所有接口均为 HTTPS + JSON。请求与响应使用 UTF-8 编码；除GET 外，请求体为 JSON 对象。

服务地址

https://www.yuanxiangai.cc

版本

v1

认证方式

请求头 Authorization: Bearer <API_KEY>

在「API 密钥」页创建密钥，明文只在创建时显示一次，请立即保存到服务端配置中。 密钥只能放在服务端，禁止写入前端代码、客户端包或代码仓库。

Authorization: Bearer sk-********************************

密钥泄露后请立刻在「API 密钥」页停用，并新建一把。

1. 在「API 密钥」页创建密钥并妥善保存；
2. 调用 POST /v1/files 上传参考素材（可选）；
3. 调用 POST /v1/videos 提交任务，拿到任务 id；
4. 轮询 GET /v1/videos/{id} 直到状态为 succeeded；
5. 用任务响应里的 video_url 直接下载成片。

以视频生成为例（图片 / 语音 / 对话见下方接口列表）：

POST https://www.yuanxiangai.cc/v1/videos
Content-Type: application/json
Authorization: Bearer <API_KEY>

{
  "model": "seedance-2-5-pro",
  "prompt": "城市夜景，镜头缓慢推进",
  "duration": 5,
  "resolution": "720p",
  "ratio": "16:9"
}

{
  "id": "task_8f3c1a2b",
  "object": "video",
  "status": "queued",
  "created_at": "2026-11-03T10:00:00Z"
}

GET https://www.yuanxiangai.cc/v1/videos/{id}
Authorization: Bearer <API_KEY>

queued

排队中

running

生成中

succeeded

已完成，响应里带可取件的地址

failed

失败，费用已退回

任务成功后，响应里的 video_url / data[].url自带签名，在有效期内直接 GET 即可，无需再带请求头；也兼容带密钥访问。

下表是你账号的实时结算价，与调用时实际扣费一致。价格为人民币元。

模型 id 与调用参数见「接口」一节；如需更多模型或调整价格，请联系商务。

• 提交任务时按模型价格预扣，任务成功后按实际用量结算；
• 任务失败或超时，预扣金额原路退回；
• 余额不足时提交会被拒绝（insufficient_credits），请先充值；
• 同一模型可能有多条线路，各线路价格可能不同，以实际扣费为准。