모델

MiniMax: I2V 01 Director

Markdown · JSON

MiniMax: I2V 01 Director

I2V 01 Director는 프롬프트에 명시한 카메라 이동 명령으로 첫 프레임 이미지에 움직임을 만듭니다. 제공된 구도와 truck, pan, push, tilt, zoom, tracking 또는 고정 카메라 지시를 결합해 짧은 장면을 계획하세요.

모델 소개

이 설명은 모델의 기능을 다룹니다. Ailoot에서 사용할 수 있는 입력, 출력 및 옵션은 아래에 선택한 메서드별로 표시됩니다.

I2V 01 Director는 카메라 명령이 문서화된 MiniMax의 이미지 영상 생성 버전입니다. 제공된 이미지가 첫 프레임을 정하고, 프롬프트가 눈에 보이는 행동과 카메라를 모두 지시합니다. 기존 구도에 특정한 접근, 드러내기, 추적 움직임, 제어된 고정 시점이 필요하며 단순히 정하지 않은 애니메이션을 원하는 것이 아닐 때 유용합니다.

이미지를 의도한 장면의 시작으로 준비합니다. 드러내는 장면에서는 피사체와 카메라가 보여 주어야 하는 환경 부분을 표시하세요. 가까이 접근할 때는 프레이밍의 변화를 알아볼 수 있도록 충분한 주변 공간에서 시작합니다. 특히 제품 형태나 캐릭터 외모를 계속 알아볼 수 있어야 한다면, 움직임이 시작되기 전에 피사체의 중요한 특징이 보이는지 확인하세요.

개발사는 20 MB 미만, 짧은 변이 300픽셀 초과, 가로세로비가 2:5에서 5:2 사이인 JPG, JPEG, PNG, WebP 참조를 받습니다. 개발사의 워크플로에서는 접근 가능한 이미지 URL이나 인코딩된 이미지 데이터로 첫 프레임을 지정할 수 있습니다. 나중에 수정할 때 재현한 근사 이미지가 아니라 같은 구도를 쓰도록 원본 참조를 보존하세요.

프롬프트는 최대 2,000자를 지원하며 이름이 있는 열다섯 가지 카메라 명령을 포함합니다. Truck은 카메라를 수평으로 이동하고, pan은 수평 방향을 바꾸며, pedestal은 수직으로 이동하고, tilt는 수직 방향을 바꿉니다. Push, pull, zoom은 서로 다른 방식의 접근이나 후퇴를 제공하고, tracking, shake, 고정 장면은 그 밖의 카메라 의도를 다룹니다. 움직임을 지정할 때 문서화된 명령 철자를 사용하세요.

움직임이 일어나야 하는 설명 위치에 대괄호 안으로 명령을 넣습니다. 같은 괄호에 여러 명령을 넣으면 동시 움직임을 요청하고, 이어지는 위치에 명령을 넣으면 순서를 설명합니다. 개발사는 결합하는 움직임을 최대 세 가지로 권장합니다. 피사체를 향한 단순한 push가 같은 짧은 장면에서 여러 움직임이 경쟁하는 것보다 세부 사항을 더 명확히 전달할 수 있습니다.

피사체 움직임과 카메라 움직임을 별도로 설명합니다. 문 쪽으로 걷는 사람과 그 사람을 따라가는 카메라는 시각적 효과가 다른 두 지시입니다. 접근 중 얼굴을 계속 보이게 하거나 피사체가 프레임을 가로지르는 동안 카메라를 고정하는 것처럼, 둘 사이에 원하는 관계를 명시하세요. 생성되는 행동에 유용한 도착점이 생기도록 최종 구도를 식별합니다.

개발사의 기존 이미지 영상 생성 표는 이 버전의 기본값으로 720P를 명시하고 열 초 옵션은 나열하지 않습니다. 자동 프롬프트 최적화는 기본으로 활성화되며, 글로 쓴 제작 지시를 더 세밀하게 제어하려면 비활성화할 수 있습니다. 장면을 비교할 때 변경된 표현이나 해석이 생성 기록에 드러나도록, 원본 이미지 및 카메라 지시와 함께 해당 설정을 유지하세요.

전체 클립에서 요청한 카메라 경로, 피사체 연속성, 중요한 세부 사항의 프레이밍을 검토합니다. push나 pan이 의도한 정보를 드러내는지, 마지막 시점에 다음 편집 단계를 위한 공간이 충분히 남는지 확인하세요. 완성된 영상을 정확한 프롬프트, 원본 이미지, 설정과 함께 저장합니다. 수정에서는 관찰한 문제를 일으킨 카메라 방향, 타이밍, 피사체 행동을 바꾸고, 결과를 같은 장면 계획과 비교하세요.

Ailoot Ultra · 동영상 POST /v1/videos minimaxi-i2v-01-director

minimaxi-i2v-01-director

MiniMax /minimaxi-i2v-01-director

시작하기

