메인 콘텐츠로 건너뛰기
POST
/
v1
/
videos
/
generations
curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "wan2.7-videoedit",
    "video_urls": ["https://cdn.example.com/original.mp4"],
    "prompt": "배경을 설산 장면으로 교체",
    "resolution": "1080P"
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01J9HA7JPQ9A0Z6JZ3V8M9W6PZ"
    }
  ]
}

curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "wan2.7-videoedit",
    "video_urls": ["https://cdn.example.com/original.mp4"],
    "prompt": "배경을 설산 장면으로 교체",
    "resolution": "1080P"
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01J9HA7JPQ9A0Z6JZ3V8M9W6PZ"
    }
  ]
}

​
인증

​
Authorization
string
필수
모든 API 엔드포인트는 Bearer Token 인증이 필요합니다API 키 받기:API 키 관리 페이지에서 API 키를 받으세요요청 헤더에 추가:
Authorization: Bearer YOUR_API_KEY

​
요청 매개변수

​
model
string
필수
동영상 생성 모델 이름. wan2.7-videoedit로 고정
​
video_urls
array<string>
필수
편집 대상 원본 동영상 URL 배열
첫 번째 동영상만 사용됩니다
동영상 제한:
  • 형식: mp4, mov
  • 길이: 2~10초
  • 해상도: 너비와 높이 모두 [240, 4096] 픽셀 범위
  • 가로세로 비율: 1:8 ~ 8:1
  • 파일 크기: 100MB 이하
​
prompt
string
편집 지시. 동영상에 어떤 변경을 가하고 싶은지 설명, 최대 5000자
전달하지 않으면 모델은 기본 스타일 전송을 수행합니다
예: "인물의 의상을 빨간 드레스로 변경", "배경을 설산 장면으로 교체"
​
negative_prompt
string
원하지 않는 내용을 설명하는 네거티브 프롬프트, 최대 500자
​
image_urls
array<string>
참조 이미지 URL 배열, 최대 4장목표 스타일 또는 외관 지정에 사용 (스타일 전송의 목표 스타일 참조 등)
​
resolution
string
기본값:"1080P"
출력 동영상 해상도옵션:
  • 720P - 표준
  • 1080P - 고화질 (기본값)
​
duration
integer
기본값:"0"
출력 동영상 길이 (초)
  • 0 (기본값): 원본 동영상의 전체 길이 유지
  • 2-10 사이의 정수: 처음부터 지정된 길이 만큼 잘라내기
duration=0일 때 출력 동영상의 실제 길이로 과금됩니다지정한 길이는 video_urls 원본 동영상의 길이를 초과할 수 없습니다
​
size
string
출력 화면 비율지원 형식:
  • 16:9 - 가로 와이드
  • 9:16 - 세로
  • 1:1 - 정사각형
  • 4:3 - 가로
  • 3:4 - 세로
전달하지 않으면 입력 동영상의 비율을 유지합니다
​
prompt_extend
boolean
기본값:"true"
프롬프트 지능 재작성 활성화 여부짧은 프롬프트에서 효과가 크지만 처리 시간이 증가합니다기본값: true
​
watermark
boolean
기본값:"false"
생성된 동영상에 “AI 생성” 워터마크 추가 여부
  • true: 워터마크 추가
  • false: 추가 안 함 (기본값)
​
seed
integer
생성 내용의 무작위성을 제어하는 시드 정수범위: ≥0의 정수
  • 동일한 요청에서 다른 seed 값을 받으면 (예: seed를 지정하지 않음) 다른 결과가 생성됩니다
  • 동일한 요청에서 동일한 seed 값을 받으면 유사한 결과가 생성되지만 완전한 일치는 보장되지 않습니다
​
metadata
object
추가 매개변수 객체

​
응답

​
code
integer
응답 상태 코드. 성공 시 200
​
data
array
응답 데이터 배열

​
사용 사례

​
사례 1: 기본 동영상 편집 (최소)

{
  "model": "wan2.7-videoedit",
  "video_urls": ["https://cdn.example.com/original.mp4"],
  "prompt": "배경을 설산 장면으로 교체"
}

​
사례 2: 스타일 전송 (참조 이미지 포함)

{
  "model": "wan2.7-videoedit",
  "prompt": "동영상 스타일을 참조 이미지의 애니메이션 풍으로 전송",
  "video_urls": ["https://cdn.example.com/original.mp4"],
  "image_urls": [
    "https://cdn.example.com/anime_style.jpg"
  ],
  "resolution": "1080P",
  "watermark": false
}

​
사례 3: 원본 동영상 오디오 유지

중요한 배경음이나 인물 대화가 있는 동영상에 적합: 
{
  "model": "wan2.7-videoedit",
  "video_urls": ["https://cdn.example.com/speech.mp4"],
  "prompt": "배경을 산길로 교체",
  "metadata": { "audio_setting": "origin" }
}

​
사례 4: 전체 매개변수

{
  "model": "wan2.7-videoedit",
  "prompt": "인물의 의상을 빨간 드레스로 변경",
  "negative_prompt": "흐림, 왜곡",
  "video_urls": ["https://cdn.example.com/original.mp4"],
  "image_urls": ["https://cdn.example.com/reference.jpg"],
  "resolution": "1080P",
  "duration": 0,
  "size": "16:9",
  "prompt_extend": true,
  "watermark": false,
  "seed": 888,
  "metadata": {
    "audio_setting": "origin"
  }
}

​
오디오 처리 설명

audio_setting설명적용 시나리오
auto (기본값)편집된 동영상 내용에 따라 AI가 일치하는 오디오를 재생성시각 스타일이 크게 변하고 오디오도 동기화하여 업데이트하고 싶은 경우
origin원본 동영상 오디오 트랙을 강제 유지중요한 배경음악, 인물 대화가 있는 동영상
작업 결과 조회동영상 생성은 비동기 작업으로, 제출 후 task_id가 반환됩니다. 작업 상태 조회 엔드포인트를 사용하여 생성 진행 상황과 결과를 조회하세요.