seedance-2.0 API

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

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

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

프롬프트: One continuous take, no cuts. An empty indoor swimming pool at night, tiled walls and underwater lights. A swimmer in a chrome-finish suit stands on the edge and lifts both arms; the water answers by leaving the pool, rising as a single rotating column of turquoise that twists up past the roof beams and holds there, the emptied tiles glowing underneath. The camera starts low at the pool edge, cranes up alongside the column and tilts to look down into the drained basin. One hard cyan key from the underwater lights, warm sodium spill from the high windows. Real weight and inertia, spray and refraction, no text.

이 샘플을 생성한 요청

{
  "model": "seedance-2.0",
  "prompt": "One continuous take, no cuts. An empty indoor swimming pool at night, tiled walls and underwater lights. A swimmer in a chrome-finish suit stands on the edge and lifts both arms; the water answers by leaving the pool, rising as a single rotating column of turquoise that twists up past the roof beams and holds there, the emptied tiles glowing underneath. The camera starts low at the pool edge, cranes up alongside the column and tilts to look down into the drained basin. One hard cyan key from the underwater lights, warm sodium spill from the high windows. Real weight and inertia, spray and refraction, 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.0",
    "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.0
content[]	예	text, image_url, video_url 및 audio_url; role를 사용하여 미디어 목적 식별
resolution	아니요	480p / 720p / 1080p / 4k (기본값 720p)
ratio	아니요	21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16 / adaptive
duration	아니요	4~15초
generate_audio	아니요	동기화된 대화, 효과 및 배경 오디오 생성
tools	아니요	공식 모델 페이지에서 지원하는 경우에만 web_search을 사용하세요.
watermark	아니요	워터마크 추가 여부

입출력 제한

이 모델은 4~15초 지속 시간의 480p, 720p, 1080p 및 4k 출력을 지원합니다. 다중 모드 참조는 최대 9개의 이미지, 3개의 비디오, 3개의 오디오 클립을 허용합니다. 오디오는 단독으로 사용할 수 없습니다. content[]의 role 값으로 미디어를 표시합니다. 첫 번째 프레임, 편집, 확장 및 웹 검색 작업 흐름에는 고유한 제약이 있습니다. 가상 인물 이미지는 먼저 에셋 라이브러리에 업로드해야 합니다. Modelflare는 실제 인물 인증을 제공하지 않습니다.

문서화된 워크플로우 예시

Seedance 2.0 시리즈는 텍스트-비디오, 첫 번째/첫 번째 및 마지막 프레임, 다중 모달 참조, 편집, 확장 및 텍스트-비디오에 대한 웹 검색을 지원합니다. 미디어를 텍스트, 이미지, 비디오, 오디오 순서로 주문하세요.

다중 모드 참조

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0",
    "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"}
    ],
    "generate_audio": true, "ratio": "16:9", "duration": 11
  }'

영상 편집 및 웹 검색

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0", "content": [{"type": "text", "text": "Macro shot of cherry blossoms in spring"}],
    "generate_audio": true, "ratio": "16:9", "duration": 11,
    "tools": [{"type": "web_search"}]
  }'

오류 및 실패한 작업

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

지원 범위

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

가격 및 청구

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

참고

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

변형

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