Seedance 2.5 API 빠른 시작: 첫 영상 요청

reAPI에서 Seedance 2.5 API를 호출하려면 API 키를 만들고, /api/v1/videos/generations에 model: "doubao-seedance-2.5-face"을 포함한 요청을 보낸 후, 반환된 id을 폴링합니다. 완료된 작업에는 영상 URL이 포함됩니다. 텍스트, 이미지, 첫/마지막 프레임 및 멀티모달 참조 요청에 모두 동일한 모델 id를 사용합니다.^[1]

4초 텍스트 요청부터 시작하면 업로드된 파일이 없어 진단이 간단합니다. 9월 12일 기준으로 480p에서 참조 영상 없이 초당 $0.118589 요금으로, 해당 요청 비용은 475 크레딧 또는 크레딧 올림 후 $0.475입니다. Seedance 2.5 모델 페이지에서 현재 요금표를 보고 동일한 설정으로 플레이그라운드에서 확인할 수 있습니다.^[2]

요약

API Keys에서 Bearer 키를 만든 후 model: "doubao-seedance-2.5-face"를 보냅니다. 페이지 슬러그 seedance-2-5는 요청의 모델 id가 아닙니다.^[1]
한 번 제출하고, 응답 id를 저장한 후 /api/v1/tasks/{id}를 폴링합니다. 성공한 POST는 작업을 시작합니다. 영상이 준비됐다는 뜻이 아닙니다.^[1]
duration는 4–30초 범위에서 선택하고, resolution은 480p, 720p 또는 1080p에서 선택합니다. 예측 가능한 초기 예약을 위해 고정 기간을 사용하세요.^[1]
명시적 첫/마지막 프레임 입력을 위해 size: "adaptive"을 설정하세요. 출력은 프레임 모양을 따릅니다.^[1]
10초 720p 요청(참조 영상 없음)은 9월 12일 요금으로 2,669 크레딧, 즉 $2.669입니다. 참조 영상을 사용하는 요청은 출력 시간 외의 요소도 청구 시간에 반영됩니다.^[1]^[2]

Seedance 2.5 API 키 만들기 및 첫 요청 준비

reAPI에 로그인하고, API Keys를 열어 생성에 비용을 지불할 워크스페이스용 키를 만듭니다. 이를 REAPI_API_KEY라는 로컬 환경 변수에 복사합니다. 키를 브라우저 JavaScript, 공개 저장소, 스크린샷에서 보호하세요. 요청은 Authorization: Bearer ... 헤더를 통해 인증됩니다. 문서화된 워크플로는 별도의 프로젝트 헤더가 필요하지 않습니다.^[1]

또한 요청의 초기 예약에 충분한 크레딧이 필요합니다. 적격 계정에 제공되는 프로모션 크레딧은 특정 영상에 완전히 자금을 지원할 수 있는지와 별개입니다. 계정에 표시된 금액을 확인하세요. 이 튜토리얼은 자금이 지원되는 계정을 가정하며 무료 생성을 보장하지 않습니다.^[2]

첫 요청은 작게 유지하세요. 프롬프트, 고정 기간, 종횡비 및 해상도로 텍스트 요청에 충분합니다. 제출 및 폴링 경로가 작동한 후 이미지나 소리를 추가하세요. 이렇게 하면 실패한 첫 시도를 더 쉽게 진단할 수 있습니다. 접근할 수 없는 참조 URL이나 호환되지 않는 소스 파일로 인해 발생할 수 없기 때문입니다.

첫 cURL 요청 보내기 및 작업 id 보관

REAPI_API_KEY가 이미 셸에 설정되어 있으면 이 요청을 제출합니다:

curl --fail-with-body https://reapi.ai/api/v1/videos/generations \
  -H "Authorization: Bearer $REAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2.5-face",
    "prompt": "A matte cobalt ceramic mug stands on an ivory turntable. One continuous studio shot. Over four seconds the turntable rotates clockwise by about 45 degrees. The camera stays fixed at mug height. Keep the handle, rim and glaze consistent. Soft side light, plain background, no text or logos.",
    "duration": 4,
    "size": "16:9",
    "resolution": "480p",
    "generate_audio": false,
    "return_last_frame": true
  }'

