동영상 API

LLMPool은 MiniMax와 Doubao에 서로 다른 비동기 동영상 프로토콜을 제공합니다. 경로와 요청 형식이 다르므로 혼용할 수 없습니다.

인증

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

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

아래의 https://<LLMPOOL_HOST>는 서비스 루트 URL입니다. 동영상 API는 /openai/v1 경로를 사용하지 않습니다. model에는 Models 페이지에 표시된 ID를 입력합니다. 생성 후 5-10초 간격으로 작업을 조회하세요.

프로토콜 기능

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":false,"seed":42,"watermark":false}}'

Doubao 프롬프트는 최대 7,000자입니다. 이미지 data URL 또는 인증 정보가 없는 HTTPS URL을 최대 4개 사용할 수 있으며 길이는 1-60초입니다. Playground에서는 480p, 720p, 1080p와 16:9, 4:3, 1:1을 제공합니다. generate_audio는 false이거나 생략해야 합니다.

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을 받을 수 있습니다.

멱등성, 결제 및 오류

생성 요청마다 고유한 Idempotency-Key를 전송하세요. 모델, 길이, 해상도 및 가격 규칙에 따라 잔액이 선차감됩니다. 잔액이 부족하면 작업이 생성되지 않습니다. 실패하거나 취소된 작업의 환불은 비동기 정산으로 처리됩니다.

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