AI 영상 워크플로를 다른 팀과 공유: Sume Format 공유 권한

Sume에서 AI 영상 워크플로를 다른 팀과 공유하려면, Format을 소유한 워크스페이스가 Format의 액세스 탭이나 POST /v1/formats/{handle}/{slug}/grants로 상대 팀 워크스페이스에 실행 권한을 줍니다. 공유 권한이 활성화되면 상대 팀은 자기 팀 키로 소유자의 주소에서 Format을 호출하며, 실행과 지출, 미디어는 그 팀의 것이 됩니다.

아래 내용은 2026-09-26에 확인한 Format 호출하기 (영문)의 공유 섹션, 오류와 비용 (영문), Sume API 레퍼런스의 공유 권한 엔드포인트에서 가져왔습니다.

누가, 누구와 Format을 공유할 수 있나요?

팀 Format은 GitHub 저장소에 외부 협업자(outside collaborator)를 추가하듯 다른 워크스페이스와 공유할 수 있으며, 사용자와는 절대 공유할 수 없습니다. 초대에는 상대 팀의 handle을 지정하고, 사용자 handle에는 공유 권한을 줄 수 없습니다. 공유할 수 있는 것은 팀 Format뿐이며, 공유 권한은 소유 워크스페이스가 그 워크스페이스에서 만든 키로 관리합니다.

Sume가 제공하는 Format에는 공유 권한이 필요 없습니다. Format 스코프가 있는 키라면 어떤 키로든 예약된 sume handle에서 호출할 수 있고, 실행은 그 키에 귀속됩니다.

다른 팀이 내 Format을 실행하도록 어떻게 초대하나요?

방법은 두 가지입니다. Format의 액세스 탭에서 상대 팀의 handle을 추가하면 즉시 적용됩니다. 또는 formats:write가 있는, 여러분 팀 워크스페이스의 키로 API를 통해 초대합니다. API로 만든 공유 권한(fgr_…)은 pending 상태로 시작하며, 초대받은 워크스페이스의 관리자가 수락하기 전까지는 아무 권한도 주지 않습니다.

GET /v1/formats/{handle}/{slug}/grants는 Format의 유효한 공유 권한을 대기 중인 것과 수락된 것 모두 최신순으로 나열합니다. 그 워크스페이스에 이미 대기 중이거나 수락된 공유 권한이 있으면 초대는 409 format_grant_exists로 거부됩니다. 그 워크스페이스가 이미 Format을 소유하고 있으면 409 format_grant_self, Format을 팀 워크스페이스가 소유하지 않았으면 409 format_workspace_required로 거부됩니다.

# Owner workspace: invite a team by its handle
curl -sS -X POST "https://api.sume.com/v1/formats/acme/product-promo/grants" \
  -H "Authorization: Bearer $OWNER_TEAM_KEY" \
  -H "Content-Type: application/json" \
  -d '{"workspace": "example-team"}'

# Invited workspace: list pending invites, then accept one
curl -sS "https://api.sume.com/v1/format-grants" \
  -H "Authorization: Bearer $YOUR_TEAM_KEY"
curl -sS -X POST "https://api.sume.com/v1/format-grants/fgr_…/accept" \
  -H "Authorization: Bearer $YOUR_TEAM_KEY"

상대 팀은 어떻게 수락하나요?

GET /v1/format-grants는 호출한 키의 팀 워크스페이스에 공유된 공유 권한을 나열합니다. 관리자가 수락할 수 있는 대기 중 초대와 이미 수락된 공유 권한이 함께 나옵니다. 수락은 POST /v1/format-grants/{grant_id}/accept로 하며, 여러분의 워크스페이스에서 만든 formats:write 키를 씁니다.

• 수락은 멱등합니다. 이미 수락된 공유 권한을 다시 수락하면 바뀌지 않은 그대로 응답합니다.
• 개인 키로는 빈 공유 권한 목록만 보이고 수락할 수 없습니다. 수락 요청은 403 workspace_key_required로 응답합니다.
• 다른 워크스페이스로 초대된 공유 권한은 404이며, 알 수 없는 id와 구분되지 않습니다.

공유된 Format의 실행 비용은 누가 내나요?

호출하는 팀이 냅니다. 소유자의 주소에서 여러분의 팀 키로 Format을 호출하며, 요청에는 워크스페이스 필드가 없습니다. 키가 곧 호출 주체입니다. 실행과 그 지출, 동시성 슬롯, 미디어는 소유자가 아니라 여러분 워크스페이스의 것입니다.

여러분의 키로 GET …/runs를 호출하면 여러분의 실행만 나옵니다. 두 워크스페이스 모두에 멤버로 속해 있다면 어느 키를 쓰느냐로 정해집니다. 워크스페이스마다 실행 이력과 청구서가 따로 있고, 한 워크스페이스의 키로는 다른 쪽의 실행을 절대 읽을 수 없습니다. 키의 기본은 Sume API 키 동작 방식에 있습니다.

공유된 Format은 무엇 때문에 여전히 막힐 수 있나요?

항상 팀 키로 호출하세요. 개인 키는 어느 팀 Format에서나 그렇듯 거부되며, 소유 워크스페이스의 멤버라는 사실이 공유 권한을 대신하지 않습니다. Format이 API 호출을 받을지 여부도 계속 소유자가 정합니다. 공유받은 쪽이 만나는 응답은 다음과 같습니다.

소유자가 접근 권한을 없애면 어떻게 되나요?

소유자는 DELETE /v1/formats/{handle}/{slug}/grants/{workspace}로 공유 권한을 취소합니다. {workspace}는 공유받은 팀의 handle이나 org_… id입니다. 대기 중인 공유 권한과 수락된 공유 권한 모두에 쓸 수 있습니다.

• 공유받은 쪽에서 진행 중이던 실행은 끝까지 진행됩니다.
• 새 목록 조회, 읽기, 호출은 즉시 거부되고, 공유받은 쪽에서 그 주소는 다시 404가 됩니다.
• 취소된 공유 권한은 유효한 공유 권한 목록에 절대 나타나지 않습니다.