Sora 2 동영상 생성 - API易文档中心

Overview

Sora 2는 OpenAI의 대표 동영상 생성 시리즈로, 텍스트 prompt 또는 참조 이미지로부터 동기화된 오디오가 포함된 4~12초 분량의 고충실도 클립을 생성합니다. APIYI는 요청을 OpenAI의 /v1/videos 엔드포인트로 동일한 요청 및 응답 의미 체계로 직접 전달하는 투명한 프록시(공식 릴레이) 채널을 제공합니다.

🎬 주요 특징: 공식 OpenAI API로의 투명한 프록시, 동기화된 오디오 + 비디오 출력, 유연한 4 / 8 / 12초 길이, 그리고 세 가지 해상도 단계 — Standard (720p), HD (1024p), Full HD (1080p, Pro 전용). 광고 숏폼, 이커머스 소재, 소셜 미디어 클립, 제품 데모에 적합하며, 정확한 지시 이행과 일관된 품질이 중요할 때 유용합니다.

Text-to-Video API

POST /v1/videos, 텍스트만으로 동영상을 생성합니다 — JSON 요청 본문을 사용하는 가장 간단한 진입점입니다.

Image-to-Video API

POST /v1/videos + input_reference의 multipart 업로드를 통해 정지 이미지를 클립으로 애니메이션화합니다.

Visual API Testing

iCover 시각 테스트 도구에서 이 엔드포인트를 직접 디버깅합니다 — 코드가 필요하지 않습니다.

Async Task Lookup / Download

제출한 동영상 작업을 확인하고 APIYI 콘솔에서 동영상 링크를 다운로드합니다 — API 외부의 조회 항목입니다.

APIYI의 Sora 2 공식 릴레이를 선택해야 하는 이유는 무엇입니까?

OpenAI 공식 채널을 그대로 대체할 수 있으며, 안정성, 통합 마찰, 비용 전반의 운영 시나리오에 최적화되어 있습니다:

직접 공식 연결 · 99.99% 가동 시간

OpenAI의 공식 /v1/videos로 투명하게 전달되며, 중간 처리도 없고 프로토콜 우회 위험도 없습니다. 요청 및 응답 동작이 상위 서비스와 정확히 일치합니다. OpenAI 계정 등급이나 리스크 관리 변동을 관리할 필요가 없습니다.

무제한 동시 실행 수 · 프로덕션 규모

배치 촬영, 광고 파이프라인, 대량 자산 생성까지 선형적으로 확장할 수 있으며, 계정별 등급 상한이 없습니다. 기본 용량은 프로덕션에 바로 사용할 수 있습니다; 맞춤형 리소스 풀은 문의해 주십시오.

동일한 초당 과금 + 충전 보너스

OpenAI 공식과 동일한 초당 요율에 충전 보너스를 더해 추가 절감이 가능합니다. 실패한 작업은 과금되지 않습니다.

전 세계 무마찰 접근

해외 서버나 프록시가 필요하지 않습니다 — 중국 본토 데이터 센터, 가정용 네트워크 또는 해외 노드에서 api.apiyi.com에 직접 연결할 수 있습니다. OpenAI의 국경 간 설정을 완전히 건너뛸 수 있습니다.

OpenAI 호환 · 코드 변경 없음

엔드포인트 경로 /v1/videos는 OpenAI와 정확히 일치합니다. 공식 OpenAI SDK를 APIYI의 base_url에 연결한 뒤 그대로 호출하면 됩니다. 매개변수와 필드 이름이 일대일로 맞습니다.

전문 지원 · 엔터프라이즈 온보딩

저희 팀은 동영상 생성 분야에 깊은 전문성을 보유하고 있습니다: prompt 엔지니어링, 해상도 선택, 배치 생산, 후처리까지 지원합니다. 엔터프라이즈 고객을 위한 PoC부터 운영까지의 전면 기술 지원을 제공합니다.

주요 기능

동기화된 오디오 + 비디오

Sora 2는 동기화된 오디오 트랙이 포함된 비디오(환경음, 대화, 배경음악)를 기본적으로 출력하므로 별도의 오디오 후반 작업이 필요하지 않습니다.

다중 해상도 티어

sora-2는 720p(720x1280 / 1280x720)를 지원합니다; sora-2-pro는 1024p 및 1080p 티어를 1920x1080까지 추가합니다.

유연한 4 / 8 / 12초 길이

초당 과금은 생성한 만큼만 정확히 지불한다는 뜻입니다. 8초가 가장 일반적인 티어이며, 시각적 연속성과 비용의 균형을 맞춥니다.

