메인 콘텐츠로 건너뛰기
POST
https://api.apimart.ai
/
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": "sora-2",
    "prompt": "석양에 해안에 부딪치는 파도",
    "duration": 10,
    "aspect_ratio": "16:9",
    "image_urls": ["https://cdn.apimart.ai/doc/9998238782946594-f62f70ce-348c-4b13-bb5f-15f17bee676b-image_task_01K88BEGZHVJWJ3ZV6HY99SWQR_0.png"]
  }'

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

curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "sora-2",
    "prompt": "석양에 해안에 부딪치는 파도",
    "duration": 10,
    "aspect_ratio": "16:9",
    "image_urls": ["https://cdn.apimart.ai/doc/9998238782946594-f62f70ce-348c-4b13-bb5f-15f17bee676b-image_task_01K88BEGZHVJWJ3ZV6HY99SWQR_0.png"]
  }'

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

​
인증

​
Authorization
string
required
모든 API 엔드포인트에는 Bearer Token 인증이 필요합니다API 키 가져오기:API 키 관리 페이지를 방문하여 API 키를 가져오세요요청 헤더에 추가:
Authorization: Bearer YOUR_API_KEY

​
본문

​
model
string
default:"sora-2"
required
비디오 생성 모델 이름지원되는 모델:
  • sora-2 - 표준 버전
  • sora-2-pro - 프로페셔널 버전, 더 긴 재생 시간 지원
예시: "sora-2" 또는 "sora-2-pro"
​
prompt
string
required
비디오 생성을 위한 텍스트 설명💡 @캐릭터 참조 기능:프롬프트에서 @username 형식을 사용하여 이전에 생성한 캐릭터를 참조하고 생성된 비디오에 포함시킬 수 있습니다.
  • 캐릭터의 username은 캐릭터 조회 API에서 얻을 수 있습니다
  • 여러 캐릭터를 동시에 참조 가능
예시: "고양이와 강아지가 함께 차를 운전하고 있다 @duksvfkf.cruisingki @zdqwahgj.baronbarki"
​
duration
integer
비디오 길이(초)
  • sora-2: 10초 또는 15초 지원
  • sora-2-pro: 15초 (HD) 또는 25초 지원
예시: 10
​
aspect_ratio
string
비디오 해상도지원 형식:
  • 16:9 (가로)
  • 9:16 (세로)
​
image_urls
array
이미지-비디오 생성을 위한 참조 이미지 URL 배열💡 빠른 입력 (Try it 영역):
  1. ”+ Add an item”을 클릭하여 이미지 URL 추가
  2. 이미지의 전체 URL 주소 입력
​
watermark
boolean
default:"false"
생성된 비디오에 워터마크를 추가할지 여부
  • false：워터마크를 추가하지 않음
  • true：비디오에 Sora 공식 워터마크 추가
기본값: false
​
thumbnail
boolean
비디오 썸네일 생성 여부
  • true：미리보기 및 표시용 비디오 썸네일 생성
썸네일이 필요하지 않은 경우 이 매개변수를 생략할 수 있습니다
​
private
boolean
default:"false"
개인정보 보호 모드 활성화 여부
  • true：비디오가 게시되지 않으며 remix 작업(재편집)을 할 수 없습니다
  • false：비디오를 게시하고 remix할 수 있습니다
기본값: false
​
style
string
비디오 스타일지원되는 값:
  • thanksgiving - 추수감사절 스타일
  • comic - 만화 스타일
  • news - 뉴스 스타일
  • selfie - 셀카 스타일
  • nostalgic - 노스탤지어/레트로 스타일
  • anime - 애니메이션 스타일
예시: "anime"
​
storyboard
boolean
스토리보드를 사용하여 비디오 생성 세부 사항을 더 세밀하게 제어할지 여부
  • true：스토리보드 기능 활성화
  • false：스토리보드 사용 안 함
예시: true
​
character_url
string
캐릭터 추출을 위한 참조 비디오 URL참조 비디오에서 캐릭터를 추출하여 생성된 비디오에서 재사용합니다예시: "https://filesystem.site/cdn/20251030/javYrU4etHVFDqg8by7mViTWHlMOZy.mp4"⚠️ 주의: 이 매개변수를 사용하면 생성된 비디오 길이가 1초 줄어듭니다
​
character_timestamps
string
캐릭터 출현 타임스탬프참조 비디오에서 캐릭터가 나타나는 시간 범위를 지정합니다. 2초 세그먼트만 지원형식: "시작_초,종료_초"예시: "1,3" 은 참조 비디오의 1초에서 3초까지의 캐릭터를 의미합니다⚠️ 주의: 이 매개변수를 사용하면 생성된 비디오 길이가 1초 줄어듭니다

​
응답

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