비동기 미디어 생성
이미지, 비디오 또는 음악 작업을 생성하고 결과물을 비동기적으로 검색합니다.
추론 요청을 열어두지 않고 오래 실행되는 미디어 생성 작업을 제출합니다.
POST
/v1/async-tasks/image-generations요청 본문
| 필드 | 유형 | 필수 | 설명 |
|---|---|---|---|
model | string | 아니요 | 미디어 모델 식별자입니다. 생략하면 라우팅은 구성된 기본 제공자 동작을 사용합니다. |
prompt | string | 예 | 원하는 출력에 대한 설명입니다. |
n | integer | 아니요 | 1부터 10까지의 이미지 수이며, 기본값은 1입니다. |
seed | integer | 아니요 | 지원되는 경우 음수가 아닌 결정론적 시드입니다. |
| 추가 필드 | object | 아니요 | 제공자가 지원하는 차원 및 생성 제어입니다. 알 수 없는 최상위 필드는 거부됩니다. 제공자별 옵션은 provider_options 또는 parameters 아래에 속합니다. |
비디오 요청은 최대 300까지의 양수 duration_seconds과 최대 120까지의 양수 정수 fps을 허용합니다. 음악 요청은 최대 1,200까지의 duration_seconds을 허용하며 prompt, lyrics 또는 title 중 하나 이상이 필요합니다.
작업 수명 주기
- 이미지, 비디오 또는 음악 생성 요청을 제출합니다.
- 반환된 작업 ID를 저장합니다.
- 작업이 완료될 때까지
GET /v1/async-tasks/{task_id}을 폴링합니다. - 서명된 결과물 URL을 통해 출력을 다운로드합니다.
결과물 URL은 시간이 제한됩니다. 장기 보존이 필요한 경우 자체 저장소에 최종 에셋을 영구 저장하십시오.
호환성 별칭
기존 통합에서는 /v1/images/generations, /v1/videos/generations 및 /v1/music/generations을 사용할 수 있습니다. 새 통합은 위의 명시적 /v1/async-tasks/*-generations 경로를 사용해야 합니다.