Youchuan API for Native 2K Stills and Motion

Youchuan API 讓開發者透過單一 Atlas Cloud 金鑰，以程式化方式存取 Youchuan——Midjourney 的官方中國平台。它涵蓋兩個模型世代 V8.1 與 V8.2 的六種生成模式，包括 text-to-image、image-to-image、image-to-video、多圖混合、風格轉換與背景移除。計費採用按次呼叫付費，因此在送出第一個請求前不需要先簽訂訂閱方案。

此系列提供六種模式，且每一種都可在 V8.1 與 V8.2 上使用。Text-to-image、image-to-image 與 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，並支援九種 aspect ratio，從正方形到電影感的 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 image 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 參數，因此解析度與構圖會跟隨輸入影像。由於工作是排隊後輪詢，而不是串流回傳，請在你的流程中建置狀態檢查與重試機制，不要預期會收到同步回應。