메인 콘텐츠로 건너뛰기
POST
/
v1
/
videos
/
generations
curl --request POST \
  --url https://api.evolink.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "wan2.7-text-to-video",
  "prompt": "달빛 아래를 달리는 작은 아기 고양이",
  "aspect_ratio": "16:9",
  "duration": 5
}
'
{
  "created": 1757169743,
  "id": "task-unified-1757169743-7cvnl5zw",
  "model": "wan2.7-text-to-video",
  "object": "video.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 120
  },
  "type": "video",
  "usage": {
    "billing_rule": "per_call",
    "credits_reserved": 5,
    "user_group": "default"
  }
}

인증

​
Authorization
string
header
필수

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

API Key 받기:

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

요청 헤더에 추가:

Authorization: Bearer YOUR_API_KEY

본문

application/json
​
model
enum<string>
필수

모델명, wan2.7-text-to-video 고정

사용 가능한 옵션:
wan2.7-text-to-video
예시:

"wan2.7-text-to-video"

​
prompt
string
필수

동영상 생성용 텍스트 프롬프트. 중국어와 영어 지원, 각 글자/문자를 1자로 카운트하며 초과분은 자동으로 잘립니다. 최대 5000자

다중 샷 내러티브: 자연어로 샷 구조 제어

  • 단일 샷: 프롬프트에 "단일 샷 동영상 생성"을 명시
  • 다중 샷: "다중 샷 동영상 생성" 또는 타임스탬프 분할 샷 리스트(예: "샷 1 [0-3초]") 사용
Maximum string length: 5000
예시:

"달빛 아래를 달리는 작은 아기 고양이"

​
negative_prompt
string

동영상에 나타나지 않기를 원하는 내용을 기술하는 네거티브 프롬프트. 중국어와 영어 지원, 최대 500자, 초과분은 자동으로 잘립니다

Maximum string length: 500
예시:

"흐림, 저품질"

​
audio_urls
string<uri>[]

구동 오디오 URL 배열(선택). 현재 1개 요소만 지원

동작:

  • 제공: 모델이 해당 오디오를 구동 소스로 사용
  • 미제공: 모델이 영상 내용에 맞는 배경음악 또는 효과음을 자동 생성

포맷 요구사항:

  • 지원 포맷: wav, mp3
  • 길이: 2 ~ 30초
  • 파일 크기: 15MB 이하

잘림 처리:

  • 오디오 길이가 duration을 초과하면 앞 N초만 사용하고 나머지는 폐기
  • 오디오 길이가 동영상 길이보다 짧으면 나머지 부분은 무음. 예: 오디오 3초, 동영상 5초인 경우 앞 3초는 유음, 뒤 2초는 무음
Required array length: 1 element
예시:
["https://example.com/audio.mp3"]
​
quality
enum<string>
기본값:720p

동영상 품질, 기본값 720p

옵션:

  • 720p: 표준 화질, 표준 가격(기본)
  • 1080p: 고화질, 가격 상승
사용 가능한 옵션:
720p,
1080p
예시:

"720p"

​
aspect_ratio
enum<string>
기본값:16:9

동영상 종횡비, 기본값 16:9

품질 등급별 출력 해상도:

품질16:99:161:14:33:4
720p1280×720720×1280960×9601104×832832×1104
1080p1920×10801080×19201440×14401648×12481248×1648
사용 가능한 옵션:
16:9,
9:16,
1:1,
4:3,
3:4
예시:

"16:9"

​
duration
number
기본값:5

동영상 길이(초), 범위 2-15

참고:

  • 2~15초 사이의 정수 값 지원
  • 최종 청구는 실제 생성된 동영상 길이를 기준으로 함
필수 범위: 2 <= x <= 15
예시:

5

​
seed
integer

랜덤 시드, 기본값은 랜덤

설명:

  • 범위: 1 ~ 2147483647
  • 시드를 고정하면 프롬프트 반복 시 변동을 줄이고 재현성을 높입니다
필수 범위: 1 <= x <= 2147483647
예시:

42

​
prompt_extend
boolean
기본값:false

프롬프트 지능 재작성 활성화 여부. 활성화 시 대형 모델이 프롬프트를 최적화하여 단순하거나 설명이 부족한 프롬프트의 결과를 크게 개선합니다.

참고: 기본값은 false입니다. 필드를 생략하거나 false를 보내면 재작성이 발생하지 않습니다. 활성화하려면 명시적으로 true를 보내세요.

예시:

false

​
callback_url
string<uri>

작업 완료 시의 HTTPS 콜백 URL

콜백 시점:

  • 작업 완료(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

작업 생성 타임스탬프

예시:

1757169743

​
id
string

작업 ID

예시:

"task-unified-1757169743-7cvnl5zw"

​
model
string

실제로 사용한 모델명

예시:

"wan2.7-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

동영상 작업 상세 정보

​
type
enum<string>

작업 출력 유형

사용 가능한 옵션:
text,
image,
audio,
video
예시:

"video"

​
usage
object

사용량 및 청구 정보