모든 WideRouter 작업은 이미지를 생성하든 동영상을 생성하든, 어떤 모델을 선택하든 관계없이 항상 동일한 세 단계를 따릅니다.
API 키 받기
콘솔에서 키를 생성한 다음 내보내면 아래 예제에서 해당 키를 읽을 수 있습니다.
커밋하는 파일에 키를 직접 입력하지 마십시오.
작업 생성
호출은 약 1초 후 작업 ID를 반환하며, 생성은 백그라운드에서 계속 진행됩니다.
완료될 때까지 폴링
status이 터미널 상태인 completed 또는 failed에 도달할 때까지 작업을 읽습니다.
1K 이미지의 경우 처음부터 끝까지 15~40초가 걸릴 것으로 예상됩니다. 완료된 작업에는 이미지 URL의
outputs 배열이 포함됩니다.
촘촘한 루프가 아니라 백오프를 사용하여 폴링합니다. 처음에는 2~3초 정도로 시작합니다. 100ms마다 폴링하는 클라이언트는 더 빠르게 완료되지도 않으면서 요청 제한에 걸립니다.
결과 다운로드
출력 URL은 인증되지 않으며 작업이 생성된 후 24시간이 지나면 만료되므로,
보관하려는 항목은 모두 자체 저장소에 복사하시기 바랍니다.
다운로드할 때 User-Agent 헤더를 전송하시기 바랍니다. 전달 CDN은 User-Agent이 없는
요청과 기본 Python-urllib/3.x 요청에 만료된 링크처럼 보이지만 실제로는 만료되지 않은
일반 403을 반환합니다.
다음 단계
비동기 작업 API
전체 요청 및 응답 스키마, 콜백 및 오류 표입니다.
Nano Banana 시리즈
각 모델이 허용하는 매개변수와 기본값입니다.