생성 작업 만들기
입력 검증, 크레딧 차감, 작업 생성 후 taskId를 반환합니다.
메서드: POST경로: /api/v1/video/sora-pro
페이로드 매개변수
- 필수. sora-2-text-to-video, sora-2-image-to-video, sora-2-pro-text-to-video, sora-2-pro-image-to-video, sora-2-pro-storyboard 중 하나.
- 조건부. sora-2-pro-storyboard를 제외한 모든 모델에 필수.
- 조건부. data:image/png;base64,...와 같은 Base64 데이터 URL. imageUrl이 없는 경우 이미지-투-비디오에 필수.
- 조건부. imageData가 제공되지 않을 때 사용되는 공개 이미지 URL.
- 선택 사항. portrait 또는 landscape. 기본값: landscape.
- 선택 사항. 10, 15 또는 25 (스토리보드 전용). 기본값은 모델에 따라 다릅니다.
- 선택 사항. standard 또는 high. Pro 텍스트/이미지 모델 전용.
- 선택 사항. 비스토리보드 모델에서 워터마크 제거. 기본값: true.
- 조건부. sora-2-pro-storyboard에 필수. '{ Scene, duration }' 배열.
참고
- 둘 다 제공된 경우 imageData가 imageUrl보다 우선합니다.
- prompt는 스토리보드에서 선택 사항이며 제공자에게 전송되지 않습니다; 콘텐츠에는 shots를 사용하세요.
- nFrames는 모델별 허용 값으로 정규화됩니다.
- removeWatermark는 비스토리보드 모델에서 기본값이 true입니다.
- shots에는 Scene(대문자 S)과 duration > 0이 포함되어야 합니다.
샘플 요청
텍스트-투-비디오
curl -X POST https://freesoragenerator.com/api/v1/video/sora-pro \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "sora-2-pro-text-to-video",
"prompt": "A cinematic shot of a futuristic city at sunset.",
"aspectRatio": "landscape",
"nFrames": "10",
"size": "high",
"removeWatermark": true
}'이미지-투-비디오
curl -X POST https://freesoragenerator.com/api/v1/video/sora-pro \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "sora-2-image-to-video",
"prompt": "Turn this image into a dynamic 10s clip.",
"imageUrl": "https://example.com/reference.png",
"aspectRatio": "portrait",
"nFrames": "10"
}'스토리보드
curl -X POST https://freesoragenerator.com/api/v1/video/sora-pro \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "sora-2-pro-storyboard",
"shots": [
{ "Scene": "Establishing shot of a city skyline at dusk", "duration": 5 },
{ "Scene": "Close-up of a runner splashing through puddles", "duration": 5 }
],
"aspectRatio": "landscape",
"nFrames": "10"
}'샘플 응답
{
"code": 0,
"message": "ok",
"data": {
"taskId": "281e5b0*********************f39b9"
}
}