I2V 01 Director는 프롬프트에 명시한 카메라 이동 명령으로 첫 프레임 이미지에 움직임을 만듭니다. 제공된 구도와 truck, pan, push, tilt, zoom, tracking 또는 고정 카메라 지시를 결합해 짧은 장면을 계획하세요.

허용 입력
텍스트 · 이미지
결과
동영상

Ailoot에서 사용 가능 · 입력 및 메서드

Ailoot Ultra · 동영상 POST /v1/videos
입력
text, image
출력
video
필드유형요건값과 한도기본값
필드model유형string요건필수값과 한도
minimaxi-i2v-01-director
조건: 정확한 Ailoot 모델 선택자를 사용하세요.
기본값—
필드prompt유형string요건필수값과 한도
조건: 장면과 움직임을 설명하세요.
기본값—
필드end_image유형string요건선택 사항값과 한도
조건: 끝 프레임은 지원되는 이미지 입력 모드에서만 적용됩니다.
기본값—
필드image유형string or array<string>요건선택 사항값과 한도
조건: 실제로 공개 접근 가능한 이미지 URL 또는 base64 이미지 문자열을 사용하세요. 여기서는 최대 이미지 수를 명시하지 않습니다.
기본값—
메서드 매개변수와 수명 주기
매개변수명세
매개변수content_type명세application/json
매개변수required명세model, prompt
매개변수optional명세end_image, image
매개변수material_types명세text, image
매개변수conditions명세정확한 Ailoot 모델 선택자를 사용하세요., 장면과 움직임을 설명하세요., 끝 프레임은 지원되는 이미지 입력 모드에서만 적용됩니다., 실제로 공개 접근 가능한 이미지 URL 또는 base64 이미지 문자열을 사용하세요. 여기서는 최대 이미지 수를 명시하지 않습니다.

메서드 별칭: /v1/videos/generations

수명 주기: submit_once_poll_original

GET /v1/videos/{request_id}

GET /v1/videos/generations/{request_id}

GET /v1/videos/{request_id}/content

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

요금

최종 요금 계산 방식

표시된 요율은 생성 전 비용을 예상하는 데 사용됩니다. 최종 청구액은 최초 생성에 기록된 비용으로 계산됩니다. 측정된 출력 길이와 예상 수량은 최종 청구 수량이 아닙니다.

요금 정보는 요청 옵션을 추가하지 않습니다. 지원되는 매개변수는 선택한 메서드에 표시됩니다.

빠른 모드
미지정 빠른 모드를 선택한 경우
Flex 모드
미지정 flex 모드를 선택한 경우
최대 추론 수준
미지정 최대 추론 수준에 default 조정값을 적용하는 경우

비교용 예상 요금

설정별 가격

각 요금을 표시된 조건과 대조하세요. 서로 대체되는 설정 묶음마다 하나의 요금만 적용하세요.

설정요금표예측 수량과금 수량요금
설정기본 토큰 요금요금표기본 요금예측 수량—과금 수량—요금
입력 · 입력 토큰 · 비교 전용 추정치 — / 1K 토큰
출력 · 출력 토큰 · 비교 전용 추정치 — / 1K 토큰
입력 · 캐시 읽기 · 비교 전용 추정치 — / 1K 토큰
입력 · 캐시 쓰기 · 비교 전용 추정치 — / 1K 토큰
입력 · 캐시 쓰기, 1시간 · 비교 전용 추정치 — / 1K 토큰
설정요청당요금표—예측 수량—과금 수량요청 1회요금
입력 · 비교 전용 추정치 $1 요청당
설정예상 생성 비용요금표—예측 수량1회 생성 예상치과금 수량—요금
출력 · 예상 생성 비용 · 비교 전용 추정치 $1 생성 전 추정치

이 예상 금액은 추가 요금이나 생성 완료 시 적용되는 고정 요금이 아닙니다.

Ailoot는 요청 전에 예상 금액을 미리 확보합니다. 결과를 받은 뒤 측정된 사용량을 기준으로 최종 요금을 정산합니다. 스트리밍 정산에는 최종 사용량 기록을 사용합니다. 금액 확보와 정산 방식 →

요청 예제

Ailoot Ultra · 동영상

curl · 한 번만 생성하고 접수 기록 보관원본 작업을 조회하세요완료된 모든 소유 자산을 저장하세요
# Replace YOUR_ACCESSIBLE_IMAGE_URL with your actual reachable reference image URL.
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
cat > request.json <<'JSON'
{
  "model": "minimaxi-i2v-01-director",
  "prompt": "A cat is walking on grass.",
  "image": "YOUR_ACCESSIBLE_IMAGE_URL"
}
JSON
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o result.json
# Create once; retain id, polling_url, original task identifiers and every header.
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_STATUS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path("result.json").read_text())
u=urljoin("https://api.ailoot.ai",r["polling_url"])
p=urlsplit(u)
if p.scheme!="https" or p.netloc!="api.ailoot.ai" or p.username or p.password:
    raise SystemExit("Unexpected returned polling URL; preserve the response")
