AiVideoEditor
무료로 시작하기
메뉴

검토 2026-11-11 · API 버전 2026-11-09 · Markdown 읽기

게시와 예약

AiVideoEditor 게시물은 버전 관리되는 초안과 선택한 계정별 독립적인 전송으로 구성돼요. 초안 저장은 관대해요; 저장에 성공했다고 모든 수신처가 게시 가능한 건 아니에요.

게시물 준비

  1. 의도한 키로 /api/v1/accounts와 /api/v1/capabilities를 조회하세요.
  2. 필요한 미디어를 업로드하고 확정하세요.
  3. POST /api/v1/posts로 초안을 만들거나 PATCH /api/v1/posts/{id}로 편집하세요. 편집 시 현재 expectedVersion을 넣고 반환된 버전을 보존하세요.
  4. 필요한 곳에 수신처 형식과 명시적인 계정별 변형 재정의를 설정하세요. 요청 필드는 API reference에 정의돼 있어요.
  5. POST /api/v1/posts/{id}/validate로 검증하세요. HTTP 200에 valid: false가 담길 수 있어요; 제출 전에 모든 문제를 확인하세요. 잘못된 계정은 대상에서 조용히 제거되지 않아요.

지금 또는 나중에 게시

POST /posts/{id}/publish는 현재 초안을 제출해요. POST /posts/{id}/schedule에는 scheduledAt, timezone, expectedVersion이 필요해요. 예약 시각은 미래여야 하고 90일 안이어야 해요. UTC ISO 타임스탬프와 별개의 IANA 표시 타임존을 저장하고, 일광 절약 시간 모호성은 보내기 전에 해결하세요.

각 새 변경 작업에는 고유한 Idempotency-Key를 사용하세요. 보내기 전에 그 키와 정확한 요청 본문을 보관하세요. 타임아웃 후에는 같은 키로 동일한 요청을 재생하세요. 의도적으로 새 작업을 요청할 때만 키를 바꾸세요. 오래된 초안 편집이나 예약은 revision_conflict를 반환해요; 무작정 덮어쓰지 말고 최신 콘텐츠를 다시 읽고 검토하세요.

202 응답은 전송 접수를 의미해요. 게시의 증거가 아니에요. 전송 ID를 기록하고 GET /posts/{id}나 서명된 고객 웹훅을 관찰하세요. 점점 길어지는 지연으로 제한된 폴링을 사용하고, 최종 결과나 사람 핸드오프에서 멈추세요; 무한히 반복하지 마세요.

수신처별 결과

전송은 독립적으로 완료될 수 있어요. 한 수신처는 게시되고 다른 수신처는 재연결이나 동의가 필요할 수 있어요. 각 상태와 네이티브 게시물 링크가 있으면 보여주세요. 적격한 알려진 실패만 POST /deliveries/{id}/retry로 재시도하세요. 실패한 하나를 복구한다고 성공한 수신처를 다시 만들면 안 돼요. 알 수 없는 외부 결과는 새 제출이 아니라 조정이나 검토가 필요해요.

작업이 아직 안전하게 접수되지 않은 상태일 때는 POST /deliveries/{id}/cancel로 취소하세요. too_late_to_cancel은 제출이 안전 취소 범위를 넘어 진행됐다는 뜻이지, 외부 게시물이 제거됐다는 뜻이 아니에요.

TikTok 사람 검토

현재 크리에이터 설정과 사용 가능한 공개 범위 선택은 /accounts/{id}/tiktok/settings에서 조회하세요. 설정 조회나 초안 저장만으로는 동의가 공급되지 않아요. consent_required에는 인증된 컴포저로 가는 안전한 requiresAction 핸드오프가 포함돼요. 권한 있는 사람이 정확한 영상, 게시물 문구, 수신처를 검토하고 그곳에서 필요한 선택을 명시적으로 확인해요. Product key와 MCP 도구는 대신 확인할 수 없어요. 콘텐츠나 신원 변경에는 새로운 검토가 필요해요. 핸드오프만으로 멤버십이나 접근이 부여되지 않아요.

컴포저 컨트롤

Add media로 파일을 업로드하거나 기존 라이브러리 항목을 선택하세요. 게시물 문구는 Customize content가 계정별 변형을 만들기 전까지 공유돼요. 이모지와 해시태그 도구는 커서 위치에 일반 텍스트를 삽입해요.

Posting options는 선택한 계정의 설정을 묶어요. 필수 선택은 계속 보이고, 선택적 그룹은 접힌 상태로 유지돼요. 변경 사항은 그 계정에만 적용돼요. Preview는 저장이나 제출 없이 실효 초안을 보여줘요; 불완전한 초안도 포함돼요. 네이티브 플랫폼 표현은 다를 수 있어요.

예약된 커버와 썸네일에는 비공개 asset 참조를 사용하세요. 공개 URL 대안은 전송 시점에 계속 도달 가능해야 해요. 자막 콘텐츠는 임시 로컬 파일에 의존하지 않고 불변 설정과 함께 저장돼요. LinkedIn 문서 업로드는 현재 PDF를 받아요; Office 형식은 서명 검증이 구현될 때까지 제한돼 있어요.

표준 컨트롤과 통합 제한은 capabilities reference를 참고하세요. 새로운 형식과 확인 동작은 배포 전에 해당하는 데이터베이스 마이그레이션이 필요해요.