> ## Documentation Index
> Fetch the complete documentation index at: https://docs.laozhang.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Sora 2 API 종료: Wan·Seedance로 이전하는 방법

> LaoZhang API에서 더 이상 동작하지 않는 sora-2와 sora-2-pro에 대해, 영향받는 사용자와 완성된 비디오 보관 방법, Wan 2.7·Seedance 2.0 전환 절차를 정리했습니다.

Sora 2 비디오 API는 서비스가 종료되어 LaoZhang API에서 `sora-2`와 `sora-2-pro`로 새 요청을 처리하지 않습니다. Sora 2 작업 전송을 멈추고, 아직 필요한 완성 비디오를 저장한 뒤, 새 비디오 작업은 Wan 2.7이나 Seedance 2.0으로 옮기세요.

* **게시일:** 2026년 9월 24일
* **최종 확인일:** 2026년 10월 31일
* **상태:** 종료

## 변경 내용

| 항목 | 내용 |
| - | - |
| 모델 ID | `sora-2`, `sora-2-pro` |
| Sora 2가 쓰던 엔드포인트 | `POST /v1/videos`, `GET /v1/videos/{id}`, `GET /v1/videos/{id}/content` |
| Sora 2가 쓰던 토큰 그룹 | `OpenAI Official`(이전 이름 Sora2Official), `OpenAI Official Enterprise`(이전 이름 GPTImage2 Sora2 Enterprise) |
| LaoZhang API | 2026년 6월 17일 공지. Sora 2 공식 API 포워딩 경로는 2026년 7월 1일부터 종료되어 더 이상 유지보수하지 않음 |
| OpenAI | 2026년 9월 24일 OpenAI API에서 Videos API, `sora-2`, `sora-2-pro`와 각 스냅샷 제거 |
| OpenAI의 대체 모델 | 없음 |
| LaoZhang API의 대안 | Wan 2.7, Seedance 2.0 |

종료 대상은 Sora 2 요청입니다. Seedance 2.0은 결과를 내려받을 때 여전히 `GET /v1/videos/{id}/content`를 쓰므로 Seedance 가이드에서 이 경로를 볼 수 있습니다.

## 영향받는 사용자

다음에 해당하면 영향을 받습니다.

* LaoZhang API base URL로 OpenAI SDK의 `videos` 리소스를 쓰는 경우를 포함해, `sora-2`나 `sora-2-pro` 요청을 `/v1/videos`로 보내고 있습니다.
* Sora 2 전용으로 `OpenAI Official` 또는 `OpenAI Official Enterprise` 그룹의 토큰을 만들었습니다.
* 완성된 Sora 2 비디오를 아직 자체 저장소에 복사하지 않았습니다.

