curl --request POST \
  --url https://api.evolink.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "seedance-2.5-text-to-video",
  "prompt": "A macro lens focuses on a green glass frog on a leaf. The focus gradually shifts from its smooth skin to its completely transparent abdomen, where a bright red heart is beating powerfully and rhythmically.",
  "duration": 8,
  "quality": "720p",
  "aspect_ratio": "16:9",
  "generate_audio": true,
  "content_filter": true
}
'

{
  "created": 1761313744,
  "id": "task-unified-1774857405-abc123",
  "model": "seedance-2.5-text-to-video",
  "object": "video.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 165,
    "video_duration": 8
  },
  "type": "video",
  "usage": {
    "billing_rule": "per_second",
    "credits_reserved": 50,
    "user_group": "default"
  }
}

{
  "error": {
    "code": "invalid_parameter",
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or expired token",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": "insufficient_quota",
    "message": "Insufficient quota. Please top up your account.",
    "type": "insufficient_quota"
  }
}

{
  "error": {
    "code": "model_access_denied",
    "message": "Token does not have access to model: seedance-2.5-reference-to-video",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests, please try again later",
    "type": "rate_limit_error"
  }
}

{
  "error": {
    "code": "internal_error",
    "message": "Internal server error",
    "type": "api_error"
  }
}

Seedance 2.5

Seedance 2.5 전체 파라미터 가이드

🚧 이 모델은 아직 제공되지 않습니다. 기대해 주세요

Seedance 2.5 전체 시리즈 통합 API로, model 파라미터를 통해 특정 모델을 선택합니다

3가지 생성 모드:

Text-to-Video: 순수 텍스트 설명으로 비디오 생성, 웹 검색 강화 지원
Image-to-Video: 1~2장의 이미지를 첫/끝 프레임으로 사용하여 비디오 생성
Reference-to-Video: 이미지 + 비디오 + 오디오 멀티모달 소재 혼합 참조
AIGC 유형 실사 소재 지원
비동기 처리 모드로, 반환된 작업 ID를 사용하여 조회하세요
생성된 비디오 링크는 24시간 동안 유효하며, 가능한 빨리 저장하세요

POST

videos

generations

curl --request POST \
  --url https://api.evolink.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "seedance-2.5-text-to-video",
  "prompt": "A macro lens focuses on a green glass frog on a leaf. The focus gradually shifts from its smooth skin to its completely transparent abdomen, where a bright red heart is beating powerfully and rhythmically.",
  "duration": 8,
  "quality": "720p",
  "aspect_ratio": "16:9",
  "generate_audio": true,
  "content_filter": true
}
'

{
  "created": 1761313744,
  "id": "task-unified-1774857405-abc123",
  "model": "seedance-2.5-text-to-video",
  "object": "video.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 165,
    "video_duration": 8
  },
  "type": "video",
  "usage": {
    "billing_rule": "per_second",
    "credits_reserved": 50,
    "user_group": "default"
  }
}

{
  "error": {
    "code": "invalid_parameter",
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or expired token",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": "insufficient_quota",
    "message": "Insufficient quota. Please top up your account.",
    "type": "insufficient_quota"
  }
}

{
  "error": {
    "code": "model_access_denied",
    "message": "Token does not have access to model: seedance-2.5-reference-to-video",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests, please try again later",
    "type": "rate_limit_error"
  }
}

{
  "error": {
    "code": "internal_error",
    "message": "Internal server error",
    "type": "api_error"
  }
}

인증

Authorization

string

header

필수

##모든 API는 Bearer Token 인증이 필요합니다##

API Key 얻기:

API Key 관리 페이지에서 API Key를 받으세요

요청 헤더에 다음을 추가하세요:

Authorization: Bearer YOUR_API_KEY

본문

application/json

model

enum<string>

필수

비디오 생성 모델 이름

모델 ID	모드	입력 소재
`seedance-2.5-text-to-video`	Text-to-Video	`prompt`
`seedance-2.5-image-to-video`	Image-to-Video	`prompt` + `image_urls`
`seedance-2.5-reference-to-video`	Reference-to-Video	`prompt` + `image_urls` / `video_urls` / `audio_urls`

사용 가능한 옵션:

seedance-2.5-text-to-video,

seedance-2.5-image-to-video,

seedance-2.5-reference-to-video

예시:

"seedance-2.5-text-to-video"

prompt

string

필수

생성할 비디오를 설명하는 텍스트 프롬프트. 중국어와 영어를 지원하며, 중국어는 500자 이내, 영어는 1000단어 이내를 권장합니다. 프롬프트 최대 길이: 10000 tokens

