공식 API
비디오 생성
POST /v1/videos를 사용해 텍스트 프롬프트 또는 참조 이미지로 Sora 2 비디오 생성 작업을 만들고, 이후 task ID로 상태를 조회해 결과를 확인합니다.
POST
/
v1
/
videos
Create a Sora video job
curl --request POST \
--url https://api.cometapi.com/v1/videos \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: multipart/form-data' \
--form 'prompt=A paper airplane glides across a desk.' \
--form input_reference='@example-file'{
"created_at": 1773296991,
"id": "video_69b25d5f467c81908733a56bc236b4df",
"model": "sora-2",
"object": "video",
"progress": 0,
"seconds": "4",
"size": "1280x720",
"status": "queued"
}이 엔드포인트를 사용하면 텍스트만으로, 또는 텍스트와 참조 이미지 1장으로 새 Sora 렌더링 작업을 시작할 수 있습니다. API는 즉시 video id를 반환하며 렌더링이 완료될 때까지 기다리지 않습니다.
가장 작은 유효 작업으로 시작하기
- 더 빠르게 반복 작업하려면
sora-2를 사용하고, 속도보다 출력 품질이 더 중요하면sora-2-pro를 사용하세요 - 첫 요청에서는
seconds를4로 유지하세요 - 세로형 출력이 꼭 필요한 경우가 아니라면
size: 1280x720으로 시작하세요 - 참조 이미지는 최대 1장만 업로드하세요
전체 흐름
작업이 완료될 때까지 폴링
상태가
completed 또는 failed가 될 때까지 비디오 조회를 호출합니다.결과 다운로드 또는 리믹스
렌더링이 완료되면 비디오 콘텐츠 조회로 파일을 가져옵니다. 특정한 변형 결과를 원한다면 완료된 결과에 비디오 리믹스를 사용하세요.
계속 적용되는 Sora 동작
OpenAI는 Videos API에서 동일한 생성 -> 조회 -> 다운로드 흐름을 문서화하고 있습니다. CometAPI에서는 Sora 요청 형식을 그대로 유지하되, CometAPI base URL과 key를 사용합니다. 완료된 다운로드 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 a current model from the Models page.
예시:
"sora-2"
Clip duration in seconds.
사용 가능한 옵션:
4, 8, 12 예시:
"4"
Output resolution formatted as width x height.
사용 가능한 옵션:
720x1280, 1280x720, 1024x1792, 1792x1024 예시:
"1280x720"
Optional reference image uploaded as a file. The image should match the target size you request.
⌘I
Create a Sora video job
curl --request POST \
--url https://api.cometapi.com/v1/videos \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: multipart/form-data' \
--form 'prompt=A paper airplane glides across a desk.' \
--form input_reference='@example-file'{
"created_at": 1773296991,
"id": "video_69b25d5f467c81908733a56bc236b4df",
"model": "sora-2",
"object": "video",
"progress": 0,
"seconds": "4",
"size": "1280x720",
"status": "queued"
}