메인 콘텐츠로 건너뛰기
이미지와 영상은 만드는 데 시간이 걸려서, 요청하면 작업을 먼저 받고 결과는 나중에 조회해요.
  1. POST /estimate로 가격을 확인해요. 건너뛰어도 돼요.
  2. POST /generations로 시작하면 202와 작업 id가 와요.
  3. GET /generations/{id}를 terminal이 true가 될 때까지 조회해요.
  4. status가 succeeded면 outputs[].url에서 결과를 받아요.

작업 상태

얼마나 자주 조회할까요

이미지는 3초, 영상은 10초에 한 번이면 충분해요. terminal이 true가 될 때까지 조회하고, 그동안 같은 작업을 다시 시작하지 마세요. 조회는 요금이 들지 않아요. 웹훅을 등록하면 조회하지 않아도 작업이 끝날 때 알려드려요.

전체 예시

취소

POST /generations/{id}/cancel로 시작 전인 작업을 취소하고 금액을 돌려받아요. 이미 시작했다면 409 generation_not_cancelable이고, 그 작업은 끝까지 진행돼요. 다시 호출해도 괜찮아요.

목록

GET /generations로 API로 만든 작업을 최신순으로 받아요. 사이트에서 만든 작업은 나오지 않고, 반대로 API 작업도 사이트 기록에 나오지 않아요. 잔액과 동시 실행 한도는 함께 써요.

결과 다시 쓰기

prompt와 outputs[].id는 다음 작업에 그대로 쓸 수 있어요. 영상으로 바꾸거나 고칠 때 결과를 입력으로 넣으면 돼요. 자세한 내용은 입력 파일을 봐 주세요.