Runway: Aleph 2.0
Aleph 2.0은 특정 부분을 겨냥한 텍스트 지시와 키프레임 안내로 기존 영상을 편집합니다. 물체 교체, 배경·의상·조명·스타일 변경에 사용하고, 원래 장면에서 어떤 디테일을 유지할지도 지정할 수 있습니다.
모델 소개
이 설명은 모델의 기능을 다룹니다. Ailoot에서 사용할 수 있는 입력, 출력 및 옵션은 아래에 선택한 메서드별로 표시됩니다.
Aleph 2.0은 Runway의 문맥 기반 영상 편집 모델입니다. 글로 쓴 지시와 선택적인 키프레임 안내로 기존 실사 또는 생성 영상을 변환합니다. 주변 구도, 조명과 디테일을 보존하며 장면에서 요청한 부분을 바꾸는 워크플로를 지향하므로, 텍스트 기획에서 전체 장면을 다시 만들지 않고 제품 교체, 의상 변경, 배경 변환, 재조명이나 시각적 스타일 변경에 유용합니다.
추가, 제거, 교체, 변경, 재조명, 스타일 변경처럼 직접적인 동작과 원하는 변환으로 시작하세요. 제품 교체라면 화면의 물체와 교체 대상을 설명하고 어떤 손동작, 카메라 이동과 주변 배경을 유지할지 명시합니다. 계절 장면에서는 바꿔야 할 날씨나 빛을 설명하세요. 클립 전체를 개선해 달라는 일반적인 요청보다 간결하고 구체적인 지시가 편집 목표를 명확히 합니다.
키프레임 안내는 특정 순간의 편집 결과가 어떤 모습이어야 하는지 정합니다. 배경 변경에는 넓은 시야, 작은 특징이나 액세서리에는 가까운 시야처럼 대상을 잘 보여 주는 프레임을 선택하세요. Runway Edit Studio 워크플로에서는 정지 프레임 편집을 미리 보고 다듬은 뒤 선택 버전으로 영상 변환을 안내할 수 있습니다. 편집 프레임을 원본과 비교해 유지할 피사체 디테일, 가장자리와 물체를 확인하고 클립의 시각적 방향으로 사용하세요.
제작사 API는 2–30초 원본 영상과 지정 타임스탬프에 배치하는 선택적 키프레임 이미지 최대 5개를 지원합니다. 각 안내 이미지를 원본의 의도한 지점과 연결하고, 충돌하는 여러 시각적 목표보다 소수의 명확한 변경을 사용하세요. Aleph 2.0은 이전 Gen-4 Aleph와 구별되며 제작사는 API 모델을 별도로 식별합니다. 키프레임 기반 편집은 텍스트-비디오 모델에 무관한 새 숏을 요청하는 것과도 다릅니다.
Edit Studio의 문서상 준비 규칙은 일반적인 화면비, 480p–1080p 원본 해상도, 초당 24–30프레임과 최대 10회의 컷 또는 숏 변경을 사용합니다. 720p 또는 1080p 원본을 권장하며, 해당 인터페이스에서 30fps 초과 영상은 다운샘플링하고 30초 초과 업로드는 자릅니다. 이는 제작사 편집 워크플로의 준비 규칙입니다. 편집할 사건 전체가 보이고 변경이 지속되어야 하는 구간에서 피사체가 계속 보이는 원본 구간을 선택하세요.
모델은 변경한 배경, 옷, 물체, 빛이나 스타일을 영상 전반에 적용할 수 있습니다. 시간에 따라 전개되는 시각 효과처럼 원본에 없으며 키프레임만으로 이어지지 않을 새 동작이 필요하면 추가 움직임 지시가 유용합니다. 많은 편집에서는 모델이 기존 장면 안에서 키프레임 조정을 움직이므로 추가 움직임 기획이 필요하지 않습니다. 새 움직임은 구체적으로 설명하고 키프레임이 이미 정한 시각적 변경과 구분하세요.
제작사 편집 워크플로는 기본적으로 영상 전체에 편집을 적용하며 선택한 타임라인 범위로 제한할 수도 있습니다. 원본 클립을 보관해 선택 결과를 비교하고 후속 수정에 사용하세요. 실용적인 검토는 선택 프레임을 넘어 시작, 중간, 끝, 모든 컷과 대상이 잠깐 가려지는 구간을 확인합니다. 유용한 에셋은 요청한 변환이 시간 내내 일관되고 중요한 비변경 요소가 역할을 유지하는 수정 클립입니다.
기본 재생·공유 에셋은 MP4입니다. Runway의 지원 대상인 전체 영상 Edit Studio 워크플로는 PCM 오디오가 포함된 MOV 파일의 ProRes 또는 합성용 개별 PNG 프레임 ZIP도 제공합니다. ProRes 프로파일 범위는 422 Proxy부터 4444 XQ까지입니다. 타임라인 범위로 제한한 편집은 MP4를 반환하며 출력 형식은 완료 후가 아니라 생성 시작 시 선택합니다. 모델의 핵심 시각 편집 기능과 구별하면서 후속 편집 작업에 맞는 제작사 내보내기 형식을 선택하세요.
완성 편집을 유용하게 쓰려면 의도한 교체, 조명이나 스타일을 키프레임과 비교하고 바꾸지 않으려던 주변 디테일을 확인합니다. 성공한 버전을 보존하고 불일치를 일으킨 특정 지시나 안내 프레임을 수정하세요. Aleph 2.0의 역할은 명확한 시각적 목표로 원본 영상을 변환하는 것입니다. 새 사운드트랙 제작, 앱 동작 변경이나 별도 방송 납품 파이프라인 마무리는 편집 영상 주변의 추가 작업입니다.
Ailoot Ultra · 동영상 POST /v1/videos runway/aleph-2
runway/aleph-2시작하기
Aleph 2.0은 특정 부분을 겨냥한 텍스트 지시와 키프레임 안내로 기존 영상을 편집합니다. 물체 교체, 배경·의상·조명·스타일 변경에 사용하고, 원래 장면에서 어떤 디테일을 유지할지도 지정할 수 있습니다.
- 허용 입력
- 텍스트 · 이미지 · 오디오 · 동영상
- 결과
- 동영상
Ailoot에서 사용 가능 · 입력 및 메서드
Ailoot Ultra · 동영상 POST /v1/videos
- 입력
text,image,audio,video- 출력
video
| 필드 | 유형 | 요건 | 값과 한도 | 기본값 |
|---|---|---|---|---|
필드model | 유형string | 요건필수 | 값과 한도 runway/aleph-2 | 기본값— |
필드input_references | 유형array | 요건필수 | 값과 한도 최소 항목 수: 1 최대 항목 수: 1 | 기본값— |
필드prompt | 유형string | 요건필수 | 값과 한도 최소 길이: 1 | 기본값— |
메서드 매개변수와 수명 주기
| 매개변수 | 명세 |
|---|---|
매개변수content_type | 명세application/json |
매개변수required | 명세model, input_references, prompt |
매개변수material_types | 명세text, image, audio, video |
매개변수material_conditions | 명세실제로 완료된 소유 동영상 자산의 콘텐츠 URL 하나와 함께 반환된 서명만 사용하세요. 자산 소유자, 유형 및 저장된 바이트 증빙이 요청과 일치해야 합니다. |
수명 주기: asynchronous_job_then_owned_outputs
GET /v1/videos/{request_id} · 실제로 반환된 id 또는 polling_url
GET /v1/videos/{request_id}/content
요금
최종 요금 계산 방식
표시된 요율은 생성 전 비용을 예상하는 데 사용됩니다. 최종 청구액은 최초 생성에 기록된 비용으로 계산됩니다. 측정된 출력 길이와 예상 수량은 최종 청구 수량이 아닙니다.
요금 정보는 요청 옵션을 추가하지 않습니다. 지원되는 매개변수는 선택한 메서드에 표시됩니다.
- 빠른 모드
- 미지정 빠른 모드를 선택한 경우
- Flex 모드
- 미지정 flex 모드를 선택한 경우
- 최대 추론 수준
- 미지정 최대 추론 수준에 default 조정값을 적용하는 경우
비교용 예상 요금
설정별 가격
각 요금을 표시된 조건과 대조하세요. 서로 대체되는 설정 묶음마다 하나의 요금만 적용하세요. 해당 설정에 표시된 최소 요금 규칙을 적용하세요.
| 설정 | 요금표 | 예측 수량 | 요금 항목 | 과금 단위 | 과금 조건 | 최소 요금 규칙 | 요금 |
|---|---|---|---|---|---|---|---|
| 설정기본 토큰 요금 | 요금표기본 요금 | 예측 수량— | 요금 항목— | 과금 단위— | 과금 조건— | 최소 요금 규칙— | 요금 입력 · 입력 토큰 · 비교 전용 추정치 — / 1K 토큰 출력 · 출력 토큰 · 비교 전용 추정치 — / 1K 토큰 입력 · 캐시 읽기 · 비교 전용 추정치 — / 1K 토큰 입력 · 캐시 쓰기 · 비교 전용 추정치 — / 1K 토큰 입력 · 캐시 쓰기, 1시간 · 비교 전용 추정치 — / 1K 토큰 |
| 설정동영상 요금 | 요금표— | 예측 수량— | 요금 항목— | 과금 단위동영상 초당 | 과금 조건이 가격 키에는 추가 조건이 명시되어 있지 않습니다. | 최소 요금 규칙— | 요금 출력 · 동영상 가격 · 비교 전용 추정치 $0.56 동영상 초당 |
| 설정생성 최소 요금 | 요금표— | 예측 수량— | 요금 항목최소 요금 | 과금 단위최소 생성 요금 | 과금 조건이 가격 키에는 추가 조건이 명시되어 있지 않습니다. | 최소 요금 규칙예 | 요금 total · 생성 최소 요금 · 비교 전용 추정치 $1.12 최소 생성 요금 생성 건별 최소 청구액입니다. 추가 요금으로 더하지 말고 최소 금액으로 적용하세요. 최소 길이를 의미하지 않습니다. |
| 설정예상 생성 비용 | 요금표— | 예측 수량1회 생성 예상치 | 요금 항목— | 과금 단위— | 과금 조건— | 최소 요금 규칙— | 요금 출력 · 예상 생성 비용 · 비교 전용 추정치 $0.56 생성 전 추정치 이 예상 금액은 추가 요금이나 생성 완료 시 적용되는 고정 요금이 아닙니다. |
Ailoot는 요청 전에 예상 금액을 미리 확보합니다. 결과를 받은 뒤 측정된 사용량을 기준으로 최종 요금을 정산합니다. 스트리밍 정산에는 최종 사용량 기록을 사용합니다. 금액 확보와 정산 방식 →
요청 예제
Ailoot Ultra · 동영상
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_INPUT_REFERENCES_JSON:?Set the actual documented input value}"
export AILOOT_INPUT_REFERENCES_JSON
: "${AILOOT_PROMPT:?Set the actual documented input value}"
export AILOOT_PROMPT
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
request={'model': 'runway/aleph-2', 'input_references': '${ACTUAL_OWNED_INPUT_REFERENCES}', 'prompt': '${ACTUAL_EDIT_PROMPT}'}
request['input_references']=json.loads(os.environ['AILOOT_INPUT_REFERENCES_JSON'])
request['prompt']=os.environ['AILOOT_PROMPT']
Path('request.json').write_text(json.dumps(request,ensure_ascii=False),encoding='utf-8')
PY_REQUEST
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 response.bin
# Retain the complete response and headers, every actual output, original returned identifiers and all usage fields. Recover the original operation without submitting creation again.
결과 수신 및 저장
Ailoot Ultra · 동영상
GET /v1/videos/{request_id}GET /v1/videos/{request_id}/content
완료된 자산 모두 저장
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_STATUS_FILE:?Set the actual completed status JSON file}"
export AILOOT_STATUS_FILE
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
from urllib.parse import urlsplit,urljoin
f=Path(os.environ["AILOOT_STATUS_FILE"])
if not f.is_file():raise SystemExit("Choose the actual completed status file")
r=json.loads(f.read_text())
if r.get("status")!="completed" or not isinstance(r.get("data"),list) or not r["data"]:raise SystemExit("Wait for a completed status with asset paths")
urls=[]
for x in r["data"]:
if not isinstance(x,str) or "\n" in x or "\r" in x:raise SystemExit("Invalid asset path")
u=urljoin("https://api.ailoot.ai",x)
z=urlsplit(u)
if z.scheme!="https" or z.netloc!="api.ailoot.ai" or z.username or z.password:raise SystemExit("Use the actual Ailoot asset paths from status")
urls.append(u)
Path("asset-urls.txt").write_text("\n".join(urls)+"\n")
PY_REQUEST
index=0
while IFS= read -r asset_url; do
curl --fail-with-body --silent --show-error "$asset_url" \
-H "Authorization: Bearer $AILOOT_API_KEY" -o "video-${index}.mp4"
index=$((index + 1))
done < asset-urls.txt
완료된 결과 모두 보관
완료된 모든 동영상과 반환된 파일을 저장하고, 실제로 반환된 모든 자산 URL에서 가져오세요.
전체 응답과 헤더, 실제로 생성된 모든 출력, 최초로 반환된 식별자와 모든 사용량 필드를 보관하세요. 생성 요청을 다시 제출하지 말고 최초 작업을 복구하세요.
원래 응답을 확인해야 할 경우
X-Client-Request-ID, X-Ailoot-Task-Id 및 실제로 반환된 id/polling_url을 보존하세요. 원래 작업을 계속 진행하고 생성을 다시 제출하지 마세요.
응답 필드
| 필드 | 유형 |
|---|---|
필드id | 유형 |
필드status | 유형 |
필드data[] | 유형 |
필드outputs[] | 유형 |
별칭
모델 별칭
Ailoot Ultra runway/aleph-2
메서드 경로 별칭
위에 표시된 메서드 경로를 사용하세요.
관련 호출용 ID
FAQ · Runway: Aleph 2.0
- 어떤 입력과 결과를 사용할 수 있나요?
POST /v1/videos·runway/aleph-2:text,image,audio,video→video- 요청은 어떤 필드를 사용하나요?
POST /v1/videos·runway/aleph-2:model,input_references,prompt