2026/09/12

Seedance 2.5 이미지 투 비디오: 프레임, 입력값, 비용

Seedance 2.5 이미지 투 비디오의 첫 프레임, 첫/마지막 프레임, 참조 이미지 사용법을 배웁니다. 유효한 API 필드, 실제 인물 입력값, 10초 비용을 확인하세요.

Seedance 2.5 이미지 투 비디오는 reAPI에서 하나의 모델 ID인 doubao-seedance-2.5-face를 사용하며, 작업 유형에 따라 다른 이미지 필드를 활용합니다. 클립이 특정 구성에서 시작되어야 할 때는 명시적 첫 프레임을, 두 끝점이 모두 중요할 때는 첫 프레임과 마지막 프레임을, 새로운 장면을 구성할 때 모델이 시각적 지침을 활용하도록 하려면 참조 이미지를 사용합니다.^[1]

이러한 구분은 제출할 JSON에 영향을 미칩니다. 프레임 역할은 size: "adaptive"이 필요하고, 참조 이미지 입력값은 선택 가능한 종횡비를 허용합니다. 이미지가 있지만 참조 비디오가 없는 10초 720p 요청의 경우, 9월 12일 가격은 크레딧 올림 후 $2.669입니다. Seedance 2.5 플레이그라운드와 API 문서에 사용 가능한 컨트롤이 공개되어 있습니다.^[1]^[2]

핵심 요약

image_with_roles을 role: "first_frame"와 함께 사용하여 특정 시각적 시작 프레임을 요청합니다. size을 adaptive로 설정합니다.^[1]
두 번째 끝점이 필요할 때 last_frame 항목 하나를 추가합니다. 마지막 프레임은 첫 프레임이 필요하며, 각 역할은 최대 한 번 나타날 수 있습니다.^[1]
참조 이미지에는 image_urls을 사용합니다. API는 최대 30개를 수락하지만 제한을 모두 채울 필요는 없습니다.^[1]
실제 인물 참조 이미지는 reAPI에서 지원되며 자동으로 검토됩니다. 조정 거부는 작업을 실패하게 하고 전액 환불됩니다.^[2]
이미지 참조는 청구 가능한 소스 초 단위를 추가하지 않습니다. 10초 720p 이미지 요청은 9월 12일 비디오 없음 단가로 2,669 크레딧이 소요됩니다.^[1]^[2]

Seedance 2.5 이미지 투 비디오 입력값 형태 선택

이미지가 제어해야 할 사항을 결정한 후 업로드 필드를 선택합니다. 시작 프레임은 초기 구성을 정의하고, 참조 이미지는 인물, 객체 또는 설정의 모습을 제공할 수 있습니다. 동일한 소스 파일을 사용하더라도 이는 다른 지시사항입니다.

목표	요청 필드	종횡비	결과에서 확인할 사항
특정 시작 구성 애니메이션화	`image_with_roles`과 `first_frame`	`adaptive`	오프닝 프레임, 요청된 모션 및 원치 않는 배경 변경
두 지정 구성 사이 이동	`image_with_roles`과 첫/마지막 역할	`adaptive`	두 끝점과 그 사이의 전환
새로운 장면에서 하나 이상의 시각적 참조 사용	`image_urls`	수용 가능한 `size` 선택	신원, 객체 모습 및 각 참조의 할당된 역할

입력값 필드와 종횡비 제약은 문서화된 API 동작입니다. 검토 열은 편집 체크리스트이지, 입력값 필드가 완벽한 시각적 보존을 보장한다는 약속이 아닙니다.^[1]

간단한 사진 애니메이션의 경우, 명시적 첫 프레임 하나와 명확한 동작 하나로 시작합니다. 목표가 새로 설명된 위치에 참조된 두 명을 배치하는 것이라면 대신 참조 이미지로 시작합니다. 어떤 종류의 컨트롤이 필요한지 알기 전에 더 많은 소스 파일을 추가하면 프롬프트와 결과를 모두 해석하기 어렵게 만듭니다.

명시적 첫 프레임 하나 애니메이션화

명시적 첫 프레임 요청은 image_with_roles를 사용합니다. 다음 cURL 예제는 공개 샘플로 이미 사용 가능한 초상화를 사용합니다. 자신의 허용된 소스 이미지로 대체하고 보고 싶은 모션을 작성합니다.

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": "The adult turns her head slightly toward the camera and gives a small natural smile. Keep the framing, hairstyle, white top and background stable. One continuous shot, no camera movement.",
    "image_with_roles": [
      {
        "url": "https://file.deepytb.com/landing/qwen-image-2/playground-input.webp",
        "role": "first_frame"
      }
    ],
    "duration": 4,
    "resolution": "480p",
    "size": "adaptive",
    "generate_audio": false
  }'

