작업과 결과

Sume 작업은 이미지 생성, 비디오 생성, AI Ads 비디오, Face Swap, Reference Analysis, 에셋 ingest 같은 비동기 작업을 나타냅니다.

언제 작업을 쓰나

create 엔드포인트가 실제 작업 완료 전에 응답할 때 작업을 사용합니다. 초기 응답의 job id를 저장하고 상태를 폴링한 뒤 결과를 가져옵니다.

create endpoint -> job id -> GET /jobs/{jobId} -> GET /jobs/{jobId}/result

최근 작업 목록

curl "https://www.sume.so/api/v1/jobs?limit=5" \
  -H "Authorization: Bearer $SUME_API_KEY"

CLI:

sume jobs list --limit 5
sume jobs list --status completed --limit 5
sume jobs list --type video_generation --limit 5 --json

지원 필터는 limit, cursor, type, status입니다.

한 작업 폴링

curl https://www.sume.so/api/v1/jobs/job_123 \
  -H "Authorization: Bearer $SUME_API_KEY"

CLI:

sume jobs get job_123 --json

상태 구분	할 일
Queued/running/processing	기다렸다가 다시 폴링합니다. 비디오 작업은 더 긴 간격을 사용합니다.
Completed	결과를 가져옵니다.
Failed/canceled/expired	폴링을 멈추고 정리된 오류/상태를 보여줍니다.

결과 가져오기

curl https://www.sume.so/api/v1/jobs/job_123/result \
  -H "Authorization: Bearer $SUME_API_KEY"

CLI:

sume jobs result job_123 --json
sume jobs result job_123 --download ./outputs/

결과 payload는 작업 유형마다 다릅니다. 생성 미디어, Reference Analysis 출력, provider-safe 메타데이터, Asset Library ingest 참조가 포함될 수 있습니다.