Creative Reasoning 模型服务平台

视频生成返回任务 ID。提交后查询同一任务，完成后读取视频下载链接。

准备 API Key

在 API Key 页面创建或复制完整 API Key，将 API_KEY 替换为密钥。不要使用 Key 前缀或 API Key ID。以下请求使用生产 API https://api.creative-reasoning.com。

提交视频任务

curl -X POST 'https://api.creative-reasoning.com/unified/v1/videos/tasks' \
  -H 'Authorization: Bearer API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "model": "creative-reasoning-video-1.0",
  "content": [
    {
      "type": "text",
      "text": "海边日落，镜头缓慢向前推进"
    }
  ],
  "duration": 4,
  "resolution": "480p",
  "aspect_ratio": "16:9"
}'

首次受理返回 HTTP 202。下面是响应结构示例，ID 为示意值。保存实际响应的 id；pending 表示等待执行，还没有生成结果。

{
  "id": "01a09ec9-7d00-7000-8000-000000000001",
  "status": "pending",
  "created_at": 1789370400,
  "model": "creative-reasoning-video-1.0",
  "poll_url": "/unified/v1/tasks/01a09ec9-7d00-7000-8000-000000000001"
}

查询并读取结果

用响应中的 id 替换 TASK_ID_FROM_SUBMIT_RESPONSE，并使用提交时的同一 API Key：

curl 'https://api.creative-reasoning.com/unified/v1/tasks/TASK_ID_FROM_SUBMIT_RESPONSE' \
  -H 'Authorization: Bearer API_KEY'

查询返回 HTTP 200 时，仍需判断 status。pending、processing 表示继续等待，可每隔 5 秒查询一次并设置总等待上限；到期后保留 ID，稍后继续查询。failed 表示生成失败，读取 error.code 和 error.message。只有 completed 才读取 data。

下面是完成响应的结构示例，媒体内容及 URL 凭证均为占位值：

{
  "id": "01a09ec9-7d00-7000-8000-000000000001",
  "status": "completed",
  "created_at": 1789370400,
  "model": "creative-reasoning-video-1.0",
  "completed_at": 1789370460,
  "data": [
    {
      "type": "video",
      "url": "https://api.creative-reasoning.com/_cr/v1/media/video/01a09ec9-7d00-7000-8000-000000000001/OPAQUE_VIDEO_TOKEN"
    }
  ]
}

使用 data[].url 的完整链接播放或下载，不要解析或重新拼接 URL。OPAQUE_VIDEO_TOKEN 为示意值。真实视频链接自生成起最多有效 24 小时，源文件提前过期时也会提前失效；下载不需要附加 API Key。链接本身包含访问凭证，请及时保存到自己的存储。

使用首帧或参考图

选择 creative-reasoning-video-1.0-i2v，并在 content 中加入首帧图片。示例使用公开示例图片，实际接入时换成你自己的可访问 URL：

curl -X POST 'https://api.creative-reasoning.com/unified/v1/videos/tasks' \
  -H 'Authorization: Bearer API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "model": "creative-reasoning-video-1.0-i2v",
  "content": [
    {
      "type": "text",
      "text": "白色长毛猫在绿色草地上缓慢向镜头走来，尾巴轻轻摆动，阳光柔和，固定镜头，保持图片中猫的外观。"
    },
    {
      "type": "image_url",
      "image_url": {
        "url": "https://cdn.translate.alibaba.com/r/wanx-demo-1.png"
      },
      "role": "first_frame"
    }
  ],
  "duration": 4,
  "resolution": "480p",
  "aspect_ratio": "16:9"
}'

改用参考图引导时，将 model 改为 creative-reasoning-video-1.0-r2v，图片 role 改为 reference_image。这两种请求都按上面的提交、查询和结果处理流程完成。首帧、尾帧和参考图的数量及格式见视频模型参数。

调整视频参数

这三个模型的 duration 接受 4–15 秒整数；resolution 可使用 480p、720p、1080p；aspect_ratio 支持横屏、竖屏、方形及自动比例。完整取值、默认值和模型差异见参数表。输入素材类型由模型决定，不能只更改模型名称后照搬全部媒体输入。实际宽高、时长与声音状态从结果字段读取，缺失时不要用请求值代替。

回调与失败恢复

可在提交正文顶层添加自己的 HTTPS callback_url。收到的终态与查询结果相同；以任务 id 去重。地址约束和重投规则见回调说明。
需要安全重试提交时，添加 Idempotency-Key: YOUR_UNIQUE_OPERATION_ID。这是调用方为本次业务操作生成并保存的唯一编号，不是密钥。相同操作重试必须复用该编号和原请求正文。
已有任务 ID 时查询原任务。没有幂等键且提交超时时，不要盲目重发 POST，以免重复生成和计费。
401 检查 API Key；404 查询时检查 ID 和是否使用原 Key；failed 读取错误原因；410 task_expired 表示结果正文已过期。完整恢复规则见任务错误与幂等提交。

兼容接口

已有接入可继续使用 /unified/v1/videos/generations；该接口也返回异步任务，查询路径与本页不同。详情见视频兼容接口。新旧提交接口不共享幂等键。

图片与视频 Skill

需要让 Claude Code 或 Codex 用自然语言生成、编辑图片和视频时，安装 cr-media Skill。该指南包含插件与 npx skills 安装、升级、API Key 配置，以及本地参考图和 URL 的使用限制。

生成视频