동영상 API

LLMPool은 MiniMax, Doubao, Doubao 확장 프로토콜 및 Alibaba Cloud 동영상 모델을 제공합니다. Alibaba 경로는 /aliyun/v1입니다.

인증

Board에서 만든 계정 API 키를 사용합니다.

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

아래의 https://<LLMPOOL_HOST>는 서비스 루트 URL입니다. 동영상 API는 /openai/v1 경로를 사용하지 않습니다. model에는 Models 페이지에 표시된 ID를 입력합니다. 생성 후 5-10초 간격으로 작업을 조회하세요. 상세 및 목록 응답에는 관측된 경우 Unix 초 단위의 submitted_at, generation_started_at, completed_at, result_available_at이 포함됩니다.

프로토콜 기능

MiniMax

curl -X POST "https://<LLMPOOL_HOST>/minimax/v2/video_generation" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: minimax-demo-001" \
  -d '{"model":"MiniMax-H3","content":[{"type":"text","text":"A cinematic city at night"}],"resolution":"768P","duration":5,"ratio":"16:9","seed":42,"aigc_watermark":false}'

MiniMax는 768P, 4-15초, 텍스트 모드 비율 16:9, 4:3, 1:1을 지원합니다. 이미지 모드에서는 role: "first_frame"인 image_url 한 개와 adaptive 비율을 사용합니다. 이미지는 공개 HTTPS URL 또는 이미지 data URL을 사용할 수 있습니다.

curl "https://<LLMPOOL_HOST>/minimax/v2/video_generation/video_xxx" -H "Authorization: Bearer YOUR_API_KEY"
curl "https://<LLMPOOL_HOST>/minimax/v2/video_generation?limit=20" -H "Authorization: Bearer YOUR_API_KEY"
curl -X DELETE "https://<LLMPOOL_HOST>/minimax/v2/video_generation/video_xxx" -H "Authorization: Bearer YOUR_API_KEY"

각 목록은 해당 프로토콜의 작업만 반환하며 limit, after 및 선택적인 source=api|playground를 지원합니다. queued 작업만 취소할 수 있고 in_progress 작업은 task_not_cancellable을 반환합니다. 종료된 작업의 DELETE는 작업 삭제를 의미합니다.

Doubao

curl -X POST "https://<LLMPOOL_HOST>/doubao/v1/video/generations" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: doubao-demo-001" \
  -d '{"model":"DOUBAO_MODEL_FROM_MODELS_PAGE","prompt":"A cinematic city at night","images":[],"metadata":{"resolution":"720p","ratio":"16:9","duration":5,"generate_audio":true,"seed":42,"watermark":false}}'

Doubao 프롬프트는 최대 7,000자입니다. 이미지 data URL 또는 인증 정보가 없는 HTTPS URL을 최대 4개 사용할 수 있으며, reference_videos에는 MP4/MOV data URL 또는 인증 정보가 없는 HTTPS URL을 최대 4개(각 64 MB) 사용할 수 있습니다. 길이는 4-15초, 기본값은 5초입니다. Playground에서는 모델에 따라 480p, 720p, 1080p, 4k와 16:9, 4:3, 3:4, 9:16, 1:1, 21:9, adaptive를 제공합니다. generate_audio는 boolean 값을 허용하며 기본값은 true입니다. metadata.mode는 t2v, i2v_first_frame, i2v_first_last_frame, multi_ref, multi_ref_vid를 지원합니다. seed는 -1 이상이어야 하고 watermark=true는 거부됩니다. 모델이 지원하지 않는 해상도는 가격 견적 및 생성 API에서 거부됩니다.

Doubao 작업 목록:

curl "https://<LLMPOOL_HOST>/doubao/v1/video/generations?limit=20" -H "Authorization: Bearer YOUR_API_KEY"

Doubao 목록도 limit, after, source=api|playground를 지원하며 Doubao 작업만 반환합니다. Doubao 작업 취소 API는 현재 제공하지 않습니다.

curl "https://<LLMPOOL_HOST>/doubao/v1/video/generations/video_xxx" -H "Authorization: Bearer YOUR_API_KEY"

상태는 QUEUED, IN_PROGRESS, SUCCESS, FAILURE입니다. 결과 URL이 만료되면 작업을 다시 조회해 새 URL을 받을 수 있습니다.

Doubao 확장 프로토콜

현재 H3 기능을 제공하며 4-15초, 768P, 16:9, 9:16, 1:1 및 최대 4개 이미지를 지원합니다. 오디오는 항상 네이티브로 생성되므로 metadata.generate_audio를 생략해야 하며, false를 지정하면 거부됩니다. 고급 API 호출은 vela에서 generation_preset, 1-16 범위의 generation_count, sampling, client_metadata를 사용할 수 있습니다. 여러 동영상은 data.data.usage.results에 반환되며 요금은 길이 × generation_count입니다.

Alibaba Cloud 동영상

Alibaba는 선택한 모델에 따라 텍스트, 첫 프레임 및 참고 이미지 동영상 생성을 지원합니다. 길이는 2-30초이며 정확한 범위와 이미지 수는 모델별로 다릅니다. metadata.generate_audio는 불리언 값을 허용하며 생략하면 true입니다. 생성, 조회, 목록은 각각 POST /aliyun/v1/video_generation, GET /aliyun/v1/video_generation/{task_id}, GET /aliyun/v1/video_generation을 사용합니다. 취소 및 삭제는 현재 지원하지 않습니다.

멱등성, 결제 및 오류

생성 요청마다 고유한 Idempotency-Key를 전송하세요. 네이티브 Doubao Seedance는 해상도, 비율, 고정 24 FPS와 길이로 출력 토큰을 추정해 선결제하고 완료 후 업스트림 실제 토큰에 따라 차액을 환불하거나 추가 차감합니다. 실패 또는 취소 시 전액 환불됩니다. 다른 동영상 프로토콜은 현재 길이 기준으로 선결제합니다. 잔액이 부족하면 작업이 생성되지 않습니다.

주요 오류는 invalid_parameter, unsupported_parameter, model_not_found, rate_limit_exceeded, insufficient_credit, task_not_cancellable입니다. GraphQL videoPriceQuote는 요금 예상 전용이며 동영상 작업을 생성하거나 조회하지 않습니다.