응답의 id를 다른 모든 작업을 수행하기 전에 저장하세요. 해당 식별자는 이 생성에 속하며 후속 GET 요청에 사용하는 값입니다. 모델 id, 파일 URL 또는 추측한 식별자로 바꾸지 마세요. 응답에는 작업 상태도 포함되어 있습니다. 작업이 완료되면 영상 URL이 표시됩니다.^[1]

예제는 영상뿐 아니라 마지막 프레임 이미지도 요청합니다. 독립 실행 클립의 경우 해당 이미지를 무시하거나, 나중에 샷을 체이닝할 때 사용할 수 있습니다. 동일한 프롬프트와 설정은 우리의 테스트된 프롬프트 라이브러리에 포함되어 있으며, 표현을 품질 보장으로 취급하는 대신 생성된 결과를 검사할 수 있습니다.

Python에서 Seedance 2.5 API 작업 제출 및 폴링

아래 Python 예제는 cURL 예제의 대안입니다. 새 영상 작업을 만들고 해당 작업을 폴링합니다. 첫 테스트를 위해 제출 방법 중 하나를 선택하세요. 두 예제를 모두 실행하면 두 개의 유료 생성이 발생합니다.

스크립트는 로컬에서 최대 30분 동안 대기합니다. 해당 시간 제한은 클라이언트 정책 예제이지, 약속된 생성 시간이 아닙니다. 자동으로 다른 작업을 시작하는 대신 HTTP 오류를 보고합니다. 실행하기 전에 requests을 설치하고 REAPI_API_KEY을 설정하세요.

import os
import time
import requests

BASE = "https://reapi.ai/api/v1"
headers = {"Authorization": f"Bearer {os.environ['REAPI_API_KEY']}"}
payload = {
    "model": "doubao-seedance-2.5-face",
    "prompt": "A ceramic mug on a table. Locked camera, soft daylight.",
    "duration": 4,
    "resolution": "480p",
    "size": "16:9",
    "generate_audio": False,
}

submitted = requests.post(
    f"{BASE}/videos/generations",
    headers=headers,
    json=payload,
    timeout=120,
)
submitted.raise_for_status()
task_id = submitted.json()["id"]
print("Save this task id:", task_id, flush=True)

deadline = time.monotonic() + 30 * 60
while time.monotonic() < deadline:
    response = requests.get(
        f"{BASE}/tasks/{task_id}", headers=headers, timeout=60
    )
    if response.status_code in (429, 500, 502, 503, 504):
        time.sleep(10)
        continue
    response.raise_for_status()
    task = response.json()
    if task["status"] == "completed":
        for url in task["output"]["video_urls"]:
            print(url)
        break
    if task["status"] == "failed":
        raise RuntimeError(task.get("error"))
    time.sleep(10)
else:
    raise TimeoutError(f"Resume polling existing task {task_id}")

폴링은 생성 크레딧을 소비하지 않습니다. 로컬 프로세스가 시간 초과되면 저장된 id를 유지하고 해당 작업에 대해 GET 요청을 계속합니다. 로컬 시간 초과만으로는 원격 생성이 실패했다는 것을 증명하지 못합니다. 마찬가지로 응답을 받기 전에 POST 연결이 끊어지면 동일한 작업을 다시 제출하기 전에 작업 기록을 확인하세요.^[1]

서비스 통합의 경우 제출 직후 작업 id를 자신의 데이터베이스에 유지하세요. 중요한 구분은 기존 작업의 읽기를 다시 시도하는 것과 새 작업을 만드는 것 사이입니다. 후자는 다른 생성 요청입니다.

미디어 필드를 통해 4가지 입력 모드 선택

미디어 필드는 요청 형태를 선택합니다. 이 표를 Seedance 2.5 API 문서와 함께 사용하세요.^[1]

의도한 요청	보낼 필드	기억할 제약 사항
텍스트에서 영상으로	`prompt`	텍스트 전용 요청에는 프롬프트가 필요합니다
참조 이미지에서 영상으로	`image_urls` 및 모션 프롬프트	공개 이미지 URL; 최대 30개 이미지
명시적 첫 또는 첫/마지막 프레임	`image_with_roles`	`size: "adaptive"` 사용; 마지막 프레임에는 첫 프레임이 필요합니다
멀티모달 참조	`image_urls`, `video_urls` 및/또는 `audio_urls`	각 미디어 유형에는 자체 파일 및 기간 제한이 있습니다

