만들 내용
Sora 2 비디오 작업을 제출하고, 반환된 비디오 ID를 저장한 다음, 작업이 완료될 때까지 폴링하고, 완성된 비디오 콘텐츠를 다운로드합니다.사전 요구 사항
COMETAPI_KEY에 저장된 CometAPI API 키requests가 있는 Python 3.10+ 또는 Node.js 18+- 폴링을 위한 서버 측 워커 또는 작업 큐
API 키, 기본 URL, 인증
다음으로 Sora 작업을 생성합니다:코드 예제
아래 탭에서 cURL, Python, Node.js로 된 복사 가능한 예제를 사용할 수 있습니다.흐름 설명
Sora 생성은 비동기식입니다. 생성 엔드포인트는 비디오 ID와 초기 status를 반환합니다.status가 completed 또는 failed가 될 때까지 GET /v1/videos/<video_id>를 폴링하세요. 작업이 완료되면 GET /v1/videos/<video_id>/content로 파일을 다운로드하세요.
정확한 WxH 크기를 사용하세요. Sora API 레퍼런스에는 표준 가로형 및 세로형 크기와 함께, Pro model 워크플로를 위한 더 큰 Pro 크기가 문서화되어 있습니다.
공통 파라미터
문제 해결 / FAQ
생성 요청이 실패합니다
생성 요청이 실패합니다
multipart form data를 사용하세요. 레퍼런스의 Sora 생성 요청은 JSON body가 아니라 form 필드를 사용합니다.
콘텐츠 다운로드가 실패합니다
콘텐츠 다운로드가 실패합니다
status 엔드포인트가
completed를 보고한 후에만 콘텐츠를 다운로드하세요. 완료된 파일은 자체 스토리지에 저장하세요.Pro size가 작동하지 않습니다
Pro size가 작동하지 않습니다
더 큰 Pro size는 Pro model 워크플로에서만 사용하세요. 첫 요청은
1280x720부터 시작하세요.다음 단계
- Sora 2 비디오 생성 API 레퍼런스를 읽어보세요.
- Sora 2 비디오 조회로 폴링하세요.
- Sora 2 비디오 콘텐츠 조회로 다운로드하세요.
- Models에서 사용 가능한 비디오 모델을 확인하세요.
- 비디오 생성을 위한 polling 및 webhook 사용을 검토하세요.
- 모델 호출 전 요청 비용 추정으로 작업 비용을 추정하세요.