Youchuan API for Native 2K Stills and Motion

Youchuan API는 단일 Atlas Cloud 키로 Midjourney의 공식 중국 플랫폼인 Youchuan에 프로그래밍 방식으로 접근할 수 있게 해줍니다. V8.1과 V8.2 두 모델 세대에 걸쳐 text-to-image, image-to-image, image-to-video, multi-image blending, style transfer, background removal 등 6가지 생성 모드를 지원합니다. 과금은 호출당 종량제이므로, 첫 요청 전에 구독을 신청할 필요가 없습니다.

이 제품군에는 6가지 모드가 포함되어 있으며, 각 모드는 V8.1과 V8.2 모두에서 사용할 수 있습니다. Text-to-image, image-to-image, blend는 실행당 4개의 후보 결과를 반환하고, style transfer는 입력의 구도를 유지한 채 다시 그리며, image-to-video는 정지 이미지를 5초짜리 클립 4개로 애니메이션화하고, background removal은 투명 배경의 컷아웃 1개를 반환합니다. Blend는 한 번의 호출에서 2~5개의 소스 이미지를 받을 수 있습니다.

V8.1은 2026년 4월 30일 라인업에서 가장 빠른 모델로 출시되었으며, 이전 버전보다 대략 4~5배 빠르고 hd 플래그를 통한 네이티브 2K 렌더링을 도입했습니다. V8.2는 2026년 7월 27일에 이어 출시되었고, 미학과 이미지 품질이 개선되었습니다. 렌더링은 더 대담하고 세련된 방향으로 바뀌었으며, 저품질 이상 결과가 훨씬 덜 자주 나타납니다. 두 버전 모두 계속 호출할 수 있으므로, 기존 작업과의 일관성이 필요하면 V8.1에 고정하거나 더 새로운 룩을 원하면 V8.2로 이동할 수 있습니다.

Atlas Cloud 계정을 만들고 API 키 하나를 생성한 다음, 원하는 모드와 버전에 해당하는 모델 ID(예: youchuan/v8.2/text-to-image)를 지정해 요청을 보내면 됩니다. 요금은 투명하게 공개되어 있으며 호출당 과금됩니다. Day-0 access를 통해 새 버전이 출시되는 즉시 호출할 수 있습니다. 지금 바로 빌드를 시작하세요.

이미지 모드는 기본값이 1:1이며, 정사각형부터 시네마틱 21:9와 세로형 9:21까지 9가지 화면비를 지원합니다. hd를 true로 설정하면 업스케일링 패스가 아니라 네이티브 2K 출력을 생성하며, 기본 요금의 1.5x로 과금됩니다. 모션 측면에서는 image-to-video가 480p 또는 720p로 5초짜리 클립 4개를 반환하며, motion은 low 또는 high로 설정할 수 있습니다.

프롬프트 기반 모드는 Midjourney 사용자가 이미 알고 있는 제어 옵션을 제공합니다. aspect_ratio, 0~1000 범위의 stylize, 최대 100의 chaos, 최대 3000의 weird, 그리고 1 또는 4로 설정하는 quality를 사용할 수 있습니다. 프롬프트는 최대 1024자까지 입력할 수 있으며, 선택 사항인 sref 이미지 URL로 구도를 강제하지 않고도 미적 방향을 유도할 수 있습니다. Style transfer와 background removal은 의도적으로 더 단순하며, 전자는 입력 이미지와 대상 스타일 프롬프트를 받습니다.

생성은 비동기 방식입니다. 호출은 request_id를 반환하며, prediction endpoint를 폴링하면 상태가 created, processing, completed, failed 중 하나로 보고됩니다. 작업이 완료되면 outputs 배열에 결과 URL이 들어갑니다. 호스팅된 파일을 가져오는 대신 페이로드를 인라인으로 받고 싶다면 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를 특정 정수로 고정하면 동일한 프롬프트와 동일한 설정으로 해당 렌더링을 정확히 재현할 수 있습니다. 반면 기본값인 -1은 실행할 때마다 무작위화합니다. 캠페인 전반에서 공통된 룩을 유지하려면 sref 참조 이미지 하나와 일정한 stylize 값을 전달하고, 프롬프트만 변경하세요.

출력 형태는 고정되어 있습니다. 클립 길이는 5초이고, blend는 최대 5개의 이미지를 받으며, 프롬프트는 1024자에서 잘립니다. Style transfer는 aspect ratio, hd, stylize 파라미터를 제공하지 않으므로 해상도와 프레이밍은 입력 이미지를 따릅니다. 작업은 스트리밍되지 않고 큐에 들어간 뒤 폴링되는 방식이므로, 동기 응답을 기대하기보다는 파이프라인에 상태 확인과 재시도를 포함하세요.