모델별 prompt 사용법:

Text-to-Video: 순수 텍스트 설명, prompt에서 image_urls, video_urls, audio_urls 사용 불가
Image-to-Video: 순수 텍스트 설명, prompt에서 video_urls, audio_urls 사용 불가
Reference-to-Video: 입력 소재를 참조할 때는 @image1, @video1, @audio1과 같은 명시적 태그를 우선 사용하세요. 태그 번호는 해당 URL 배열의 순서를 따르며 1부터 시작합니다. 자연어 번호도 인식될 수 있지만, 명시적 태그를 사용하면 각 소재와 용도를 더 명확하게 연결할 수 있습니다

예시:

"Use the first-person perspective framing of @video1 throughout, and use @audio1 as background music throughout. First-person perspective fruit tea promotional video..."

image_urls

string<uri>[]

이미지 URL 배열

적용 모델 및 수량 제한:

Text-to-Video: ❌ 지원하지 않음
Image-to-Video: ✅ 필수, 1~2장
Reference-to-Video: ✅ 선택, 1~30장

Image-to-Video 이미지 동작:

이미지 수	동작	역할
1장	첫 프레임 이미지-투-비디오	자동으로 `first_frame`으로 설정
2장	첫/끝 프레임 이미지-투-비디오	첫 번째 → `first_frame`, 두 번째 → `last_frame`

Reference-to-Video 이미지 역할:

스타일 참조, 제품 이미지, 인물 이미지, 첫/끝 프레임(prompt로 지정)

필수 조건: image_urls, video_urls, audio_urls 중 하나 이상을 제공해야 합니다.

이미지 요구사항:

지원 형식: .jpeg, .png, .webp
화면 비율(너비/높이): 0.4 ~ 2.5
너비/높이 픽셀: 300 ~ 6000 px
단일 파일 크기: 30MB 이하
요청 본문 총 크기 64MB 이하
첫/끝 프레임 입력 시 두 이미지가 동일할 수 있습니다. 화면 비율이 다를 경우 첫 프레임 기준으로, 끝 프레임은 자동 크롭 적용
이미지 URL은 서버에서 직접 접근 가능해야 합니다

Required array length: 1 - 30 elements

예시:

[
  "https://example.com/ref1.jpg",
  "https://example.com/ref2.jpg"
]

video_urls

string<uri>[]

참조 비디오 URL 배열, 선택 사항이며 제공 시 1~10개

Reference-to-Video 모델에만 적용, 다른 모델은 이 파라미터를 지원하지 않습니다

필수 조건: image_urls, video_urls, audio_urls 중 하나 이상을 제공해야 합니다.

역할 설명:

미디어 유형	역할	일반적인 용도
비디오	`reference_video`	카메라 워크 참조, 동작 참조, 편집/연장할 원본 비디오

비디오 요구사항:

지원 형식: .mp4, .mov
해상도: 480p, 720p, 1080p, 4K
단일 비디오 길이: 2 ~ 30초, 최대 10개, 모든 비디오 총 길이 <= 30초
화면 비율(너비/높이): 0.4 ~ 2.5
너비/높이 픽셀: 300 ~ 6000 px
화면 픽셀(너비 x 높이): 409,600 ~ 8,295,044(예: 640x640 ~ 3326x2494)
단일 파일 크기: 200MB 이하
프레임 레이트: 24 ~ 60 FPS
요청 본문 총 크기 64MB 이하, Base64 인코딩을 사용하지 마세요
코덱, 해상도 등 소재의 유효성은 업스트림 모델에서 추가로 확인됩니다
비디오 참조 사용 시 추가 비용이 발생합니다(입력 비디오 길이가 과금에 포함)
비디오 URL은 서버에서 직접 접근 가능해야 합니다

Required array length: 1 - 10 elements

예시:

["https://example.com/reference.mp4"]

audio_urls

string<uri>[]

참조 오디오 URL 배열, 선택 사항이며 제공 시 1~10개

Reference-to-Video 모델에만 적용, 다른 모델은 이 파라미터를 지원하지 않습니다

필수 조건: image_urls, video_urls, audio_urls 중 하나 이상을 제공해야 합니다.

역할 설명:

미디어 유형	역할	일반적인 용도
오디오	`reference_audio`	배경 음악, 효과음, 음성/대사 참조

오디오 요구사항:

지원 형식: .wav, .mp3
단일 오디오 길이: 2 ~ 30초, 최대 10개, 모든 오디오 총 길이 <= 30초
단일 파일 크기: 15MB 이하
요청 본문 총 크기 64MB 이하, Base64 인코딩을 사용하지 마세요
오디오 URL은 서버에서 직접 접근 가능해야 합니다