정밀한 지시 이행

Sora 2는 카메라 움직임, 물체 물리, 캐릭터 표정 충실도에서 해당 티어를 선도하며 — 경쟁 제품보다 prompt 의도에 더 가깝습니다.

이미지에서 동영상으로 (input_reference)

정지된 비주얼을 움직이게 하기 위해 시작 프레임으로 이미지 한 장을 업로드합니다. 이미지에서 동영상으로를 참조하십시오.

비동기 작업 모델

제출하면 video_id가 즉시 반환됩니다. 상태를 별도로 폴링하고 최종 동영상을 다운로드하십시오 — 배치 관리와 실패 후 재개 흐름에 이상적입니다.

OpenAI SDK 드롭인

base_url=https://api.apiyi.com/v1는 공식 OpenAI SDK를 대체하는 드롭인 대안으로 작동합니다.

실패는 무료입니다

비동기 모드에서는 실패한 생성, 콘텐츠 정책 거부, 용량 오류는 과금되지 않습니다.

요금

동영상 길이(초) 기준으로 과금되며, OpenAI 공식 요율과 동일합니다. sora-2-pro에는 3개의 해상도 등급이 있으며, 각 등급마다 초당 요금이 다릅니다.

`sora-2` (표준)

해상도	요율	4초	8초	12초
`720x1280` / `1280x720`	$0.10/sec	$0.40	$0.80	$1.20

`sora-2-pro` (Pro)

해상도	요율	4초	8초	12초
`720x1280` / `1280x720`	$0.30/sec	$1.20	$2.40	$3.60
`1024x1792` / `1792x1024`	$0.50/sec	$2.00	$4.00	$6.00
`1080x1920` / `1920x1080`	$0.70/sec	$2.80	$5.60	$8.40

과금 참고사항:

실제로 생성된 초 수(seconds × rate) 기준으로 과금되며, prompt 길이나 input_reference 제공 여부와는 무관합니다
비동기 모드에서는 생성 실패 / 콘텐츠 정책 거부 / 용량 오류가 발생해도 모두 과금되지 않습니다
요청은 APIYI 콘솔의 사용량 기반 과금 모드를 사용해야 합니다(API Key 설정에서 전환 가능); 요청별 과금 그룹은 공식 릴레이 채널로 라우팅할 수 없습니다
충전 보너스 등급은 충전 프로모션에서 확인할 수 있습니다

그룹 설정

Sora 2 공식 릴레이는 전용 Sora2Official 그룹(1x)을 통해 라우팅됩니다. token이 채널에 도달하려면 두 가지 조건을 충족해야 합니다.

과금 모드: 사용량 기반 우선순위(종량제)를 선택하십시오. 요청별 과금 token은 공식 릴레이로 라우팅할 수 없습니다.
그룹: Sora2Official를 포함해야 합니다.

token 생성 UI: 과금 모드가 사용량 기반 우선순위로 설정되고, 그룹 드롭다운에 Sora2Official (1x)가 표시되며, 안정적인 OpenAI 공식 릴레이 초단위 과금 채널 — Token creation: pick Usage-Based Priority for the billing mode and select Sora2Official under groups to call sora-2 / sora-2-pro

권장 설정은 두 가지입니다 — 격리 요구에 맞는 쪽을 선택하십시오:

설정	사용할 때	방법
A. 단일 token, 다목적	같은 token이 다른 모델(GPT / Claude / 이미지 / …)도 호출하는 경우	평소 사용하시는 `Default`(또는 다른 그룹)을 기본 그룹으로 유지하고, `Sora2Official`를 대체로 설정하십시오 — Sora가 아닌 요청은 기본 그룹에 유지되고, `sora-2` / `sora-2-pro` 호출은 자동으로 `Sora2Official`로 라우팅됩니다
B. 전용 token	동영상 작업을 분리해 두고, 격리된 과금 및 쿼터 제어가 필요할 때	`Sora2Official` 그룹만 선택한 새 token을 생성하고, Sora 2 전용으로만 사용합니다

운영용 동영상 작업에는 **B(전용 token)**를 권장합니다. 과금이 더 깔끔하고, 쿼터 및 알림 관리가 더 쉽습니다. A는 개인 개발이나 저빈도 사용에 적합합니다.

기술 사양

