sora-2
Sora 2 비디오 만들기
POST /v1/videos를 사용해 텍스트 프롬프트 또는 참조 이미지로 Sora 2 비디오 생성 작업을 만들고, 이후 task ID로 상태를 조회해 결과를 확인합니다.
POST
이 엔드포인트를 사용하면 텍스트만으로, 또는 텍스트와 참조 이미지 1장으로 Sora 렌더링 작업을 시작할 수 있습니다. API는 즉시 비디오 id를 반환하며 렌더링이 끝날 때까지 기다리지 않습니다.
가장 작은 유용한 작업으로 시작하기
- 더 빠르게 반복 작업하려면
sora-2를 사용하고, 속도보다 출력 품질이 더 중요하면sora-2-pro를 사용하세요 - 첫 요청에서는
seconds를4로 유지하세요 - 세로형 출력이 꼭 필요한 경우가 아니라면
size: 1280x720으로 시작하세요 - 참조 이미지는 최대 1장만 업로드하세요
길이와 크기
Sora는
size 필드가 정확한 WxH 형식이어야 합니다. 720p 같은 해상도 토큰이나 16:9 같은 비율 표기는 이 엔드포인트에서 유효한 Sora size 값이 아닙니다.
엔드 투 엔드 흐름
1
렌더링 작업 생성
model, prompt, seconds, size를 전송한 다음, 반환된 id를 저장합니다.2
작업이 끝날 때까지 조회
상태가
completed 또는 failed가 될 때까지 비디오 조회를 호출하세요.3
결과 다운로드
렌더링이 완료되면 비디오 콘텐츠 조회로 파일을 가져오세요.
계속 적용되는 Sora 동작
OpenAI는 Videos API에서 동일한 create -> retrieve -> download 흐름을 문서화하고 있습니다. CometAPI에서는 Sora 요청 형식을 그대로 유지하되, CometAPI 기본 URL과 키를 사용합니다. 완료된 다운로드 URL은 임시이므로, 장기간 보관이 필요하다면 완료된 자산을 자체 스토리지에 복사하세요.인증
Bearer token authentication. Use your CometAPI key.
본문
multipart/form-data
Text prompt that describes the video you want to create.
예시:
"A paper airplane glides across a desk."
Sora model ID. Choose an available model from the Models page.
예시:
"sora-2"
Clip duration in seconds. Use 4, 8, 12, 16, or 20.
사용 가능한 옵션:
4, 8, 12, 16, 20 예시:
"4"
Output resolution formatted as width x height. Use 1280x720 or 720x1280 for standard Sora output. Use 1792x1024 or 1024x1792 with a Pro model when you need larger Pro output.
사용 가능한 옵션:
720x1280, 1280x720, 1024x1792, 1792x1024 예시:
"1280x720"
Optional reference image uploaded as a file. The image should match the target size you request.