예를 들어, 텍스트 전용 페이로드의 이미지 입력을 명시적 첫 프레임으로 바꿉니다:

{
  "image_with_roles": [
    {
      "url": "https://file.deepytb.com/landing/qwen-image-2/playground-input.webp",
      "role": "first_frame"
    }
  ],
  "size": "adaptive"
}

이 블록은 전체 요청에 병합할 필드를 보여 주며, 완전한 POST 본문이 아닙니다. 샘플을 사용 권한이 있는 이미지로 바꾸세요. image_urls와 image_with_roles을 함께 보내지 마세요. 상호 배타적입니다. 프레임 역할과 reference_image 역할을 같은 배열에서 혼합하지 마세요.^[1]

영상 입력의 경우 소스 클립은 2–30초 길이여야 하며, 최대 10개 클립과 총 30초를 넘지 않아야 합니다. 오디오는 최대 10개 트랙과 결합된 총 30초의 별도 제한이 있습니다. 더 많은 파일이 자체적으로 요청을 더 많이 제어하지는 않습니다. 각 참조에 프롬프트에서 명확한 역할을 할당하세요.^[1]

완벽한 연속성을 가정하지 않고 마지막 프레임 체이닝

첫 요청에서 return_last_frame: true을 설정하세요. 해당 작업이 완료되면 output.last_frame_url를 읽고 해당 URL을 image_with_roles 배열의 다음 요청에 role: "first_frame"을 포함하여 배치합니다. size: "adaptive"를 다시 사용하세요.^[1]

피사체, 의류, 배경 및 의도한 다음 동작에 대한 관련 설명을 계속 진행하세요. 공유 경계 이미지는 다음 샷에 시각적 시작점을 제공합니다. 이후 프레임이 모든 세부 사항을 보존할 것임을 증명하지는 않습니다. 두 샷을 하나의 시퀀스로 사용하기 전에 연결 지점을 확인하세요. 특히 움직이는 손, 시선 방향, 배경 물체를 살펴보세요.

영상 편집은 다른 요청 형태입니다. 명시적 omni_reference_task_type: "edit"에는 소스 영상, 적응형 크기 및 자동 기간이 필요합니다. 단순히 사진을 안내로 사용하는 새 장면에는 적합한 설정이 아닙니다. 첫 통합을 일반 생성 경로에 유지한 다음 기존 클립을 수정해야 할 때 편집을 추가하세요.^[1]

소스 영상을 추가하기 전에 요청 비용 계산

참조 영상이 없는 요청의 경우, 초당 단가에 출력 기간을 곱하고, 달러를 크레딧으로 변환한 후 전체 크레딧으로 올림합니다. 1 크레딧은 $0.001입니다.^[1]

요청	9월 12일 단가	계산	지불 총액
4초, 480p, 참조 영상 없음	$0.118589/s	`ceil(0.118589 × 4 × 1000)`	475 크레딧 / $0.475
10초, 720p, 참조 영상 없음	$0.266824/s	`ceil(0.266824 × 10 × 1000)`	2,669 크레딧 / $2.669
10초 출력, 3초 참조 영상, 720p	$0.160094/s	`ceil(0.160094 × 17 × 1000)`	2,722 크레딧 / $2.722

마지막 행은 17초로 청구됩니다. 영상 입력 요청은 출력에 올림된 소스 기간을 더한 값과 ceil(5 × output / 3) 중 더 큰 값을 사용하기 때문입니다. 더 낮은 참조 영상 단가가 반드시 더 낮은 최종 요금을 의미하지는 않습니다. 이미지 및 오디오 참조는 소스 초를 추가하지 않습니다.^[1]^[2]

자동 기간 duration: -1은 30초 한도에 맞춰 예약하고 나중에 전달된 길이로 확정됩니다. 예약을 작게 유지해야 할 때 고정 기간을 사용하세요. 더 광범위한 플랫폼 비교의 경우 API 요금 가이드를 참조하세요.

reAPI. Seedance 2.5 API — Parameters, Modes & Billing. 2026년 9월 12일에 브라우저에서 확인. reapi.ai/docs/seedance-2-5.
reAPI. Seedance 2.5 model page, rendered pricing table and FAQ. 2026년 9월 12일에 브라우저에서 확인. reapi.ai/models/seedance-2-5.