Dimension	sora-2	sora-2-pro
모델 ID	`sora-2`	`sora-2-pro`
현재 스냅샷	`sora-2-2025-12-08`	별칭과 동기화됨
사용 중단된 스냅샷	`sora-2-2025-10-06`	—
지원 해상도	`720x1280` / `1280x720`	`720x1280` / `1280x720` / `1024x1792` / `1792x1024` / `1080x1920` / `1920x1080`
지원 지속 시간(초)	`4` / `8` / `12`	`4` / `8` / `12`
오디오 트랙	✅ 동기화됨	✅ 동기화됨
이미지-투-비디오 (input_reference)	✅	✅
일반적인 생성 시간	3–5분	5–10분
동영상 보존 기간	1일	1일
응답 필드	`id` / `status` / `progress`; `/v1/videos/{id}/content`을 통해 다운로드	동일

API 엔드포인트

엔드포인트	메서드	목적	Content-Type
`/v1/videos`	POST	동영상 생성 작업을 제출합니다(텍스트-투-비디오 및 이미지-투-비디오)	`application/json` or `multipart/form-data`
`/v1/videos/{video_id}`	GET	작업 상태와 진행 상황을 조회합니다	—
`/v1/videos/{video_id}/content`	GET	생성된 동영상 파일을 다운로드합니다	—

도메인 옵션: api.apiyi.com이 기본 엔드포인트입니다. vip.apiyi.com / b.apiyi.com는 동일한 동작을 하는 동등한 백업 게이트웨이입니다.

핵심 파라미터

`seconds` (동영상 길이)

문자열 타입의 enum 값은 세 개뿐입니다(숫자는 아님):

값	의미	사용 사례
`"4"`	4초(기본값)	짧은 데모, 단일 샷, 빠른 prompt 반복
`"8"`	8초	표준 숏폼 동영상, 소셜 미디어 클립
`"12"`	12초	롱샷, 연속 액션, 서사 시퀀스

seconds는 문자열 "4" / "8" / "12"로 전달해야 합니다. 정수 4 또는 "10" / "15" 같은 다른 값을 전달하면 400을 반환합니다.

`size` (출력 해상도)

지원되는 티어는 sora-2와 sora-2-pro에서 다릅니다:

티어	픽셀	sora-2	sora-2-pro
720p 세로형	`720x1280`	✅	✅ ($0.30/초)
720p 가로형	`1280x720`	✅	✅ ($0.30/초)
1024p 세로형	`1024x1792`	❌	✅ ($0.50/초)
1024p 가로형	`1792x1024`	❌	✅ ($0.50/초)
1080p 세로형	`1080x1920`	❌	✅ ($0.70/초)
1080p 가로형	`1920x1080`	❌	✅ ($0.70/초)

1024p / 1080p 크기를 sora-2에 전달하면 400이 반환됩니다
sora-2 720p 동영상의 실제 렌더링 세로 픽셀 수는 704(720이 아님)입니다. 이는 OpenAI의 실제 업스트림 동작이며 표시에는 영향을 주지 않습니다
image-to-video에서는 input_reference 이미지 크기가 size와 정확히 일치해야 하며, 그렇지 않으면 Inpaint image must match the requested width and height가 발생합니다

모범 사례

필요에 맞는 모델을 선택하십시오

비용을 중시하는 경우 → sora-2 (720p만 지원, $0.10/sec, 4초 클립은 $0.40)
1080p Full HD / 가장 강한 지시 이행이 필요한 경우 → sora-2-pro (최대 $0.70/sec, 1920x1080 지원)
내부 데모 / 초기 반복 작업 → sora-2 4초로 시작하십시오

길이를 늘리기 전에 4초로 검증하십시오

새 prompt마다 먼저 seconds: "4"에서 실행하여 카메라 방향, 스타일, 전체 구성을 확인하십시오(~3분, $0.40). 화면이 고정된 뒤에만 8 / 12초로 늘리십시오.

먼저 사용량 기반 과금으로 전환하십시오

APIYI 콘솔에서 API Key를 usage-based billing과 Sora2官转 (Sora2 Official) 그룹으로 설정하십시오. 요청별 과금 그룹은 공식 릴레이 채널로 라우팅할 수 없습니다.

동기식 대기가 아니라 비동기 폴링을 사용하십시오

공식 릴레이 채널은 비동기 전용입니다. POST로 제출하고 video_id를 받은 다음, /v1/videos/{id}를 10~30초마다 폴링하여 status: "completed"가 될 때까지 기다린 뒤 /v1/videos/{id}/content에서 다운로드하십시오.

클라이언트 타임아웃을 30초 이상으로 설정하십시오

POST 자체는 작업을 큐에 넣을 뿐이며 생성 완료를 기다리지 않습니다. multipart input_reference 업로드에서는 큰 이미지가 연결 시간을 늘리므로 30초 타임아웃으로 시작하십시오.

동영상을 즉시 다운로드하십시오

