메인 콘텐츠로 건너뛰기
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": "sora-2",
    "prompt": "폭포가 흘러내려 무지개를 형성하다",
    "duration": 8,
    "resolution": "720p",
    "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"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.apimart.ai/llms.txt

Use this file to discover all available pages before exploring further.

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": 8,
    "resolution": "720p",
    "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
필수
모든 API 엔드포인트에는 Bearer Token 인증이 필요합니다API 키 가져오기:API 키 관리 페이지를 방문하여 API 키를 가져오세요요청 헤더에 추가:
Authorization: Bearer YOUR_API_KEY

​
본문

​
model
string
필수
비디오 생성 모델 이름지원되는 모델:
  • sora-2 Sora 2 표준판
  • sora-2-pro Sora 2 Pro
예시: "sora-2"
​
prompt
string
필수
비디오 생성을 위한 텍스트 설명예시: "폭포가 흘러내려 무지개를 형성하다"
​
duration
integer
기본값:"4"
지원되는 값: 4, 8, 12, 16, 20예시: 8
​
resolution
string
기본값:"720p"
비디오 해상도지원되는 값:
모델허용 값
sora-2720p
sora-2-pro720p, 1024p, 1080p
지정하지 않으면 기본값은 720p입니다.예시: "720p"
​
aspect_ratio
string
기본값:"16:9"
비디오 화면 비율, 가로 또는 세로 방향 제어지원되는 값:
방향허용 값
가로16:9, landscape
세로9:16, portrait
지정하지 않으면 기본값은 가로입니다.
image_urls(이미지-비디오 생성)를 전달하면 aspect_ratio 매개변수는 무효가 되며 전송할 필요가 없습니다. 비디오 방향은 참조 이미지에 따라 자동으로 결정됩니다.
​
image_urls
array<url>
이미지-비디오 생성을 위한 참조 이미지 URL 배열
  • 전달하지 않으면 텍스트-비디오 생성, 1장을 전달하면 이미지-비디오 생성
  • 최대 1장
  • 공개 접근 가능한 이미지 URL (http:// 또는 https://) 지원
  • 지원 형식: .jpeg, .jpg, .png, .webp
  • 최대 파일 크기: 10MB
예시: ["https://example.com/image.jpg"]

​
응답

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