FutureInfra 무료로 시작
문서

AI 영상 만들기

사진과 글로 영상을 만드는 API입니다. 사진 한 장에서 시작하거나, 인물·제품 사진 여러 장을 함께 참고하거나, 사진 속 인물이 동작 영상을 그대로 따라 하게 할 수 있습니다. 파일을 올리고 → 만들기를 요청하고 → 결과를 받는 세 단계입니다. 실패한 작업은 청구하지 않습니다.

세 단계로 끝

모든 요청에 API 키를 넣습니다: Authorization: Bearer $FI_KEY (권한 llm:write·llm:read)

# 1) 파일 올리기 — 응답의 id(up…)를 적어 둡니다
curl -X POST https://futureinfra.ai/v1/gen/uploads \
  -H "Authorization: Bearer $FI_KEY" -H "Content-Type: image/jpeg" --data-binary @person.jpg

# 2) 만들기 — 접수증(작업 id)이 바로 옵니다
curl -X POST https://futureinfra.ai/v1/gen/videos \
  -H "Authorization: Bearer $FI_KEY" -H "Content-Type: application/json" \
  -d '{"model":"kling-motion","image":"up인물id","video":"up동작영상id","resolution":"720p"}'

# 3) 결과 받기 — status 가 done 이면 outputs[0].url 에 MP4
curl https://futureinfra.ai/v1/gen/jobs/작업id -H "Authorization: Bearer $FI_KEY"
영상은 보통 2~5분 걸립니다. 장면 수백 장을 함께 그리는 작업이라 길이·해상도가 클수록 오래 걸립니다. 10초쯤 간격으로 조회하세요.

무엇을 만들 수 있나

하고 싶은 것모델넣는 것
사진 한 장에서 시작kling-std · kling-pro · hailuo-2.3 등image + prompt
인물 + 제품 사진을 함께 참고kling-omni (최대 7장)references + prompt — 글에서 @image_1, @image_2… 로 가리킵니다
사진 속 인물이 동작 영상을 따라 하기kling-motionimage(인물) + video(동작 3~30초). 결과 길이 = 동작 영상 길이
글만으로대부분의 모델prompt
# 인물 + 제품 사진 함께
{"model":"kling-omni","references":["up인물id","up제품id"],
 "prompt":"@image_1 이 @image_2 를 들고 카메라를 보며 웃는다","duration":5}

모델마다 받는 입력·길이·해상도·초당 값은 GET /v1/gen/models 의 inputs·durations·resolutions·krwPerSecond 에 있습니다. 받지 않는 입력을 보내면 만들지 않고 400 unsupported_input 으로 이유를 알려 드립니다.

파일 올리기

POST /v1/gen/uploads — 본문에 파일 바이트를 그대로. 작은 파일은 JSON {"data":"data:image/png;base64,…"} 도 됩니다(4MB까지).

  • 사진 JPG·PNG·WEBP 10MB, 영상 MP4·MOV 100MB까지. 30일 보관
  • 영상을 올리면 길이(durationSec)를 알려 드립니다 — 동작 따라 하기의 값이 이 길이로 정해집니다
  • 업로드 id 대신 공개 https 주소를 바로 넣어도 됩니다
  • 인물 사진은 머리·어깨·몸통이 잘 보이는 것이 동작 따라 하기에 잘 맞습니다

값과 한도

  • 만든 초만큼 청구, 실패는 0원. 예: 720p 사진 2장 참고 5초 약 700원, 동작 따라 하기 9초 약 1,500원
  • 한 조직에서 동시에 3개까지 진행합니다. 넘으면 429 too_many_running_jobs
  • 실제 인물이 나오는 영상은 kling 계열(kling-std·kling-pro·kling-omni·kling-motion)을 쓰세요
오류뜻
400 unsupported_input고른 모델이 받지 않는 입력(이유는 hint)
400 bad_video_duration동작 영상이 3~30초를 벗어남
402 insufficient_credits조직 잔액 부족
413 · 415파일이 너무 큼 · 지원하지 않는 형식

AI 에이전트(MCP)로는 gen.upload → gen.video → gen.status 순서로 같은 일을 합니다.