Sora 비디오 생성은(는) 무엇을 하나요?
AceDataCloud의 OpenAI Sora API를 통해 AI 비디오를 생성합니다.
설정: 토큰 설정은 인증을 참조하세요.
빠른 시작
curl -X POST https://api.acedata.cloud/sora/videos \
-H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"prompt": "해변에서 일몰을 배경으로 달리는 골든 리트리버", "model": "sora-2", "callback_url": "https://api.acedata.cloud/health"}'
비동기: 비동기 작업 폴링을 참조하세요.
POST /sora/tasks에{"id": "..."}를 사용하여 폴링합니다.
모델
| 모델 | 지속 시간 | 품질 | 용도 |
|---|---|---|---|
sora-2 | 10–15초 | 표준 | 대부분의 작업 (기본값) |
sora-2-pro | 10–25초 | 고급 | 프리미엄 품질, 긴 비디오 |
워크플로
1. 텍스트-비디오
POST /sora/videos
{
"prompt": "네온사인이 빗물 웅덩이에 반사되는 번화한 도쿄 밤거리",
"model": "sora-2",
"size": "small",
"duration": 10,
"orientation": "landscape"
}
2. 이미지-비디오
참조 이미지를 사용하여 생성을 안내합니다.
POST /sora/videos
{
"prompt": "장면이 점차 부드러운 움직임으로 살아납니다",
"image_urls": ["https://example.com/scene.jpg"],
"model": "sora-2",
"orientation": "landscape"
}
3. 캐릭터 기반 비디오
기존 비디오에서 캐릭터를 추출하여 새로운 장면에서 사용합니다.
POST /sora/videos
{
"prompt": "캐릭터가 미래 도시를 걸어갑니다",
"character_url": "https://example.com/source-video.mp4",
"character_start": 2.0,
"character_end": 5.0,
"model": "sora-2-pro"
}
매개변수
| 매개변수 | 값 | 설명 |
|---|---|---|
model | "sora-2", "sora-2-pro" | 사용할 모델 (필수) |
size | "small", "large" | 비디오 해상도 |
duration | 10, 15, 25 | 지속 시간 (초) (25는 sora-2-pro 전용) |
orientation | "landscape" (16:9), "portrait" (9:16), "square" (1:1) | 비디오 방향 |
version | "1.0" | API 버전 — 버전 1.0은 최대 25초 지속 시간, 방향, 캐릭터 참조, 이미지 입력을 지원합니다 |
주의사항
- 25초 지속 시간은
sora-2-pro모델에서만 사용 가능합니다. size: "large"는 더 높은 해상도를 제공하지만 비용이 더 많이 들고 시간이 더 오래 걸립니다.- 캐릭터 기반 생성에는 소스 비디오에서
character_start및character_end타임스탬프(초 단위)가 필요합니다. orientation은 화면 비율을 설정합니다. 모바일 우선 콘텐츠에는"portrait"를 사용하세요.- 작업 상태는
"succeeded"를 사용합니다("completed" 아님). 폴링 시 이 값을 확인하세요.
MCP:
pip install mcp-sora| 호스팅:https://sora.mcp.acedata.cloud/mcp| 모든 MCP 서버 참조