Required array length: 1 - 10 elements

예시:

["https://example.com/bgm.mp3"]

duration

integer

기본값:5

출력 비디오 길이(초), 기본값은 5초

설명:

4~30초 사이의 임의의 정수값을 지원합니다
재생 시간은 과금에 직접적으로 영향을 미칩니다

전체 3개 모델에 적용

필수 범위: 4 <= x <= 30

예시:

10

quality

enum<string>

기본값:720p

비디오 해상도, 기본값은 720p

선택 가능한 값:

480p: 낮은 해상도, 낮은 가격
720p: 표준 해상도, 기본값

전체 3개 모델에 적용

사용 가능한 옵션:

480p,

720p

예시:

"720p"

aspect_ratio

enum<string>

기본값:adaptive

비디오 화면 비율, 기본값은 adaptive

선택 가능한 값:

16:9(가로), 9:16(세로), 1:1(정사각형), 4:3, 3:4, 21:9(울트라와이드)
adaptive: 최적의 비율을 자동 선택

adaptive 모델별 동작:

Text-to-Video: 프롬프트 내용에 따라 자동 선택
Image-to-Video: 첫 프레임 이미지 화면 비율에 따라 자동 적용
Reference-to-Video: 우선순위: 비디오 소재 비율 > 이미지 소재 비율 > 프롬프트 추론

각 해상도별 픽셀 값:

화면 비율	480p	720p
16:9	854×480	1280×720
4:3	752×560	1112×834
1:1	640×640	960×960
3:4	560×752	834×1112
9:16	480×854	720×1280
21:9	992×432	1470×630

전체 3개 모델에 적용

사용 가능한 옵션:

16:9,

9:16,

1:1,

4:3,

3:4,

21:9,

adaptive

예시:

"16:9"

generate_audio

boolean

기본값:true

동기화된 오디오 생성 여부, 기본값은 true

true: 비디오에 동기화된 오디오(음성, 효과음, 배경 음악)가 포함되며, 추가 요금이 없습니다
false: 무음 비디오 출력

전체 3개 모델에 적용

예시:

true

content_filter

boolean

기본값:true

콘텐츠 필터, 기본값은 true

선택 가능한 값:

true: 표준 콘텐츠 안전 검사, 기본값입니다
false: 콘텐츠 제한을 완화하며 +10%(1.1x)가 청구됩니다. 불법 및 금지된 콘텐츠는 이 설정과 관계없이 항상 적용됩니다

예시:

true

model_params

object

모델 확장 파라미터

Text-to-Video 모델에만 적용

Show child attributes

callback_url

string<uri>

작업 완료 후 HTTPS 콜백 주소

콜백 시점:

작업 완료(completed), 실패(failed) 또는 취소(cancelled) 시 트리거
과금 확인 완료 후 전송

보안 제한:

HTTPS 프로토콜만 지원
내부 네트워크 IP 주소로의 콜백 금지(127.0.0.1, 10.x.x.x, 172.16-31.x.x, 192.168.x.x 등)
URL 길이는 2048자를 초과할 수 없습니다

콜백 메커니즘:

타임아웃: 10초
실패 시 최대 3회 재시도(실패 후 각각 1/2/4초 후 재시도)
콜백 응답 본문 형식은 작업 조회 API 반환 형식과 동일
2xx 상태 코드를 성공으로 간주하며, 다른 상태 코드는 재시도를 트리거합니다

예시:

"https://your-domain.com/webhooks/video-task-completed"

응답

비디오 생성 작업이 성공적으로 생성되었습니다

created

integer

작업 생성 타임스탬프

예시:

1761313744

string

작업 ID

예시:

"task-unified-1774857405-abc123"

model

string

실제 사용된 모델 이름

예시:

"seedance-2.5-text-to-video"

object

enum<string>

작업의 구체적 유형

사용 가능한 옵션:

video.generation.task

progress

integer

작업 진행률 (0-100)

필수 범위: 0 <= x <= 100

예시:

0

status

enum<string>

작업 상태

사용 가능한 옵션:

pending,

processing,

completed,

failed

예시:

"pending"

task_info

object

비디오 작업 상세 정보

Show child attributes

type

enum<string>

작업의 출력 유형

사용 가능한 옵션:

text,

image,

audio,

video

예시:

"video"

usage

object

사용량 및 과금 정보

Show child attributes

이미지 시리즈

비디오 시리즈

오디오 시리즈

텍스트 시리즈

계정 관리

작업 관리

파일 관리

Seedance 2.5 전체 파라미터 가이드

인증

본문

응답