seedance-2.5 API

정확한 모델 ID seedance-2.5를 사용하세요. 모델 필드는 이 페이지와 정확히 일치해야 합니다.

샘플 출력seedance-2.5POST /v1/videos5.1s

매개변수: duration=5resolution=1080pratio=16:9

프롬프트: A small research submersible descends through the deep ocean, its headlights sweeping over a drifting field of bioluminescent jellyfish and a sunken stone archway. Camera follows from behind, particles float in the beams, blue-black water, calm and mysterious, photoreal, no text.

이 샘플을 생성한 요청

{
  "model": "seedance-2.5",
  "prompt": "A small research submersible descends through the deep ocean, its headlights sweeping over a drifting field of bioluminescent jellyfish and a sunken stone archway. Camera follows from behind, particles float in the beams, blue-black water, calm and mysterious, photoreal, no text.",
  "seconds": "5",
  "duration": 5,
  "resolution": "1080p",
  "ratio": "16:9",
  "aspect_ratio": "16:9"
}

인증 및 엔드포인트

https://modelflare.dev/v1과 함께 Modelflare API 키를 사용합니다. 게이트웨이 진입점은 POST /v1/videos입니다.

HTTP

Authorization: Bearer YOUR_MODELFLARE_API_KEY

작업 생성

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5",
    "content": [{"type": "text", "text": "A white cat runs through a neon-lit street in the rain, cinematic tracking shot"}],
    "resolution": "720p",
    "duration": 5,
    "generate_audio": false
  }'

폴링 및 다운로드

작업 ID를 저장합니다. GET /v1/videos/{task_id}을 폴링하고 GET /v1/videos/{task_id}/content로 다운로드합니다. 결과 URL은 만료될 수 있으므로 즉시 파일을 전송하세요.

bash

curl https://modelflare.dev/v1/videos/TASK_ID \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY"

요청 메모

Seedance은 텍스트, 프레임 및 참조 미디어에 content[]을 사용합니다. 별도의 Seedance 자산 관리 계약이 독립적으로 문서화됩니다.

참고

가상 인물 이미지를 먼저 Seedance 에셋 라이브러리에 업로드하세요. 상태가 Active가 되면 content[]에서 asset://<ID>를 참조하세요. Modelflare는 실제 인물 인증을 제공하지 않습니다.

요청 매개변수

Seedance는 하나의 비동기 다중 모드 엔벨로프를 사용합니다. content[]에 텍스트와 미디어를 넣습니다. 미디어 역할은 첫 번째/마지막 프레임 또는 참조 워크플로를 선택합니다.

필드	필수	노트
model	예	seedance-2.5
content[]	예	text, image_url, video_url 및 audio_url; role를 사용하여 미디어 목적 식별
resolution	아니요	480p / 720p / 1080p
ratio	아니요	21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16 / adaptive
duration	아니요	-1 자동 타이밍 또는 4~30초
generate_audio	아니요	동기화된 대화, 효과 및 배경 오디오 생성
tools	아니요	공식 모델 페이지에서 지원하는 경우에만 web_search을 사용하세요.
watermark	아니요	워터마크 추가 여부
omni_reference_task_type	아니요	auto / reference / edit / extend; 편집 및 확장은 더 엄격한 비율/기간 규칙을 적용합니다.
output_format	아니요	mp4 / mov
return_last_frame	아니요	마지막 프레임을 이미지로 반환

입출력 제한

본 모델은 480p, 720p, 1080p를 지원합니다. 자동 타이밍을 위해 -1을 사용하거나 4~30초를 선택합니다. 한 요청에 최대 30개의 이미지, 10개의 비디오, 10개의 오디오 클립을 결합할 수 있습니다. 일반 참조 생성에서는 명시적인 비율 또는 adaptive을 허용합니다. 편집, 확장, 첫 번째/마지막 프레임 워크플로우에는 ratio: "adaptive"가 필요하고 편집에는 duration: -1가 필요합니다. 가상 인물 이미지는 먼저 에셋 라이브러리에 업로드해야 합니다. Modelflare는 실제 인물 인증을 제공하지 않습니다.

문서화된 워크플로우 예시

Seedance 2.5는 미디어 역할과 작업 유형에 따라 참조, 편집, 확장 및 프레임 기반 워크플로를 분류합니다. 예제에서는 Modelflare의 엔드포인트와 모델 ID를 사용하면서 공식 계약을 유지합니다.

다중 모드 참조

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5",
    "omni_reference_task_type": "reference",
    "content": [
      {"type":"text","text":"@image1 performs the movement from @video1, paced to @audio1"},
      {"type":"image_url","image_url":{"url":"https://example.com/character.jpg"},"role":"reference_image"},
      {"type":"video_url","video_url":{"url":"https://example.com/motion.mp4"},"role":"reference_video"},
      {"type":"audio_url","audio_url":{"url":"https://example.com/music.mp3"},"role":"reference_audio"}
    ],
    "ratio": "16:9", "duration": 15, "output_format": "mp4"
  }'

영상 편집

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5", "omni_reference_task_type": "edit",
    "content": [
      {"type":"text","text":"Remove the background pedestrians but preserve the main subject"},
      {"type":"video_url","video_url":{"url":"https://example.com/source.mov"},"role":"reference_video"}
    ],
    "ratio": "adaptive", "duration": -1, "output_format": "mov"
  }'

비디오 확장

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5", "omni_reference_task_type": "extend",
    "content": [{"type":"video_url","video_url":{"url":"https://example.com/source.mp4"},"role":"reference_video"}],
    "ratio": "adaptive", "duration": 11, "output_format": "mov"
  }'

첫 번째 프레임과 마지막 프레임

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5", "content": [
      {"type":"text","text":"The subject smiles while the camera makes a smooth orbit"},
      {"type":"image_url","image_url":{"url":"https://example.com/first.jpg"},"role":"first_frame"},
      {"type":"image_url","image_url":{"url":"https://example.com/last.jpg"},"role":"last_frame"}
    ],
    "ratio": "adaptive", "duration": -1, "return_last_frame": true
  }'

오류 및 실패한 작업

잘못된 모델 매개변수는 요청 ID와 함께 4xx를 반환합니다. 비동기 작업은 생성이 성공한 후 실패 상태로 들어갈 수도 있습니다. 최종 작업 사유로 폴 응답의 error_code 및 error_message을 사용합니다. 다른 JSON 형태로 동일한 요청을 재시도하지 마세요.

지원 범위

이 페이지에서는 Modelflare 모델 생성 및 편집 호출을 다룹니다. 검색 또는 지도 강화, 음성 관리 및 요소 라이브러리 관리는 이 공개 모델 호출 표면 외부의 리소스 API이며 필수 요청 필드가 아닙니다.

가격 및 청구

이 모델은 토큰 기반 청구를 사용합니다. 현재 고객 가격, 참조 정가 및 전체 사양은 모델 가격 페이지를 참조하세요.

참고

이 페이지는 Modelflare의 공개 인터페이스를 문서화합니다. 여기에 표시된 필드와 한도는 현재 계약입니다.

변형

모델 ID	차이점
seedance-2.5	이 페이지에 문서화된 모델입니다.