프레임이 시작 구성을 제공하므로 프롬프트는 모션에 집중할 수 있습니다. 어떤 피사체가 움직이는지, 어느 방향으로 움직이는지, 무엇이 정지된 상태로 있어야 하는지 설명합니다. 이미 보이는 세부사항을 대부분의 프롬프트에서 다시 설명하는 것을 피합니다. 단, 그 세부사항이 특히 보존하기 중요한 경우는 예외입니다.

고정 카메라 초상화의 경우, 보이지 않는 장면 부분을 노출할 큰 카메라 궤도보다는 머리나 눈 움직임이 더 간단한 첫 번째 테스트입니다. 제품 사진의 경우, 윤곽, 핸들 배치, 라벨링 및 반사를 검사합니다. 이러한 확인은 출력값을 평가하며, 모델이 이러한 세부사항을 보존하도록 강제하는 설정이 아닙니다.

제출은 작업 ID를 반환합니다. 해당 작업이 완료될 때까지 폴링한 다음 output.video_urls를 읽습니다. API 빠른 시작에서 전체 제출 및 폴링 예제를 제공합니다.^[1]

첫 프레임과 마지막 프레임 연결

열기와 끝내기 이미지 모두 중요할 때 두 개의 명시적 역할을 사용합니다. first_frame은 하나만, last_frame도 하나만 있을 수 있으며, 후자는 단독으로 전송될 수 없습니다. size: "adaptive"을 유지합니다. 출력값이 프레임 입력값의 형태를 따르기 때문입니다.^[1]

{
  "image_with_roles": [
    {
      "url": "https://your-public-storage.example/start.png",
      "role": "first_frame"
    },
    {
      "url": "https://your-public-storage.example/end.png",
      "role": "last_frame"
    }
  ],
  "size": "adaptive"
}

이는 모델, 프롬프트, 기간 및 해상도와 결합할 부분 페이로드입니다. 두 URL은 자리표시자입니다. 예제를 사용하기 전에 실제 이미지를 공개 저장소에 업로드합니다. 로컬 파일 경로나 확장명 변경은 읽을 수 있는 미디어 파일의 대체가 아닙니다.

타당한 전환을 설명하는 끝점을 선택합니다. 열기가 앉아있는 인물을 보이고 끝내기가 그 인물이 서있는 것을 보인다면, 서는 행위를 설명하고 충분한 시간을 제공합니다. 두 이미지가 옷, 방 기하학 및 카메라 위치도 변경한다면 전환에 더 많은 변경이 있습니다. 암묵적으로 그 변경의 해석을 남겨두기보다는 실제로 원하는 변경을 결정합니다.

끝점만큼 클립의 중간을 신중하게 검토합니다. 시작과 끝을 맞추는 것만으로는 충분하지 않습니다. 개입하는 모션에 점프, 왜곡된 손 또는 예상치 못한 컷이 포함될 때입니다. 전환이 개선해야 할 부분이라면, 더 많은 문체적 형용사를 추가하기 전에 동작을 수정하거나 더 가까운 끝점을 선택합니다.

각 참조 이미지에 하나의 작업 할당

몇 개의 이미지로 안내되는 새로운 구성의 경우, image_urls를 사용합니다. API는 최대 30개의 참조 이미지를 수락하며, 각각은 문서화된 파일 크기 제한 미만입니다. 이미지는 공개 HTTP(S) URL을 통해 도달 가능해야 합니다. base64 데이터 URI는 수용되지 않습니다.^[1]

{
  "model": "doubao-seedance-2.5-face",
  "prompt": "Use Image1 for the adult in white and Image2 for the adult in black. Place both in a quiet gallery. The adult in white waves once; the adult in black nods. Keep their hairstyles and outfits distinct. Fixed camera.",
  "image_urls": [
    "https://file.deepytb.com/landing/qwen-image-2/playground-input.webp",
    "https://file.deepytb.com/landing/grok-imagine-video-1-5/playground-input.png"
  ],
  "duration": 4,
  "resolution": "480p",
  "size": "16:9",
  "omni_reference_task_type": "reference",
  "generate_audio": false
}