Wan 2.7, Seedance 2.0, 이미지 모델만 쓴다면 영향이 없습니다. 같은 토큰 그룹을 쓰는 이미지 요청, 예를 들어 공식 API 포워딩 `gpt-image-2`와 GPT Image 2.5 Flare·Sunburst 모델은 이번 종료와 관계없습니다. 해당 경로는 [GPT Image 2.5](https://docs.laozhang.ai/ko/api-capabilities/gpt-image-2-5.md)와 [GPT Image 2](https://docs.laozhang.ai/ko/api-capabilities/gpt-image-2.md) 가이드를 참고하세요.

## 지금 해야 할 일

1. **Sora 2 작업 생성을 멈추세요.** 요청 코드, 재시도 로직, 스케줄러, 작업 큐에서 `sora-2`와 `sora-2-pro`를 제거하세요. 새 요청은 비디오를 만들지 않으므로 재시도해도 소용없습니다.
2. **완성된 비디오를 저장하세요.** 아직 필요한 Sora 2 비디오는 모두 내려받아 자체 저장소에 보관하세요. OpenAI 다운로드 링크는 유효 기간이 짧고 업스트림의 Videos API도 제거되었으므로, 저장하지 않은 비디오는 다시 받지 못할 수 있습니다.
3. **Wan 2.7이나 Seedance 2.0으로 옮기세요.** 아래에서 두 선택지를 비교하고 요청 필드를 대응시킨 뒤, 운영 트래픽을 전환하기 전에 테스트 작업을 실행하세요. 코드 변경을 최소화하려면 같은 엔드포인트를 쓰는 Muse로 옮기세요(아래 Muse로 최소한만 바꾸기 절 참고).
4. **토큰을 정리하세요.** [토큰 관리](https://api.laozhang.ai/token)에서 Sora 2 전용으로 만든 토큰은 삭제하세요. 공식 API 포워딩 이미지 모델에도 쓰는 `OpenAI Official`, `OpenAI Official Enterprise` 토큰은 남겨 두세요. Wan 2.7은 `Wan` 그룹, Seedance 2.0은 `SeeDance2` 그룹으로 새 토큰을 만드세요.

## Muse로 최소한만 바꾸기

Meta의 비디오 모델인 [Muse](https://docs.laozhang.ai/ko/api-capabilities/muse-video-generation.md)는 2026년 10월 30일에 출시되었으며, Sora 2가 쓰던 OpenAI 비디오 엔드포인트를 그대로 씁니다. 따라서 생성, 조회, 다운로드 코드를 유지할 수 있습니다.

* 생성은 `POST /v1/videos`, 조회는 `GET /v1/videos/{id}`, 다운로드는 `GET /v1/videos/{id}/content`입니다.
* multipart 첫 프레임 업로드는 여전히 `input_reference` 필드를 쓰고, `size`도 `1280x720`과 `720x1280`을 받습니다.
* 상태 값도 `queued`, `in_progress`, `completed`, `failed`로 같습니다.

바뀌는 것은 세 가지뿐입니다.

* `model`을 `muse-video`로 설정합니다. 20~~60초 클립은 `muse-video-20s`~~`muse-video-60s`를 씁니다.
* `seconds`는 `"5"`, `"8"`, `"10"` 중 하나로 설정합니다. Sora 2의 4초, 12초 길이는 받지 않습니다.
* 과금 방식이 사용량 우선인 `default` 그룹 토큰을 씁니다.

Muse는 5\~10초 비디오 한 편에 \$0.30이며, 720p 등급으로 소리와 함께 출력합니다. Wan, Seedance, MiniMax H3와의 가격 비교는 [비디오 API 비교](https://docs.laozhang.ai/ko/api-capabilities/video-generation-guide.md)를 참고하세요.

## 대체 모델 선택

두 대체 모델 모두 비동기 방식입니다. 작업을 만들고, 작업 ID를 저장하고, 끝날 때까지 조회한 뒤 MP4를 내려받습니다.

| 항목 | Wan 2.7 | Seedance 2.0 |
| - | - | - |
| 모델 ID | `wan2.7-t2v`, `wan2.7-i2v`, `wan2.7-r2v`, `wan2.7-videoedit` | `doubao-seedance-2-0-260128`, `doubao-seedance-2-0-fast-260128`, `doubao-seedance-2-0-mini-260615`, `doubao-seedance-2-5-260628` |
| 입력 | 텍스트, 이미지, 구동 오디오, 원본 비디오 | 텍스트와 이미지·비디오·오디오 참조 |
| 토큰 그룹 | `Wan` 전용. 사용량 우선 또는 사용량 과금 | `SeeDance2` 전용. 사용량 우선 또는 사용량 과금 |
| 과금 | 초당. 720P \$0.1028, 1080P \$0.1714 | 토큰 기준. 작업마다 선차감 줄과 정산 줄이 기록됨 |
| 요청 본문 | JSON | JSON |
| 가이드 | [Wan 2.7 API](https://docs.laozhang.ai/ko/api-capabilities/wan-video-generation.md) | [Seedance 2.0 API](https://docs.laozhang.ai/ko/api-capabilities/seedance2-video-generation.md) |

* 기존 클립을 편집하거나, 오디오 트랙에 맞춰 이미지를 움직이게 하려면 **Wan 2.7**을 고르세요.
* 이미지, 비디오, 오디오 참조를 한 요청에 조합하거나, [실제 인물·가상 인물 에셋 API](https://docs.laozhang.ai/ko/api-capabilities/seedance2-human-virtual-workflow.md)로 실제 인물의 외모를 유지하려면 **Seedance 2.0**을 고르세요.

판단이 어렵다면 같은 프롬프트를 두 모델에 보내 결과와 청구 금액을 비교해 보세요.

각 가이드의 과금 절에 USD 가격, 공식 목록 가격에서 환산하는 방법, 작업당 예상 비용이 2026년 10월 14일부터 적용된 공개 가격으로 정리되어 있습니다. 작업별 청구 금액은 [호출 로그](https://api.laozhang.ai/log)에 나타납니다.

Seedance 2.0은 작업마다 선차감 줄과 정산 줄, 두 줄을 기록하며 작업 비용은 두 줄의 합계입니다.

### 엔드포인트

```text theme={null}
Wan 2.7
  POST https://api.laozhang.ai/wan/api/v1/services/aigc/video-generation/video-synthesis
  GET  https://api.laozhang.ai/v1/tasks/{task_id}
  다운로드: 완료된 작업의 result_url (Authorization 헤더 없이)

Seedance 2.0
  POST https://api.laozhang.ai/seedance/api/v3/contents/generations/tasks
  GET  https://api.laozhang.ai/seedance/api/v3/contents/generations/tasks/{id}
  다운로드: content.video_url 또는 GET https://api.laozhang.ai/v1/videos/{id}/content
```

### Sora 2 요청 필드 대응

| Sora 2 | Wan 2.7 | Seedance 2.0 |
| - | - | - |
| multipart 폼 본문 | JSON 본문 | JSON 본문 |
| `prompt` | `input.prompt` | `type: "text"`인 `content[]` 항목 |
| `seconds`(문자열) | `parameters.duration`(정수) | `duration`(정수) |
| `1280x720` 같은 `size` | `720P` 같은 `parameters.resolution` | `ratio`와 `resolution` |
| `input_reference` 파일 업로드 | `input.media[]`의 `first_frame` 항목(공개 URL) | `role: "first_frame"`인 `image_url` 항목 |
| 상태 `completed` | 상태 `completed` | 상태 `succeeded` |

허용되는 길이와 해상도는 모델마다 다릅니다. Sora 2의 값을 옮기기 전에 [Wan 2.7 가이드](https://docs.laozhang.ai/ko/api-capabilities/wan-video-generation.md)의 요청 본문 절과 [Seedance 2.0 가이드](https://docs.laozhang.ai/ko/api-capabilities/seedance2-video-generation.md)의 작업 생성 절에 있는 파라미터 표를 확인하세요.

### 트래픽 전환 전 테스트

새 모델로 짧은 작업을 하나 만들고 작업 ID를 저장하세요. 성공할 때까지 조회한 뒤 MP4를 내려받아 재생되는지 확인합니다. 그다음 [호출 로그](https://api.laozhang.ai/log)에서 모델, 토큰 그룹, 청구 금액을 확인하고 운영 트래픽을 옮기세요.

## 자주 묻는 질문

### 아직 `sora-2`나 `sora-2-pro`를 호출할 수 있나요?

호출할 수 없습니다. LaoZhang API는 2026년 7월 1일에 이 경로를 종료했고, OpenAI는 2026년 9월 24일에 두 모델과 Videos API를 제거했습니다. 새 요청은 비디오를 만들지 않으니 Wan 2.7이나 Seedance 2.0을 쓰세요.

### 가격표에 `sora-2`와 `sora-2-pro`가 아직 보이는 이유는 무엇인가요?

공개 가격표에는 종료 후에도 한동안 표시될 수 있습니다. 목록에 있다고 해서 쓸 수 있는 것은 아니며, OpenAI는 두 모델을 API에서 제거했습니다. 토큰으로 어떤 모델을 호출할 수 있는지는 [모델 사용 가능 여부 확인 방법](https://docs.laozhang.ai/en/faq/model-availability.md)을 따라 확인하세요.

### 예전에 만든 비디오를 아직 내려받을 수 있나요?

지금 바로 시도하고, 필요한 비디오는 직접 사본을 보관하세요. OpenAI 다운로드 링크는 유효 기간이 짧고 업스트림의 Videos API도 제거되었으므로, 저장하지 않은 결과는 더 이상 받지 못할 수 있습니다.

### OpenAI SDK의 `videos` 코드는 그대로 두고 모델 이름만 바꿔도 되나요?

안 됩니다. Wan 2.7과 Seedance 2.0은 `/v1/videos`로 작업을 만들지 않습니다. `client.videos` 호출을 위에 나온 Wan 또는 Seedance 작업 엔드포인트 요청으로 바꾸세요. 두 가이드에 cURL과 Python 예제가 있습니다.

### 새 토큰이 필요한가요?

필요합니다. Wan 2.7은 `Wan` 그룹, Seedance 2.0은 `SeeDance2` 그룹의 토큰이 있어야 합니다. `OpenAI Official`이나 `OpenAI Official Enterprise` 토큰으로는 이 모델들을 호출할 수 없습니다.

## 보관된 레거시 경로 문서

아래 문서는 예전 Sora 2 레거시 경로(`sora_video2` 모델, 비동기 작업 큐, 캐릭터 생성)를 다룹니다. 기존 연동을 위해서만 남겨 두었으며, 예제는 더 이상 동작하지 않습니다.

* [Sora 2 비디오 API 개요](https://docs.laozhang.ai/en/api-capabilities/sora2/overview.md): 레거시 경로의 모델, 호출 방식, 업데이트 내역
* [Sora 2 모델과 가격](https://docs.laozhang.ai/en/api-capabilities/sora2/models-pricing.md): `sora_video2`, `sora-2-pro`, 캐릭터 생성의 사양과 과거 가격
* [Sora 2 동기 API 빠른 시작](https://docs.laozhang.ai/en/api-capabilities/sora2/quick-start.md): `/v1/chat/completions`를 통한 텍스트 투 비디오, 이미지 투 비디오, 스트리밍
* [Sora 2 API 레퍼런스](https://docs.laozhang.ai/en/api-capabilities/sora2/api-reference.md): 동기 API의 요청 파라미터, 응답 형식, 오류 코드
* [Sora 2 비동기 API](https://docs.laozhang.ai/en/api-capabilities/sora2/async-api.md): `/v1/videos`를 통한 작업 생성, 상태 조회, 비디오 다운로드
* [Sora 2 캐릭터 생성 API](https://docs.laozhang.ai/en/api-capabilities/sora2/character.md): 비디오에서 캐릭터를 추출해 `@username`으로 프롬프트에서 재사용
* [Sora 2 사용 예제](https://docs.laozhang.ai/en/api-capabilities/sora2/examples.md): Python, Node.js, Cherry Studio, 배치 생성 예제
* [Sora 2 자주 묻는 질문](https://docs.laozhang.ai/en/api-capabilities/sora2/troubleshooting.md): 레거시 경로의 화면 방향, 워터마크, 타임아웃, 다운로드, 과금 관련 질문

## 참고 자료와 관련 문서

* [OpenAI API 지원 중단 안내](https://developers.openai.com/api/docs/deprecations): OpenAI는 2026년 3월 24일 개발자에게 공지한 뒤, 2026년 9월 24일 다음 항목을 권장 대체 모델 없이 API에서 제거했습니다.
  * Videos API
  * 모델 `sora-2`, `sora-2-pro`
  * 스냅샷 `sora-2-2025-10-06`, `sora-2-2025-12-08`, `sora-2-pro-2025-10-06`
* [LaoZhang API 2026년 공지 보관함](https://docs.laozhang.ai/en/announcements/changelog-archive-2026.md): Sora 2 공식 API 포워딩 경로를 2026년 7월 1일부터 종료하고 유지보수하지 않는다는 2026년 6월 17일 공지
* [Wan 2.7 비디오 생성 API](https://docs.laozhang.ai/ko/api-capabilities/wan-video-generation.md), [Seedance 2.0 비디오 생성 API](https://docs.laozhang.ai/ko/api-capabilities/seedance2-video-generation.md)
* [AI 모델 API 가격표](https://docs.laozhang.ai/ko/models.md), [토큰 관리](https://api.laozhang.ai/token), [호출 로그](https://api.laozhang.ai/log)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.