cicora.ai
API 사양비동기 미디어

비디오

비디오를 비동기 작업으로 시작하고 작업 ID를 보존하며, 생성과 결과 읽기를 분리하세요.

통합 참조: 계정 API 설정과 환경용 모델 카탈로그에서 매개변수와 사용 가능한 기능을 선택하세요.

작업 생성

비디오 요청에는 일반적으로 prompt, model 및 길이, 화면비, 해상도, 참조 같은 프레임 속성이 포함되며, 선택한 모델이 지원할 때만 사용합니다.

작업 ID를 즉시 저장하세요. 진행 상황을 표시하고 인터페이스에서 취소를 지원하며 최종 콘텐츠를 가져오는 데 필요합니다.

비디오 생성 작업
bash
curl --request POST https://cicora.ai/api/v1/videos \
  --header "Authorization: Bearer $CICORA_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "google/veo-3.1",
    "prompt": "Slow aerial movement above a river at sunrise",
    "duration": 8,
    "aspect_ratio": "16:9",
    "resolution": "720p"
  }'

상태 폴링

  • GET /videos/{video_id}로 작업을 읽으세요.
  • 완료 여부는 최종 상태를 기준으로 판단하세요.
  • 폴링 간격을 점차 늘리고 사용자가 화면을 떠나면 폴링을 중지하세요.

결과 활용

완료 후 작업이 반환한 URL 또는 콘텐츠를 사용하고 플레이어를 표시하기 전에 파일이 준비되었는지 확인하세요.

지원을 위해 prompt, model, 매개변수 및 작업 ID를 보존하되 제품에 필요한 기간보다 오래 입력 참조를 보관하지 마세요.