CanSeeDream Developer API

鉴权

视频 API Key 以 sk_live_ 开头，在视频生成页面创建，只允许调用视频 API。

图片 API Key 以 sk_img_ 开头，在图片生成页面创建，只允许调用图片 API。

Authorization: Bearer sk_live_xxx
Authorization: Bearer sk_img_xxx

创建视频生成任务

POSThttps://canseedream.com/api/v3/contents/generations/tasks

curl -X POST 'https://canseedream.com/api/v3/contents/generations/tasks' \
  -H 'Authorization: Bearer sk_live_xxx' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: video-request-001' \
  -d '{
    "model": "seedance-2.0-reference",
    "content": [
      {
        "type": "text",
        "text": "生成一个 10s 的 9:16 竖屏短视频，电影感，动作连贯，画面清晰"
      },
      {
        "type": "image_url",
        "image_url": {
          "url": "https://example.com/reference.png"
        }
      }
    ],
    "provider_route": "可用线路名称",
    "aspect_ratio": "9:16",
    "generate_audio": true,
    "number_of_runs": 1
  }'

视频 API 会按照 provider_route 选择线路；不传时使用服务器默认线路。可用线路、清晰度、时长和参考素材限制会跟随 VIDEO_PROVIDER_ENABLED 与线路环境变量变化。

当前开放线路

正在读取服务器线路配置...

创建图片生成任务

POSThttps://canseedream.com/api/v3/images/generations/tasks

文生图

curl -X POST 'https://canseedream.com/api/v3/images/generations/tasks' \
  -H 'Authorization: Bearer sk_img_xxx' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: image-request-001' \
  -d '{
    "model": "GPT Image 2",
    "prompt": "生成一张橘猫道长，国风电影感，高清细节",
    "size": "1024x1024",
    "quality": "auto",
    "n": 1
  }'

图生图

{
  "prompt": "参考 @Image1，保持主体身份，将服装改成紫色道袍，电影感柔光",
  "images": [
    "https://example.com/person.png",
    "https://example.com/cloth.png"
  ],
  "size": "1024x1024",
  "quality": "auto",
  "n": 1
}

没有传参考图时自动走文生图；传入参考图时自动走图生图。参考图顺序对应提示词里的 @Image1、@Image2。

直接传入画布图片

如果你的画布或应用里已经有 base64 图片，可以把 data URL 放进 images、image_url 或 content。服务端会先把图片素材接入统一任务链，再提交生成。

{
  "prompt": "把画布中的人物改成水彩插画风格",
  "images": [
    {
      "data_url": "data:image/png;base64,iVBORw0KGgo..."
    }
  ],
  "size": "1024x1024",
  "quality": "auto",
  "n": 1
}

查询任务

视频任务

GEThttps://canseedream.com/api/v3/contents/generations/tasks/cstask_xxx

curl 'https://canseedream.com/api/v3/contents/generations/tasks/cstask_xxx' \
  -H 'Authorization: Bearer sk_live_xxx'

图片任务

GEThttps://canseedream.com/api/v3/images/generations/tasks/cstask_xxx

curl 'https://canseedream.com/api/v3/images/generations/tasks/cstask_xxx' \
  -H 'Authorization: Bearer sk_img_xxx'

任务完成后，视频结果在 content.video_url，图片结果在 content.image_url；备用链接分别在 backup_video_url、backup_image_url。

列表查询

GEThttps://canseedream.com/api/v3/contents/generations/tasks?limit=20

GEThttps://canseedream.com/api/v3/images/generations/tasks?limit=20

积分同步

网页生成和 API 生成共用同一个任务队列，也共用同一个账户积分钱包。

视频 SK 只能调用视频接口，图片 SK 只能调用图片接口；权限隔离，但都消耗账户统一积分。

每个 SK 可以设置独立积分上限，提交时会同时检查账户剩余积分和 SK 剩余积分，避免并发绕过余额。

任务成功后扣减冻结积分；可返还失败会释放冻结积分；内容安全、版权、肖像等内容类失败按产品规则扣除积分。

相同 Idempotency-Key 会返回已有任务，避免客户端重试造成重复扣积分。

参数限制

视频：参考图最多 9 张，音频最多 3 个，视频参考最多 3 个，素材累计最多 10 个。

视频：参考音频累计时长不超过 14 秒，单次最多 4 个 run。

图片：参考图最多 16 张，单次最多生成 8 张。

图片：质量只开放 auto 和 medium；页面展示为“正常”和“优秀”。

图片：4K、优秀质量、参考图 9 张及以上会按页面规则增加积分消耗。

请在服务端保存和调用 SK，不要把 SK 放进浏览器、小程序前端或公开仓库。