AI 비디오 작곡가 API는 생성된 클립 하나를 반환하는 것 이상의 역할을 해야 합니다. 실용적인 워크플로우는 다음과 같습니다: 비디오 형식을 선택하고, 편집 가능한 계획을 생성하며, 앱이나 사용자가 스토리보드를 수정하게 하고, 최종 영상을 렌더링한 후, 재무팀과 제품 팀이 이해할 수 있도록 사용량을 보고합니다.
EmpirioLabs Compose는 그 흐름을 드러냅니다 /v1/videos/compose·.
1. 이용 가능한 레시피 목록
레시피는 공개 형식의 정의입니다. 각 레시피는 슬러그, 디스플레이 이름, 설명, 지원 입력, 장면 제한, 캡션 기본값, 추천 모델을 알려줍니다.
curl https://api.empiriolabs.ai/v1/videos/compose/recipes \ -H "인증: 베어러 $EMPIRIO_API_KEY"2. 편집 가능한 계획 작성
사용 모드: "계획" 렌더링 전에 스토리보드를 원할 때. 답변은 직무 신분증입니다. 설문조사 /v1/jobs/{job_id} 직업 상태가 다음과 같을 때까지는 성공·.
{ "레시피": "ai-ugc-product-ad", "모드": "계획", "브리핑": "창작자가 아침 내내 커피를 뜨겁게 유지하는 여행용 머그잔을 설명하다", "product_image": "https://example.com/mug.jpg" }성공적인 계획 결과에는 장면 내레이션, 캡션 텍스트, 시각적 프롬프트, 모델 선택, 그리고 지원되는 소셜 캡션 도우미가 포함됩니다.
3. 최종 영상 렌더링
스토리보드를 다시 넘겨주세요. 모드: "렌더". 장면 카피, 자막, 시각적 프롬프트를 먼저 편집하거나, 반환된 대로 설계도를 렌더링할 수 있습니다.
{ "레시피": "ai-ugc-product-ad", "모드": "렌더", "스토리보드": { "제목": "트래블 머그 UGC", "씬": [] } }렌더링 작업이 완료되면 최종 MP4 URL을 반환합니다. 클라이언트 앱은 Compose를 비동기로 취급해야 합니다. 전체 프로덕션에는 여러 모델 호출과 최종 렌더링 단계가 포함되어 있기 때문입니다.
4. 감사 지출 및 사용
계정 사용 API를 사용해 Compose 전용 레코드를 불러와야 합니다:
curl "https://platform.empiriolabs.ai/api/v1/account/usage?source=compose&limit=25" \ -h "인증: 베어러 $EMPIRIO_API_KEY"요약에는 다음과 같은 내용이 포함되어 있습니다 spend.compose각 사용 이벤트에는 레시피 슬러그, 페이즈, 출력 카운트와 같은 Compose 메타데이터가 포함될 수 있습니다. 이렇게 하면 한 제품이 일반 모델 호출과 풀 비디오 Compose 작업을 나란히 사용할 때 보고가 깨끗하게 유지됩니다.
