CanSeeDream Developer API

Authorization: Bearer sk_live_xxx
Authorization: Bearer sk_img_xxx

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": "video",
    "provider_route": "tc_pool",
    "duration": 10,
    "prompt": "生成一段 10 秒视频。使用 @Image1 作为主体参考，电影感，动作连贯，画面清晰。",
    "image_urls": ["https://example.com/reference.png"],
    "audio_urls": [
      { "url": "https://example.com/reference.mp3", "durationSeconds": 8 }
    ],
    "video_urls": [
      { "url": "https://example.com/reference.mp4", "durationSeconds": 6 }
    ],
    "aspect_ratio": "9:16",
    "generate_audio": true,
    "number_of_runs": 1
  }'

当前开放线路

{
  "prompt": "生成一段自然风景视频",
  "duration": 4,
  "resolution": "480p",
  "aspect_ratio": "16:9"
}

请求头使用 Authorization: Bearer sk_live_你的密钥 和 Content-Type: application/json。参考素材仍使用现有 images、audio_urls、video_urls 等字段；参考顺序和编号规则不变。2.5 时长为 4–30 秒，实际开放模型由服务端配置。

{
  "enhance": true,
  "enhance_settings": {
    "targetResolution": "1080p",
    "targetFps": "source"
  }
}

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",
    "background": "opaque",
    "n": 1
  }'

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

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

最近任务列表：对对应创建地址发送 GET，可加 ?limit=20。这些是异步接口，不是通用 /v1/images/generations 的 Nano 同步替代入口。

请求参数

专属路径可省略 model。当前 Nano 接入固定使用 quality=auto、background=opaque、output_format=png，这三个字段不提供自定义控制。

当前服务端配置

curl -sS 'https://canseedream.com/nano2/api/v3/images/generations/tasks' \
  -H 'Authorization: Bearer sk_img_xxx' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: nano2-text-001' \
  -d '{
    "prompt": "生成一张橘猫道长，国风电影感，柔和自然光",
    "resolution": "2K",
    "aspect_ratio": "1:1",
    "n": 1
  }'

curl -sS 'https://canseedream.com/nano2pro/api/v3/images/generations/tasks' \
  -H 'Authorization: Bearer sk_img_xxx' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: nano2pro-edit-001' \
  -d '{
    "prompt": "参考 @Image1 保持人物外观，参考 @Image2 的服装，生成电影海报",
    "images": ["https://example.com/person.png", "https://example.com/clothes.png"],
    "resolution": "2K",
    "aspect_ratio": "9:16",
    "n": 1
  }'

替换示例 SK 与图片 URL 后使用。两种模型都支持文生图与图生图，只需替换路径；每次新生成请更换幂等键。多图优先 URL，请求体大小默认32 MiB，受服务器配置限制。

{
  "id": "cstask_example",
  "object": "image.generation",
  "request_id": "csreq_example",
  "provider_route": "nano2pro",
  "status": "queued",
  "tasks": [{
    "id": "cstask_example",
    "model": "nano2pro",
    "provider_route": "nano2pro",
    "status": "queued",
    "progress": 0,
    "content": null,
    "error": null
  }],
  "idempotent": false
}

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

将 cstask_example 换成提交返回的任务 ID。Nano2 则使用 /nano2/…。建议每5–10秒查询一次。

提交时冻结积分，最终消费或退还以服务端结算规则为准。幂等重放返回 idempotent: true；不要跨 SK 或线路复用幂等键。查询错误先重试查询。收到429应退避，413应缩小请求体；需要长期保存时及时下载结果，不自行拼接图片 URL。

专属接口与兼容地址

参数

异步文生图与查询

curl -X POST 'https://canseedream.com/gptimg-2.5/api/v3/images/generations/tasks' \
  -H 'Authorization: Bearer sk_img_xxx' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: gpt25-text-001' \
  -d '{
    "model": "gptimg-2.5",
    "prompt": "生成一张茶杯产品图，柔和光线，简洁背景",
    "variant": "Flare",
    "quality": "low",
    "image_size": "landscape_4_3",
    "background": "opaque",
    "output_format": "png",
    "n": 1
  }'

curl 'https://canseedream.com/gptimg-2.5/api/v3/images/generations/tasks/cstask_替换为返回的任务ID' \
  -H 'Authorization: Bearer sk_img_xxx'

