메인 콘텐츠로 건너뛰기
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": "grok-imagine-1.0-video-apimart",
    "prompt": "해변을 달리는 강아지, 화창한 날씨, 슬로우 모션",
    "size": "16:9",
    "duration": 6,
    "quality": "720p"
  }'

{
  "code": 200,
  "data": {
    "id": "task_01JNXXXXXXXXXXXXXXXXXX",
    "status": "submitted",
    "progress": 0,
    "created": 1710000000,
    "type": "video"
  }
}

curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "grok-imagine-1.0-video-apimart",
    "prompt": "해변을 달리는 강아지, 화창한 날씨, 슬로우 모션",
    "size": "16:9",
    "duration": 6,
    "quality": "720p"
  }'

{
  "code": 200,
  "data": {
    "id": "task_01JNXXXXXXXXXXXXXXXXXX",
    "status": "submitted",
    "progress": 0,
    "created": 1710000000,
    "type": "video"
  }
}

​
인증

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

​
Body

​
model
string
기본값:"grok-imagine-1.0-video-apimart"
필수
비디오 생성 모델 이름지원 모델:
  • grok-imagine-1.0-video-apimart - Grok 비디오 생성
예시: "grok-imagine-1.0-video-apimart"
​
prompt
string
필수
비디오 내용 설명, 다국어 지원
​
size
string
기본값:"16:9"
비디오 크기옵션:
  • 16:9 - 가로 (기본값)
  • 9:16 - 세로
  • 1:1 - 정사각형
  • 3:2 - 가로
  • 2:3 - 세로
​
duration
integer
기본값:6
비디오 길이 (초)범위: 6-30 (최소 6초, 최대 30초)⚠️ 주의: 순수한 숫자를 입력하세요 (예: 6). 따옴표를 붙이면 오류가 발생합니다
​
quality
string
기본값:"480p"
비디오 화질옵션:
  • 480p - 표준 화질 (기본값)
  • 720p - 고화질
​
image_urls
string[]
이미지-비디오 모드용 참조 이미지 URL 배열. 지정하면 이미지-비디오 모드로 전환되며, 배열의 첫 번째 이미지를 참조로 사용합니다.
참조 이미지를 업로드하면 화면 비율이 자동으로 참조 이미지의 화면 비율에 맞춰집니다.

​
Response

​
code
integer
응답 상태 코드
​
data
object
응답 데이터 객체
태스크 결과 조회비디오 생성은 비동기 태스크입니다. 제출 후 id (즉 task_id)가 반환됩니다. 태스크 상태 조회 엔드포인트를 사용하여 생성 진행 상황과 결과를 확인하세요.

​
사용 시나리오

​
시나리오 1: 텍스트-비디오 생성

{
  "model": "grok-imagine-1.0-video-apimart",
  "prompt": "해변을 달리는 강아지, 화창한 날씨, 슬로우 모션",
  "size": "16:9",
  "duration": 6
}

​
시나리오 2: 이미지-비디오 생성

{
  "model": "grok-imagine-1.0-video-apimart",
  "prompt": "장면에 자연스러운 동적 효과 추가",
  "image_urls": ["https://example.com/start.png"],
  "size": "16:9",
  "duration": 10,
  "quality": "720p"
}