메인 콘텐츠로 건너뛰기
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-pro",
    "url": "https://cdn.apimart.ai/modelDefaultUrl/Sora-2-pro.mp4",
    "timestamps": "1,3"
  }'

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

curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "sora-2-pro",
    "url": "https://cdn.apimart.ai/modelDefaultUrl/Sora-2-pro.mp4",
    "timestamps": "1,3"
  }'

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

​
인증

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

​
Body

​
model
string
기본값:"sora-2-pro"
필수
비디오 생성 모델 이름지원 모델:
  • sora-2-pro - 프로 버전
예시: "sora-2-pro"
​
timestamps
string
필수
캐릭터 등장 타임스탬프 범위초 단위, 형식: "시작초,종료초"⚠️ 제한:
  • 시간 범위 차이 최소 1초
  • 시간 범위 차이 최대 3초
예시: "1,3" 은 비디오의 1초에서 3초까지 등장하는 캐릭터를 의미합니다
​
url
string
생성할 캐릭터가 포함된 비디오 URL⚠️ 요구사항:
  • 비디오에 사운드가 포함되어야 함
  • 비디오에 캐릭터가 포함되어야 함
💡 설명:
  • url 또는 from_task 중 하나를 설정해야 합니다
예시: "https://upload.apimart.ai/f/video/..."
​
from_task
string
생성된 비디오 작업 ID이미 생성된 작업 ID에서 캐릭터를 생성할 수 있습니다💡 설명:
  • url 또는 from_task 중 하나를 설정해야 합니다
  • 이 매개변수를 사용하면 이전에 생성된 비디오 작업에서 직접 캐릭터를 추출할 수 있습니다
예시: "task_01KBYT59JDHB4A3KDDR9N9JVWP"

​
Response

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