첫 번째 샘플은 긴 머리와 흰색 상의를 입은 한 명의 성인을 보여줍니다. 두 번째는 짧은 보브와 어두운 옷을 입은 한 명의 성인의 삼면 초상화입니다. 후자를 사용할 때, 그 패널이 한 신원을 나타낸다고 지정하여 의도된 장면이 명확합니다. 20개 프롬프트 라이브러리에는 두 참조 테스트에 사용된 정확한 더 긴 프롬프트와 그 생성된 결과가 포함되어 있습니다.

image_urls과 image_with_roles을 한 요청에서 결합하지 마세요. 상호 배타적입니다. 또한 image_with_roles 내에서 명시적 프레임 역할을 reference_image 역할과 분리된 상태로 유지하세요. 문서는 이를 다른 요청 형태로 취급합니다.^[1]

명시적 프레임 이미지와 함께 video_urls 또는 audio_urls를 추가하면 이 이미지가 사용되는 방식이 변경됩니다. 요청은 다중모드 참조 작업이 됩니다. 위에서 설명한 엄격한 첫/마지막-프레임 워크플로우를 의존하기보다는 프레임을 해당 조합에서 참조 지침으로 처리합니다.^[1]

참조 집합에 여러 피사체가 포함된 경우, 소유권이 중요한 곳에서 피사체의 이름이나 시각적 레이블을 반복합니다. "흰색 옷을 입은 성인이 컵을 든다"는 두 명에 관한 단락 이후 "그녀가 그것을 든다"보다 덜 모호합니다. Image1과 Image2 레이블을 실제 입력값 순서와 정렬된 상태로 유지합니다.

실제 인물 참조 업로드 및 실패 진단

reAPI는 Seedance 2.5에 대한 실제 인물 참조 이미지 및 비디오를 지원합니다. 참조는 생성 전에 자동화된 검토를 통과하며, 거부된 자료는 전액 환불과 함께 오류를 발생시킵니다. 입력값 유형 지원은 모든 개별 파일이 수용될 것이라는 보장이 아닙니다.^[2]

사용 권한이 있는 이미지를 사용하고 제출 전에 피사체의 의도된 표현을 확인합니다. 요청이 실패하면 프롬프트를 다시 작성하기 전에 오류를 읽습니다. 접근 불가능한 URL, 잘못된 요청 필드 및 조정 거부는 다른 응답이 필요합니다.

실패	먼저 확인할 사항
소스 URL을 읽을 수 없음	로그인한 브라우저 세션 없이 직접 미디어 URL이 작동하는지 확인
요청이 이미지 필드를 거부	상호 배타성 및 첫/마지막-프레임 역할 규칙 확인
종횡비 오류	명시적 프레임 역할과 함께 `adaptive` 사용
지원되지 않는 형식	파일명이 아닌 실제 파일 인코딩 확인
조정 거부	자료 및 의도된 콘텐츠 검토, 반환된 오류 검사

실제 인물 참조 오류 가이드는 더 광범위한 문제 해결 컨텍스트를 제공합니다. 정확한 수용 가능한 파일 형식 및 검증 규칙은 현재 2.5 문서를 사용하세요.^[1]

하나의 이미지와 10초 720p 비용

이미지 전용 요청은 비디오 없음 단가를 사용합니다. 9월 12일에 그 단가는 720p에서 초당 $0.266824입니다. 따라서 10초는 ceil(0.266824 × 10 × 1000) = 2669 크레딧 또는 $2.669가 소요됩니다.^[2]

소스 비디오 없는 이미지 요청	출력값 기간	청구 가능한 합계
480p	4초	475 크레딧 / $0.475
720p	10초	2,669 크레딧 / $2.669
1080p	10초	4,619 크레딧 / $4.619

이 합계는 정확한 렌더링된 단가를 사용하고 전체 요청을 크레딧으로 올립니다. 이미지 참조는 청구 가능한 초를 추가하지 않습니다. video_urls을 추가하면 청구 계산이 참조 비디오 기간과 문서화된 최소 창을 포함하도록 변경됩니다.^[1]^[2]

입력값 모드를 비교할 때 그 구분을 유지합니다. 두 개의 이미지가 있는 프롬프트는 여전히 이 가격 질문에 대한 이미지 참조 요청입니다. 하나 이상의 소스 자산을 가지고 있다고 해서 단순히 참조 비디오 요청이 되지는 않습니다. 더 광범위한 모델 선택은 이미지 투 비디오 API 가이드를 참조하세요. 이 기사는 2.5를 선택한 후 Seedance 특정 필드 선택을 다룹니다.

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

모든 게시물