CDAPI DOCS
打开工坊

AIGC WORKSHOP

从选择可用模型到下载生成结果

工坊只展示当前用户分组真实可用的图片和视频模型。任务提交、状态轮询、结果预览与下载集中在同一条链路。

最短使用流程

  1. 登录后打开AIGC 工坊。
  2. 选择图片或视频任务，再选择当前分组可用模型。
  3. 填写提示词、尺寸、时长、分辨率或参考素材。
  4. 提交任务并在任务记录等待最终状态。
  5. 任务成功后预览并下载自己的图片或视频。

模型和分组来自实时能力目录

直接答案

工坊不应靠模型名硬编码展示。模型必须声明图片或视频能力、存在当前用户可用分组且有启用渠道，才会进入选择器。

图片实时目录与视频实时目录提供相同的公开能力与报价依据。

图片生成

普通图片请求使用 OpenAI 兼容资源路径 /v1/images/generations。长响应建议使用 https://api-direct.ai.bycomet.cc/v1，避免中间代理超时。

  • 普通 Key 选择模型真实支持的作图分组。
  • 智能 Key 使用 smart:gpt-image，仅在 GPT作图与 AzGPT作图间路由。
  • 输出 URL 或平台保存地址会关联到当前用户任务记录。

视频与多参考素材

视频属于长任务，使用 Direct API。Seedance 智能分组为 smart:seedance-video。模型支持的时长、比例和分辨率以工坊控件和实时目录为准。

多参考素材结构
{
  "prompt": "参考我的@图片 1，使用@音频 1的声音说话",
  "duration": 15,
  "ratio": "16:9",
  "resolution": "720p",
  "references": [
    {"media_type":"image","role":"reference_image","url":"YOUR_PUBLIC_IMAGE_URL","alias":"图片 1"},
    {"media_type":"audio","role":"reference_audio","url":"YOUR_PUBLIC_AUDIO_URL","alias":"音频 1"}
  ]
}

提示词中的 @别名 必须与 references 中的 alias 一致。素材 URL 必须可由生成服务访问。

任务记录与下载

图片和视频任务至少保留 24 小时的可查看记录。用户只能查看和下载自己账户生成的结果；公开资源地址不等于可以枚举其他用户任务。

下载建议

生成成功后尽快下载长期需要的成品。平台记录用于任务恢复和短期取回，不应替代用户自己的长期素材库。

API 调用与成功信号

任务Base URL资源路径
图片https://api-direct.ai.bycomet.cc/v1/v1/images/generations
视频https://api-direct.ai.bycomet.cc/v1/v1/videos

成功信号是任务记录出现最终成功状态、结果可预览/下载，并在使用日志中存在对应 Request ID 与扣费。