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이 의도한 정보를 드러내는지, 마지막 시점에 다음 편집 단계를 위한 공간이 충분히 남는지 확인하세요. 완성된 영상을 정확한 프롬프트, 원본 이미지, 설정과 함께 저장합니다. 수정에서는 관찰한 문제를 일으킨 카메라 방향, 타이밍, 피사체 행동을 바꾸고, 결과를 같은 장면 계획과 비교하세요.
", "aboutText": "I2V 01 Director는 카메라 명령이 문서화된 MiniMax의 이미지 영상 생성 버전입니다. 제공된 이미지가 첫 프레임을 정하고, 프롬프트가 눈에 보이는 행동과 카메라를 모두 지시합니다. 기존 구도에 특정한 접근, 드러내기, 추적 움직임, 제어된 고정 시점이 필요하며 단순히 정하지 않은 애니메이션을 원하는 것이 아닐 때 유용합니다.\n\n이미지를 의도한 장면의 시작으로 준비합니다. 드러내는 장면에서는 피사체와 카메라가 보여 주어야 하는 환경 부분을 표시하세요. 가까이 접근할 때는 프레이밍의 변화를 알아볼 수 있도록 충분한 주변 공간에서 시작합니다. 특히 제품 형태나 캐릭터 외모를 계속 알아볼 수 있어야 한다면, 움직임이 시작되기 전에 피사체의 중요한 특징이 보이는지 확인하세요.\n\n개발사는 20 MB 미만, 짧은 변이 300픽셀 초과, 가로세로비가 2:5에서 5:2 사이인 JPG, JPEG, PNG, WebP 참조를 받습니다. 개발사의 워크플로에서는 접근 가능한 이미지 URL이나 인코딩된 이미지 데이터로 첫 프레임을 지정할 수 있습니다. 나중에 수정할 때 재현한 근사 이미지가 아니라 같은 구도를 쓰도록 원본 참조를 보존하세요.\n\n프롬프트는 최대 2,000자를 지원하며 이름이 있는 열다섯 가지 카메라 명령을 포함합니다. Truck은 카메라를 수평으로 이동하고, pan은 수평 방향을 바꾸며, pedestal은 수직으로 이동하고, tilt는 수직 방향을 바꿉니다. Push, pull, zoom은 서로 다른 방식의 접근이나 후퇴를 제공하고, tracking, shake, 고정 장면은 그 밖의 카메라 의도를 다룹니다. 움직임을 지정할 때 문서화된 명령 철자를 사용하세요.\n\n움직임이 일어나야 하는 설명 위치에 대괄호 안으로 명령을 넣습니다. 같은 괄호에 여러 명령을 넣으면 동시 움직임을 요청하고, 이어지는 위치에 명령을 넣으면 순서를 설명합니다. 개발사는 결합하는 움직임을 최대 세 가지로 권장합니다. 피사체를 향한 단순한 push가 같은 짧은 장면에서 여러 움직임이 경쟁하는 것보다 세부 사항을 더 명확히 전달할 수 있습니다.\n\n피사체 움직임과 카메라 움직임을 별도로 설명합니다. 문 쪽으로 걷는 사람과 그 사람을 따라가는 카메라는 시각적 효과가 다른 두 지시입니다. 접근 중 얼굴을 계속 보이게 하거나 피사체가 프레임을 가로지르는 동안 카메라를 고정하는 것처럼, 둘 사이에 원하는 관계를 명시하세요. 생성되는 행동에 유용한 도착점이 생기도록 최종 구도를 식별합니다.\n\n개발사의 기존 이미지 영상 생성 표는 이 버전의 기본값으로 720P를 명시하고 열 초 옵션은 나열하지 않습니다. 자동 프롬프트 최적화는 기본으로 활성화되며, 글로 쓴 제작 지시를 더 세밀하게 제어하려면 비활성화할 수 있습니다. 장면을 비교할 때 변경된 표현이나 해석이 생성 기록에 드러나도록, 원본 이미지 및 카메라 지시와 함께 해당 설정을 유지하세요.\n\n전체 클립에서 요청한 카메라 경로, 피사체 연속성, 중요한 세부 사항의 프레이밍을 검토합니다. push나 pan이 의도한 정보를 드러내는지, 마지막 시점에 다음 편집 단계를 위한 공간이 충분히 남는지 확인하세요. 완성된 영상을 정확한 프롬프트, 원본 이미지, 설정과 함께 저장합니다. 수정에서는 관찰한 문제를 일으킨 카메라 방향, 타이밍, 피사체 행동을 바꾸고, 결과를 같은 장면 계획과 비교하세요.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "939d9311efab222e2b3ac6871836fb085cc0bec5d4948111dcfc51eeb91d1519", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "ko", "methods": [ { "html": "minimaxi-i2v-01-directorI2V 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이 의도한 정보를 드러내는지, 마지막 시점에 다음 편집 단계를 위한 공간이 충분히 남는지 확인하세요. 완성된 영상을 정확한 프롬프트, 원본 이미지, 설정과 함께 저장합니다. 수정에서는 관찰한 문제를 일으킨 카메라 방향, 타이밍, 피사체 행동을 바꾸고, 결과를 같은 장면 계획과 비교하세요.
POST /v1/videostext, imagevideo| 필드 | 유형 | 요건 | 값과 한도 | 기본값 |
|---|---|---|---|---|
필드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}
표시된 요율은 생성 전 비용을 예상하는 데 사용됩니다. 최종 청구액은 최초 생성에 기록된 비용으로 계산됩니다. 측정된 출력 길이와 예상 수량은 최종 청구 수량이 아닙니다.
요금 정보는 요청 옵션을 추가하지 않습니다. 지원되는 매개변수는 선택한 메서드에 표시됩니다.
각 요금을 표시된 조건과 대조하세요. 서로 대체되는 설정 묶음마다 하나의 요금만 적용하세요.
| 설정 | 요금표 | 예측 수량 | 과금 수량 | 요금 |
|---|---|---|---|---|
| 설정기본 토큰 요금 | 요금표기본 요금 | 예측 수량— | 과금 수량— | 요금 입력 · 입력 토큰 · 비교 전용 추정치 — / 1K 토큰 출력 · 출력 토큰 · 비교 전용 추정치 — / 1K 토큰 입력 · 캐시 읽기 · 비교 전용 추정치 — / 1K 토큰 입력 · 캐시 쓰기 · 비교 전용 추정치 — / 1K 토큰 입력 · 캐시 쓰기, 1시간 · 비교 전용 추정치 — / 1K 토큰 |
| 설정요청당 | 요금표— | 예측 수량— | 과금 수량요청 1회 | 요금 입력 · 비교 전용 추정치 $1 요청당 |
| 설정예상 생성 비용 | 요금표— | 예측 수량1회 생성 예상치 | 과금 수량— | 요금 출력 · 예상 생성 비용 · 비교 전용 추정치 $1 생성 전 추정치 이 예상 금액은 추가 요금이나 생성 완료 시 적용되는 고정 요금이 아닙니다. |
Ailoot는 요청 전에 예상 금액을 미리 확보합니다. 결과를 받은 뒤 측정된 사용량을 기준으로 최종 요금을 정산합니다. 스트리밍 정산에는 최종 사용량 기록을 사용합니다. 금액 확보와 정산 방식 →
# Replace YOUR_ACCESSIBLE_IMAGE_URL with your actual reachable reference image URL.\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\ncat > request.json <<'JSON'\n{\n "model": "minimaxi-i2v-01-director",\n "prompt": "A cat is walking on grass.",\n "image": "YOUR_ACCESSIBLE_IMAGE_URL"\n}\nJSON\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\n# Create once; retain id, polling_url, original task identifiers and every header.\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_STATUS'\nimport json,os,subprocess\nfrom pathlib import Path\nfrom urllib.parse import urljoin,urlsplit\nr=json.loads(Path("result.json").read_text())\nu=urljoin("https://api.ailoot.ai",r["polling_url"])\np=urlsplit(u)\nif p.scheme!="https" or p.netloc!="api.ailoot.ai" or p.username or p.password:\n raise SystemExit("Unexpected returned polling URL; preserve the response")\nsubprocess.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)\n# Read this same original polling_url again while pending.\n# Preserve unknown/result_pending_check; do not repeat creation.\nPY_STATUS\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_ASSETS'\nimport json,os,subprocess\nfrom pathlib import Path\nfrom urllib.parse import urljoin,urlsplit\nr=json.loads(Path("status.json").read_text())\nroles={}\ndef visit(v,path=""):\n if isinstance(v,dict):\n for k,x in v.items(): visit(x,path+"/"+k)\n elif isinstance(v,list):\n for i,x in enumerate(v): visit(x,path+"/"+str(i))\n elif isinstance(v,str):\n u=urljoin("https://api.ailoot.ai",v); p=urlsplit(u)\n 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"):\n roles.setdefault(u,[]).append(path)\nvisit(r)\nif not roles: raise SystemExit("No completed owned assets; retain the original status")\nmanifest=[]\nfor i,(u,paths) in enumerate(roles.items()):\n target=Path(f"asset-{i}.bin")\n subprocess.run(["curl","--fail-with-body","--silent","--show-error",u,"-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"],"-o",str(target)],check=True)\n raw=target.read_bytes()\n if not raw: raise SystemExit("Empty asset; retain original status and metadata")\n 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"\n name=f"asset-{i}.{ext}"\n if target.name!=name: target.rename(name)\n manifest.append({"file":name,"response_paths":paths,"bytes":len(raw)})\nPath("asset-manifest.json").write_text(json.dumps(manifest,indent=2))\nprint("Saved",len(manifest),"unique owned assets; every response role retained")\nPY_ASSETS\nGET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/media/assetsGET /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