OpenRouter 호환 영상 생성 API: sume/auto 또는 고정 모델

Sume의 영상 생성 엔드포인트 POST /v1/videos는 OpenRouter 영상 생성 API를 필드 하나하나까지 그대로 따릅니다. OpenRouter 문서를 보고 작성한 클라이언트는 베이스 URL과 API 키만 바꾸면 Sume에서 동작합니다. Sume 카탈로그의 모델을 고정할 수도 있고, model: "sume/auto"를 보내 Sume가 고르게 할 수도 있습니다.

아래 세부 내용은 모두 영상 생성 문서 (영문)에서 가져왔습니다.

영상 Job은 어떻게 동작하나요?

영상 생성은 텍스트나 이미지 생성보다 훨씬 오래 걸리기 때문에 비동기로 동작합니다.

• POST /v1/videos로 요청을 제출합니다.
• Job ID와 폴링 URL을 바로 받습니다(202).
• 상태가 completed가 될 때까지 GET /v1/videos/{jobId}를 폴링하거나, callback_url을 넘겨 서명된 웹훅을 받습니다.
• GET /v1/videos/{jobId}/content에서 결과를 내려받습니다.

curl -sS -X POST "https://api.sume.com/v1/videos" \
  -H "Authorization: Bearer $SUME_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: teaser-001" \
  -d '{
    "model": "sume/auto",
    "prompt": "A vertical UGC-style product clip on a desk, natural light",
    "aspect_ratio": "9:16",
    "duration": 5
  }'

sume/auto를 써야 하나요, 모델을 고정해야 하나요?

Sume가 모델 계열을 고르게 하려면 sume/auto를 쓰세요. 라우팅은 정규화된 요청과 카탈로그 버전만으로 결정되는 순수 함수이므로, 멱등성 키로 다시 보낸 요청도 가격과 라우팅이 똑같습니다. 응답에는 sume/auto가 표시되며 Sume는 어느 계열이 Job을 처리했는지 공개하지 않으므로, 출력의 특징으로 이를 추론하는 방식에 기대지 마세요. Video Router 문서 (영문)에 따르면 Auto 생성 옵션의 기본값은 720p와 8초이고, 클립 길이는 3–10초, 비율은 16:9 또는 9:16입니다.

특정 모델의 동작이나 한도가 필요하면 카탈로그 ID를 고정하세요. 카탈로그는 GET /v1/videos/models로 조회하며, 각 항목에는 지원하는 해상도, 화면비, 길이, 가격 SKU가 담겨 있습니다.

Sume는 OpenRouter와 어디가 다른가요?

문서는 모든 차이점을 Sume differences (영문) 섹션의 표 하나에 정리해 두었습니다. 가장 먼저 눈에 띄는 차이는 다음과 같습니다.

• 베이스 경로는 https://api.sume.com/v1/videos이며, /api 세그먼트가 없습니다.
• 모델 ID는 seedance-2 같은 카탈로그 ID 그대로이며, org/slug 형식은 쓰지 않습니다.
• sume/auto는 Sume에만 있는 추가 기능입니다.
• Idempotency-Key를 보내면 재시도가 안전해지며, 재전송하면 원래 Job이 돌아옵니다.
• 웹훅은 Sume의 표준 Job 봉투를 쓰고 x-sume-webhook-signature로 서명됩니다.

요금은 어떻게 청구되나요?

Job 비용은 워크스페이스의 USD 잔액에서 차감되며, 모든 모델에서 제출 시점에 공급사 정가 × 1.25로 예약됩니다. 요금제와 요율은 요금제와 API 요금에 있습니다. Pro 이상 요금제의 포함 사항에는 100개 이상의 영상 생성 모델 이용이 올라 있습니다.

음악에도 같은 기능이 있나요?

네. Music Router (영문)는 model을 생략하거나 sume/music-auto로 지정하면 엔진을 고르고(현재는 Lyria 3.5), lyria-3.5 같은 명시적 카탈로그 ID는 해당 엔진으로 그대로 전달합니다.