Youchuan API for Native 2K Stills and Motion

Youchuan API 让开发者通过一个 Atlas Cloud key，以编程方式访问 Youchuan——Midjourney 的官方中国平台。它涵盖 V8.1 和 V8.2 两代模型，共六种生成模式，包括文生图、图生图、图生视频、多图融合、风格迁移和背景移除。计费方式为按次调用即用即付，因此在发起第一个请求前无需签订订阅。

该系列提供六种模式，每种模式都同时支持 V8.1 和 V8.2。文生图、图生图和 blend 每次运行返回四个候选结果；style transfer 会在保留输入构图的同时重新绘制图像；image-to-video 可将静态图像生成四段五秒视频；background removal 返回一张透明背景抠图。blend 单次调用可接受两到五张源图像。

V8.1 于 2026 年 4 月 30 日发布，是该产品线中速度最快的模型，比早期版本大约快四到五倍，并通过 hd 标志引入原生 2K 渲染。V8.2 于 2026 年 7 月 27 日推出，重点提升美学表现与图像质量：渲染效果更大胆、更精致，低质量异常结果出现的频率也大幅降低。两个版本都仍可调用，因此你可以固定使用 V8.1 以保持与现有作品的一致性，也可以切换到 V8.2 获得更新的视觉风格。

创建 Atlas Cloud 账号，生成一个 API key，然后发送请求，并指定所需模式和版本的 model ID，例如 youchuan/v8.2/text-to-image。价格透明，并按次调用收费；Day-0 access 意味着每个新版本一上线即可调用。现在就可以开始构建。

图像模式默认使用 1:1，并支持九种宽高比，从正方形到电影感的 21:9，再到竖向 9:21。将 hd 设置为 true 会生成原生 2K 输出，而不是执行放大处理，费用按基础费率的 1.5x 计费。在动态生成方面，image-to-video 会返回四段五秒视频，可选择 480p 或 720p，并可将 motion 设置为 low 或 high。

由 prompt 驱动的模式提供 Midjourney 用户熟悉的控制项：aspect_ratio、0 到 1000 的 stylize、最高 100 的 chaos、最高 3000 的 weird，以及取值为 1 或 4 的 quality。prompt 最多支持 1024 个字符；可选的 sref 图像 URL 可引导审美风格，但不会决定构图。style transfer 和 background removal 刻意保持更简单：前者接收一张输入图像和一个目标风格 prompt。

生成过程是异步的。调用会返回 request_id，轮询 prediction endpoint 可查看状态，状态值包括 created、processing、completed 或 failed；任务完成后，outputs 数组中会包含结果 URL。如果你更希望直接在响应中接收 payload，而不是获取托管文件，请将 enable_base64_output 设置为 true。

Youchuan API 上大多数模式的价格为每次调用 $0.086，涵盖 text-to-image、image-to-image、blend、background removal 和 image-to-video；style transfer 的价格为每次调用 $0.129。在这些费率之上还有两个倍率：hd 图像按基础费率的 1.5x 计费，720p 视频按 480p 费率的 3x 计费。所有内容都不捆绑到套餐中，因此你只需为实际发起的调用付费。

可以。将 seed 固定为某个特定整数，并使用相同的 prompt 和相同设置，即可精确复现该渲染结果；默认值 -1 则会让每次运行随机化。若要在一组营销素材中保持统一视觉风格，可传入一张 sref 参考图像，保持 stylize 值稳定，只改变 prompt。

输出形态是固定的：视频片段时长为五秒，blend 最多接收五张图像，prompt 最多 1024 个字符。style transfer 不提供 aspect ratio、hd 或 stylize 参数，因此分辨率和画面构图会跟随输入图像。由于任务采用排队和轮询机制，而不是流式返回，请在流水线中构建状态检查和重试逻辑，不要期待同步响应。