동영상은 OpenAI 서버에 1일만 보관됩니다. 그 이후에는 /content가 404를 반환합니다. 운영 플로우에서는 status: "completed"가 되는 즉시 자체 OSS / CDN에 저장해야 합니다.

이미지→동영상 업로드 전에 해상도를 맞추십시오

input_reference를 업로드할 때, ffmpeg / Pillow로 이미지를 정확한 대상 size에 맞게 미리 잘라두십시오(예: 1280x720). 그래야 400 오류를 피할 수 있습니다.

오류 코드 및 재시도

상태	의미	권장 조치
`400`	잘못된 매개변수(seconds 값이 4/8/12가 아니거나, size가 지원되지 않거나, input_reference 차원이 일치하지 않음)	매개변수를 검증하십시오; 참조 이미지를 대상 해상도에 맞게 미리 자르십시오
`401`	잘못된 token	Bearer Token 및 그룹 설정을 확인하십시오(반드시 `Sora2官转`여야 합니다)
`403`	콘텐츠 정책 거부 / 잘못된 과금 모드	프롬프트를 조정하십시오; API Key가 사용량 기반 과금인지 확인하십시오
`429`	요청 제한 / 잔액 부족	지수 백오프를 사용하십시오; 충전 직후 바로 사용 가능합니다
`5xx`	게이트웨이 / upstream 오류	비동기 작업을 1–2회 재시도하십시오(과금되지 않습니다)
작업 `failed`	생성 실패(대부분 콘텐츠 정책 또는 upstream 용량 문제)	프롬프트를 조정하고 재시도하십시오; 실패한 작업은 과금되지 않습니다

권장 클라이언트 설정:

POST 제출 타임아웃: 30초(multipart 업로드는 더 길게)
GET 폴링 간격: 10–30초, 최대 대기 시간 15분(Pro 1080p 12초는 8–10분이 걸릴 수 있습니다)
5xx 및 failed 작업에 대해 지수 백오프 재시도 사용(2회 재시도 권장)
디버깅을 위해 x-request-id 응답 헤더를 기록하십시오

자주 묻는 질문

공식 릴레이 대 역공학 버전 — 차이점은 무엇이며, 역공학 버전은 아직도 사용 가능합니까?

공식 릴레이(이 페이지): OpenAI의 /v1/videos로 직접 전달하며, 요청/응답 필드는 업스트림과 일치합니다. 초당 과금, 99.99% 가동 시간, 사용량 기준 과금 그룹이 필요합니다.역공학 버전: 역공학된 Sora 2 인터페이스로, 요청당 과금이라 더 저렴하지만 OpenAI 위험 제어의 영향을 받습니다. 2026년 1월 OpenAI 정책 조정 기준으로 무료 계정은 비활성화되었으며, APIYI는 이제 공식 릴레이 채널만 제공합니다. 특별한 필요가 있으면 영업팀에 문의하십시오.

왜 사용량 기준 과금으로 전환해야 합니까?

공식 릴레이 채널은 실제 OpenAI 초 기준으로 정산하며, 이는 요청당 과금과는 다른 과금 차원입니다. APIYI 콘솔에서 API Key를 사용량 기준 과금 + Sora2 공식 릴레이 그룹으로 전환해야 이 경로에 접근할 수 있습니다 — 요청당 그룹은 403을 받습니다.

왜 비동기만 지원합니까? 동기 스트리밍 옵션이 있습니까?

공식 /v1/videos 엔드포인트 자체가 비동기 작업 기반이기 때문입니다 — SSE나 WebSocket 스트리밍은 없습니다. 4초 클립 생성에는 보통 3~~5분이 걸리며, 12초는 8~~10분이 걸릴 수 있습니다. 동기 대기는 HTTP 연결을 너무 오래 점유해 신뢰성이 떨어집니다. 항상 POST → 폴링 → 다운로드 흐름을 사용하십시오.

어떤 초 값이 지원됩니까? 왜 10 / 15를 전달할 수 없습니까?

OpenAI는 공식적으로 "4" / "8" / "12"만 enum 문자열 값으로 노출합니다. 10 / 15초 값은 이전 역공학 채널의 비공식 길이였으며 공식 릴레이에서는 지원되지 않습니다. 코드가 "10"를 전달한다면 "8" 또는 "12"로 변경하십시오.

sora-2-pro 1080p의 \$0.70/sec는 새 것입니까?

예. OpenAI는 최근 sora-2-pro를 1080x1920 / 1920x1080 풀 HD까지 $0.70/sec로 확장했습니다. 이전의 720p ($0.30)와 1024p ($0.50) 등급은 변함없습니다. 위의 요금표는 최신 공식 요율을 반영합니다.

