seedance-2.0-mini API

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

인증 및 엔드포인트

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

필드	필수	노트
model	예	seedance-2.0-mini
content[]	예	text, image_url, video_url 및 audio_url; role를 사용하여 미디어 목적 식별
resolution	아니요	480p / 720p (기본값 720p)
ratio	아니요	21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16 / adaptive
duration	아니요	-1 자동 타이밍 또는 4~15초
generate_audio	아니요	동기화된 대화, 효과 및 배경 오디오 생성
tools	아니요	공식 모델 페이지에서 지원하는 경우에만 web_search을 사용하세요.
watermark	아니요	워터마크 추가 여부

입출력 제한

본 모델은 480p와 720p를 지원합니다. 자동 타이밍을 위해 -1을 사용하거나 4~15초를 선택합니다. 프레임 속도는 24fps로 고정됩니다. 다중 모드 참조는 최대 9개의 이미지, 3개의 비디오, 3개의 오디오 클립을 허용합니다. 오디오는 단독으로 사용할 수 없으므로 요청에는 참조 이미지나 비디오가 하나 이상 필요합니다. content[]의 role 값으로 미디어를 표시합니다. 첫 번째 프레임, 편집 및 확장 워크플로우는 상호 배타적입니다. 이 모델은 frames, camera_fixed, output_format, omni_reference_task_type을 사용할 수 없습니다.

문서화된 워크플로우 예시

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-mini",
    "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-mini", "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의 공개 인터페이스를 문서화합니다. 여기에 표시된 필드와 한도는 현재 계약입니다.