subprocess.run(["curl","--fail-with-body","--silent","--show-error",u,"-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"],"-D","status-headers.txt","-o","status.json"],check=True)
# Read this same original polling_url again while pending.
# Preserve unknown/result_pending_check; do not repeat creation.
PY_STATUS
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_ASSETS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path("status.json").read_text())
roles={}
def visit(v,path=""):
    if isinstance(v,dict):
        for k,x in v.items(): visit(x,path+"/"+k)
    elif isinstance(v,list):
        for i,x in enumerate(v): visit(x,path+"/"+str(i))
    elif isinstance(v,str):
        u=urljoin("https://api.ailoot.ai",v); p=urlsplit(u)
        if p.scheme=="https" and p.netloc=="api.ailoot.ai" and not p.username and not p.password and p.path.startswith("/v1/media/assets/") and p.path.endswith("/content"):
            roles.setdefault(u,[]).append(path)
visit(r)
if not roles: raise SystemExit("No completed owned assets; retain the original status")
manifest=[]
for i,(u,paths) in enumerate(roles.items()):
    target=Path(f"asset-{i}.bin")
    subprocess.run(["curl","--fail-with-body","--silent","--show-error",u,"-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"],"-o",str(target)],check=True)
    raw=target.read_bytes()
    if not raw: raise SystemExit("Empty asset; retain original status and metadata")
    ext="glb" if raw[:4]==b"glTF" else "png" if raw[:8]==b"\x89PNG\r\n\x1a\n" else "jpg" if raw[:3]==b"\xff\xd8\xff" else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "mp4" if raw[4:8]==b"ftyp" else "bin"
    name=f"asset-{i}.{ext}"
    if target.name!=name: target.rename(name)
    manifest.append({"file":name,"response_paths":paths,"bytes":len(raw)})
Path("asset-manifest.json").write_text(json.dumps(manifest,indent=2))
print("Saved",len(manifest),"unique owned assets; every response role retained")
PY_ASSETS

결과 수신 및 저장

Ailoot Ultra · 동영상

  • GET /v1/videos/{request_id}
  • GET /v1/videos/generations/{request_id}
  • GET /v1/videos/{request_id}/content
  • GET /v1/media/assets
  • GET /v1/media/assets/{asset_id}
완료된 결과 모두 보관

완료된 모든 동영상과 반환된 파일을 저장하고, 실제로 반환된 모든 자산 URL에서 가져오세요.

응답과 헤더 전체, 원래 식별자, 모든 실제 출력 및 모든 사용량/회계 필드를 보존하세요. 고유한 소유 자산을 각각 저장하고 해당 자산을 가리키는 모든 역할을 유지하세요.

원래 응답을 확인해야 할 경우

반환된 공개 작업 또는 연산 id와 모든 헤더를 보존하세요. 원래 작업만 조회하세요. unknown 또는 result_pending_check는 새로운 생성을 허용하는 근거가 되지 않습니다.

응답 필드
필드유형
필드id유형string
필드polling_url유형string
필드provider_task_id유형string
필드task_id유형string
필드status유형string
필드video_url유형string

별칭

모델 별칭

Ailoot Ultra minimaxi-i2v-01-director

메서드 경로 별칭

/v1/videos/generations

관련 호출용 ID

minimaxi-i2v-01-director

FAQ · MiniMax: I2V 01 Director
어떤 입력과 결과를 사용할 수 있나요?

POST /v1/videos · minimaxi-i2v-01-director: text, image → video

요청은 어떤 필드를 사용하나요?

POST /v1/videos · minimaxi-i2v-01-director: model, prompt, end_image, image

자세히 보기

Claude Code, OpenCode, Hermes, 자체 앱에 Ailoot를 연결하세요.

회사와 그 프로젝트 포트폴리오

회사와 그 프로젝트 포트폴리오: 수백만 고객, 매월 수십억 규모의 매출.

할인받아 토큰을 구매하세요.

정기 작업에는 구독 할인, 토큰 구매에는 최대 50% 프로모션 코드.

구독
정기 요청에 맞는 할인 요금제를 선택하세요.
최대 50% 프로모션 코드
구매할 때 코드를 넣으면 진행 중 행사에 따라 가격을 다시 계산합니다.
이력의 지출
요청마다 모델, 토큰, 금액을 저장합니다.

구독 선택 · 모델 가격 보기

판매하는 제품에 API를 연결하세요.

Ailoot 공식 이용 조건과 라이선스 계약으로 SaaS, 앱, 봇에 사용하세요. 재판매에는 리셀러 라이선스를 요청하세요.

상업용 앱
서비스의 유료 기능에 텍스트, 이미지, 영상, 소리 생성을 넣으세요.
리셀러 라이선스
프로젝트 설명과 접근 구조를 보내 사용·재판매의 서면 조건을 요청하세요.
사이트의 문서
연결 전에 공식 이용 조건, 라이선스 계약, 데이터 처리 정책을 읽을 수 있습니다.

리셀러 라이선스 요청 · 공식 이용 조건과 라이선스 계약