동영상은 얼마나 보관됩니까?

동영상은 OpenAI 서버에 1일 동안만 저장됩니다. 만료 후 /v1/videos/{id}/content는 404 / 410을 반환합니다. 프로덕션 흐름에서는 status: "completed" 직후 자체 OSS / CDN으로 다운로드하여 보관해야 합니다.

실패한 생성도 과금됩니까?

아니요. failed로 끝나는 작업, content-policy 거부, capacity 오류, parameter 오류는 모두 과금되지 않습니다. 실제로 완료되어(status: "completed") 동영상 파일을 생성한 작업만 seconds 요율로 과금됩니다.

공식 OpenAI SDK를 직접 사용할 수 있습니까?

예. OpenAI Python SDK 1.50+는 videos 네임스페이스를 지원합니다. base_url를 https://api.apiyi.com/v1로 지정하십시오:

from openai import OpenAI

client = OpenAI(api_key="sk-your-key", base_url="https://api.apiyi.com/v1")
video = client.videos.create(
    model="sora-2",
    prompt="A golden retriever running on the beach at sunset",
    seconds="8",
    size="1280x720"
)
print(video.id, video.status)

input_reference는 base64를 허용합니까?

아니요. input_reference는 multipart/form-data 파일 업로드 필드이며(image/jpeg / image/png / image/webp를 허용함), multipart 요청이 필요합니다. 이미지가 base64라면 먼저 디코딩하여 임시 파일에 기록하십시오. 이미지에서 동영상으로를 참조하십시오.

오디오 트랙을 비활성화할 수 있습니까?

현재는 불가능합니다. Sora 2 / Pro 출력은 기본적으로 동기화된 오디오(주변음, 대화, 음악)를 포함하며, OpenAI는 이를 비활성화하는 파라미터를 제공하지 않습니다. 오디오가 없는 출력이 필요하면 다운로드 후 ffmpeg -an로 제거하십시오.

실행 중인 작업을 취소할 수 있습니까?

아니요. 공식 /v1/videos 엔드포인트는 취소 작업을 제공하지 않습니다 — 일단 제출되면 작업은 완료될 때까지 실행됩니다. 긴 실행을 낭비하지 않도록 먼저 seconds: "4"에서 prompt를 검증하십시오.

요청 제한은 어떻게 됩니까?

상위 OpenAI 계정 등급 제한을 따르지만, APIYI의 게이트웨이를 통해 풀링되므로 일반적인 사용에서는 뚜렷한 병목이 없습니다. 기업용 배치 수요(동시 실행 수 10회 초과, 하루 100개 초과 클립)는 전용 리소스 풀을 위해 영업팀에 문의하십시오.

여러 작업을 병렬로 실행할 수 있습니까?

예. 각 POST /v1/videos는 독립적인 video_id를 반환합니다. 병렬로 제출하고 폴링하십시오. 폴링 폭주를 피하려면 작업 큐에서 video_id 목록을 관리하십시오.

​Overview

Text-to-Video API

Image-to-Video API

Visual API Testing

Async Task Lookup / Download

​APIYI의 Sora 2 공식 릴레이를 선택해야 하는 이유는 무엇입니까?

직접 공식 연결 · 99.99% 가동 시간

무제한 동시 실행 수 · 프로덕션 규모

동일한 초당 과금 + 충전 보너스

전 세계 무마찰 접근

OpenAI 호환 · 코드 변경 없음

전문 지원 · 엔터프라이즈 온보딩

​주요 기능

동기화된 오디오 + 비디오

다중 해상도 티어

유연한 4 / 8 / 12초 길이

정밀한 지시 이행

이미지에서 동영상으로 (input_reference)

비동기 작업 모델

OpenAI SDK 드롭인

실패는 무료입니다

​요금

​sora-2 (표준)

​sora-2-pro (Pro)

​그룹 설정

​기술 사양

​API 엔드포인트

​핵심 파라미터

​seconds (동영상 길이)

​size (출력 해상도)

​모범 사례

​오류 코드 및 재시도

​자주 묻는 질문

​관련 문서

Overview

APIYI의 Sora 2 공식 릴레이를 선택해야 하는 이유는 무엇입니까?

주요 기능

요금

`sora-2` (표준)

`sora-2-pro` (Pro)

그룹 설정

기술 사양

API 엔드포인트

핵심 파라미터

`seconds` (동영상 길이)

`size` (출력 해상도)

모범 사례

오류 코드 및 재시도

자주 묻는 질문

관련 문서