异步响应沿用原图片任务格式：status: succeeded 时读取 content.image_url；失败查看 error。查询必须属于当前用户及图片 SK。

同步图生图（可选遮罩）

curl -X POST 'https://canseedream.com/gptimg-2.5/v1/images/edits' \
  -H 'Authorization: Bearer sk_img_xxx' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: gpt25-edit-001' \
  -d '{
    "model": "gptimg-2.5",
    "prompt": "参考 @Image1，将遮罩标记区域编辑为柔和的摄影棚背景",
    "image_urls": ["https://example.com/reference.png"],
    "mask": "https://example.com/mask.png",
    "variant": "Flare",
    "quality": "low",
    "image_size": "auto",
    "background": "opaque",
    "output_format": "png",
    "response_format": "url",
    "n": 1
  }'

curl -X POST 'https://canseedream.com/gptimg-2.5/v1/images/edits' \
  -H 'Authorization: Bearer sk_img_xxx' \
  -H 'Idempotency-Key: gpt25-file-edit-001' \
  -F 'model=gptimg-2.5' \
  -F 'prompt=参考图片编辑遮罩标记区域，保持主体一致' \
  -F 'image[]=@./reference.png' \
  -F 'mask=@./mask.png' \
  -F 'variant=Flare' \
  -F 'quality=low' \
  -F 'image_size=auto' \
  -F 'output_format=png' \
  -F 'n=1'

独立计费

下面仅是初始预设，每张图片的平台售价，不是上游成本，也不是固定承诺。实际价格和开放档位以服务器配置／图片页面预计积分为准；新模型不沿用旧 img-2 的质量倍率。

画布接入配置

接口格式：OpenAI 兼容
Base URL：https://canseedream.com
API Key：sk_img_xxx
Model ID：gpt-image-2

文生图

curl -X POST 'https://canseedream.com/v1/images/generations' \
  -H 'Authorization: Bearer sk_img_xxx' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: image-sync-001' \
  -d '{
    "model": "gpt-image-2",
    "prompt": "白色背景上的红色马克杯，干净的产品摄影",
    "size": "auto",
    "quality": "auto",
    "response_format": "url",
    "n": 1
  }'

图生图

curl -X POST 'https://canseedream.com/v1/images/edits' \
  -H 'Authorization: Bearer sk_img_xxx' \
  -H 'Idempotency-Key: image-edit-sync-001' \
  -F 'model=gpt-image-2' \
  -F 'prompt=保留主体，将背景替换为专业摄影棚' \
  -F 'quality=high' \
  -F '[email protected]' \
  -F '[email protected]' \
  -F 'response_format=url'

curl -X POST 'https://canseedream.com/v1/images/edits' \
  -H 'Authorization: Bearer sk_img_xxx' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: image-edit-url-sync-001' \
  -d '{
    "model": "gpt-image-2",
    "prompt": "保留 @Image1 的主体，参考 @Image2 的服装风格",
    "image_urls": [
      "https://example.com/reference-1.png",
      "https://example.com/reference-2.jpg"
    ],
    "size": "auto",
    "quality": "auto",
    "response_format": "url",
    "n": 1
  }'

curl -X POST 'https://canseedream.com/v1/images/edits' \
  -H 'Authorization: Bearer sk_img_xxx' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: image-edit-base64-001' \
  -d '{
    "model": "gpt-image-2",
    "prompt": "保留主体，将背景替换为专业摄影棚",
    "image_base64": "data:image/png;base64,iVBORw0KGgo...",
    "size": "auto",
    "quality": "auto",
    "response_format": "url"
  }'

curl -X POST 'https://canseedream.com/v1/images/edits' \
  -H 'Authorization: Bearer sk_img_xxx' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: image-edit-multi-base64-001' \
  -d '{
    "model": "gpt-image-2",
    "prompt": "保留 @Image1 的主体，参考 @Image2 的服装风格",
    "image_base64s": [
      "data:image/png;base64,iVBORw0KGgo...",
      "data:image/jpeg;base64,/9j/4AAQSkZJRg..."
    ],
    "size": "auto",
    "quality": "auto",
    "response_format": "url",
    "n": 1
  }'

{
  "created": 1784592000,
  "data": [
    { "url": "https://canseedream.com/api/local-results/image/123?token=..." }
  ]
}

视频任务

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

图片任务

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