비동기 미디어 생성

이미지, 비디오 또는 음악 작업을 생성하고 결과물을 비동기적으로 검색합니다.

추론 요청을 열어두지 않고 오래 실행되는 미디어 생성 작업을 제출합니다.

POST/v1/async-tasks/image-generations

요청 본문

필드유형필수설명
modelstring아니요미디어 모델 식별자입니다. 생략하면 라우팅은 구성된 기본 제공자 동작을 사용합니다.
promptstring원하는 출력에 대한 설명입니다.
ninteger아니요1부터 10까지의 이미지 수이며, 기본값은 1입니다.
seedinteger아니요지원되는 경우 음수가 아닌 결정론적 시드입니다.
추가 필드object아니요제공자가 지원하는 차원 및 생성 제어입니다. 알 수 없는 최상위 필드는 거부됩니다. 제공자별 옵션은 provider_options 또는 parameters 아래에 속합니다.

비디오 요청은 최대 300까지의 양수 duration_seconds과 최대 120까지의 양수 정수 fps을 허용합니다. 음악 요청은 최대 1,200까지의 duration_seconds을 허용하며 prompt, lyrics 또는 title 중 하나 이상이 필요합니다.

작업 수명 주기

  1. 이미지, 비디오 또는 음악 생성 요청을 제출합니다.
  2. 반환된 작업 ID를 저장합니다.
  3. 작업이 완료될 때까지 GET /v1/async-tasks/{task_id}을 폴링합니다.
  4. 서명된 결과물 URL을 통해 출력을 다운로드합니다.

결과물 URL은 시간이 제한됩니다. 장기 보존이 필요한 경우 자체 저장소에 최종 에셋을 영구 저장하십시오.

호환성 별칭

기존 통합에서는 /v1/images/generations, /v1/videos/generations/v1/music/generations을 사용할 수 있습니다. 새 통합은 위의 명시적 /v1/async-tasks/*-generations 경로를 사용해야 합니다.