메인 콘텐츠로 건너뛰기
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": "viduq3",
    "prompt": "Santa Claus and the bear hug by the lakeside",
    "image_urls": [
      "https://example.com/santa.png",
      "https://example.com/bear.png"
    ],
    "duration": 8,
    "resolution": "720p",
    "aspect_ratio": "16:9"
  }'

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

curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "viduq3",
    "prompt": "Santa Claus and the bear hug by the lakeside",
    "image_urls": [
      "https://example.com/santa.png",
      "https://example.com/bear.png"
    ],
    "duration": 8,
    "resolution": "720p",
    "aspect_ratio": "16:9"
  }'

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

​
인증

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

​
요청 매개변수

​
model
string
필수
비디오 생성 모델 이름지원 모델:
  • viduq3-mix - 종합 화질왕, 스마트 전환 더 강력, 1초 짧은 비디오 지원
  • viduq3 - 기본 추천, 카메라 전환이 더 스마트
선택 방법: 일상적인 사용에는 viduq3, 고화질이나 1-2초 모션 이펙트에는 viduq3-mix를 사용하세요.
​
prompt
string
필수
텍스트 프롬프트, 최대 5000자동작과 카메라 움직임을 설명하고, 외모는 설명하지 마세요 (외모는 참조 이미지에서 결정됩니다).예시: "Santa Claus and the bear hug by the lakeside"
​
image_urls
array<url>
필수
참조 이미지 URL 배열, 1-7장공개 접근 가능한 이미지 URL (http:// 또는 https://) 지원예시: ["https://example.com/santa.png", "https://example.com/bear.png"]
  • 수량: 1-7장
  • 지원 형식: PNG, JPEG, JPG, WebP
  • 최소 크기: 128×128
  • 화면 비율: 1:4 ~ 4:1 범위
  • 개당 크기: ≤ 50MB
  • 공개 접근 가능한 URL이어야 합니다
​
duration
integer
기본값:"5"
비디오 길이 (초)
  • viduq3-mix: 1에서 16
  • viduq3: 3에서 16
기본값: 5
viduq3는 최소 3초, viduq3-mix는 최소 1초를 지원합니다. 선택한 모델에 따라 유효한 길이를 전달해주세요.
​
resolution
string
기본값:"720p"
비디오 해상도
  • viduq3-mix: 720p (기본값) / 1080p
  • viduq3: 540p / 720p (기본값) / 1080p
viduq3-mix는 540p를 지원하지 않습니다. 720p 또는 1080p를 사용해주세요.
​
aspect_ratio
string
기본값:"16:9"
비디오 화면 비율옵션:
  • 16:9 - 가로 (기본값)
  • 9:16 - 세로
  • 4:3 - 전통형
  • 3:4 - 세로 전통형
  • 1:1 - 정사각형
​
seed
integer
생성 랜덤성을 제어하는 랜덤 시드미지정 시 랜덤으로 생성됩니다.
동일한 매개변수에서 동일한 seed 값을 사용하면 유사한 결과가 생성되지만, 완전히 동일하다는 보장은 없습니다.

​
모델 비교

특징viduq3viduq3-mix
추천 시나리오일상 사용, 멀티 앵글 카메라 전환고화질, 1-2초 모션 이펙트
길이 범위3-16초1-16초
해상도540p / 720p / 1080p720p / 1080p
참조 이미지 수1-7장1-7장

​
응답

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

​
사용 시나리오

​
시나리오 1: viduq3 기본 참조 이미지-투-비디오

{
  "model": "viduq3",
  "prompt": "Santa Claus and the bear hug by the lakeside",
  "image_urls": [
    "https://example.com/santa.png",
    "https://example.com/bear.png"
  ]
}

​
시나리오 2: viduq3-mix 고화질 참조 이미지-투-비디오

{
  "model": "viduq3-mix",
  "prompt": "A cyberpunk neon street with the cat from reference image walking by",
  "image_urls": [
    "https://example.com/cat-1.png",
    "https://example.com/cat-2.png",
    "https://example.com/cat-3.png"
  ],
  "duration": 8,
  "resolution": "1080p",
  "aspect_ratio": "16:9",
  "seed": 42
}
작업 결과 조회비디오 생성은 비동기 작업으로, 제출 시 task_id가 반환됩니다. 작업 상태 가져오기 엔드포인트를 사용하여 생성 진행 상황과 결과를 조회할 수 있습니다.