> ## Documentation Index > Fetch the complete documentation index at: https://docs.evolink.ai/llms.txt > Use this file to discover all available pages before exploring further. # Hailuo-02 비디오 생성 > - Hailuo 02 (MiniMax-Hailuo-02)는 T2V (텍스트-투-비디오), I2V (이미지-투-비디오) 및 FLF (첫 프레임-마지막 프레임) 모드를 지원합니다 - 자동 모드 감지: 이미지 0개=T2V, 이미지 1개=I2V, 이미지 2개=FLF - 풀 기능 모델, 512P 해상도 지원 (I2V 모드만) - `[Pan left]`, `[Push in]`, `[Static shot]` 등 15개 카메라 모션 명령 지원 - 비동기 처리, 반환된 작업 ID를 사용하여 [상태 조회](/ko/api-manual/task-management/get-task-detail) - 생성된 비디오 링크는 24시간 동안 유효하며, 즉시 저장하세요 ## OpenAPI ````yaml ko/api-manual/video-series/hailuo/hailuo-02-video-generate.json POST /v1/videos/generations openapi: 3.1.0 info: title: Hailuo 02 API description: T2V, I2V 및 FLF 모드를 지원하는 MiniMax Hailuo 02 모델로 비디오 생성 작업을 생성합니다 license: name: MIT version: 1.0.0 servers: - url: https://api.evolink.ai description: |- 존재 페널티, -2.0에서 2.0 사이의 숫자 **참고**: - 양수 값은 텍스트에 나타나는지 여부에 따라 새 토큰에 페널티를 부여하여 새로운 주제 논의 가능성을 높입니다 security: - bearerAuth: [] tags: - name: 비디오 생성 description: AI 비디오 생성 API paths: /v1/videos/generations: post: tags: - 비디오 생성 summary: Hailuo 02 API description: >- - Hailuo 02 (MiniMax-Hailuo-02)는 T2V (텍스트-투-비디오), I2V (이미지-투-비디오) 및 FLF (첫 프레임-마지막 프레임) 모드를 지원합니다 - 자동 모드 감지: 이미지 0개=T2V, 이미지 1개=I2V, 이미지 2개=FLF - 풀 기능 모델, 512P 해상도 지원 (I2V 모드만) - `[Pan left]`, `[Push in]`, `[Static shot]` 등 15개 카메라 모션 명령 지원 - 비동기 처리, 반환된 작업 ID를 사용하여 [상태 조회](/ko/api-manual/task-management/get-task-detail) - 생성된 비디오 링크는 24시간 동안 유효하며, 즉시 저장하세요 operationId: createVideoGeneration requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/VideoGenerationRequest' examples: text_to_video: summary: 텍스트-투-비디오 (T2V) value: model: MiniMax-Hailuo-02 prompt: A beautiful sunset over the ocean [Static shot] responses: '200': description: 비디오 생성 작업이 성공적으로 생성되었습니다 content: application/json: schema: $ref: '#/components/schemas/VideoGenerationResponse' '400': description: 요청 매개변수가 잘못되었습니다 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: invalid_request message: Invalid request parameters type: invalid_request_error '401': description: 인증되지 않았거나 토큰이 유효하지 않거나 만료되었습니다 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: unauthorized message: Invalid or expired token type: authentication_error '402': description: 할당량이 부족합니다. 충전이 필요합니다 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: insufficient_quota message: Insufficient quota. Please top up your account. type: insufficient_quota '403': description: 접근이 거부되었습니다 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: model_access_denied message: 'Token does not have access to model: MiniMax-Hailuo-02' type: invalid_request_error '429': description: 요청 한도를 초과했습니다 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: rate_limit_exceeded message: Too many requests, please try again later type: rate_limit_error '500': description: 서버 내부 오류 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: internal_error message: Internal server error type: api_error components: schemas: VideoGenerationRequest: type: object required: - model properties: model: type: string description: 비디오 생성 모델 이름 default: MiniMax-Hailuo-02 example: MiniMax-Hailuo-02 prompt: type: string description: >- 비디오 내용 및 카메라 모션을 설명하는 프롬프트. T2V에서는 필수, I2V/FLF에서는 선택 사항. 최대 2000자 **15개 카메라 명령:** - 트럭: `[Truck left]`, `[Truck right]` - 팬: `[Pan left]`, `[Pan right]` - 돌리: `[Push in]`, `[Pull out]` - 페데스탈: `[Pedestal up]`, `[Pedestal down]` - 틸트: `[Tilt up]`, `[Tilt down]` - 줌: `[Zoom in]`, `[Zoom out]` - 특수: `[Shake]` - 팔로우: `[Tracking shot]` - 고정: `[Static shot]` **사용법:** - 결합: 하나의 `[]`에 여러 명령을 넣으면 동시에 실행됩니다. 예: `[Pan left,Pedestal up]`, 최대 3개 권장 - 순차: 명령은 텍스트 순서대로 실행됩니다. 예: `...천천히 [Push in], 그런 다음 빠르게 [Pull out]` example: A young girl gradually grows into an adult woman maxLength: 2000 image_urls: type: array description: |- I2V 및 FLF 모드용 참조 이미지 URL **모드 감지:** - 이미지 0개 = T2V (텍스트-투-비디오) - 이미지 1개 = I2V (이미지-투-비디오) - 이미지 2개 = FLF (첫 프레임-마지막 프레임 전환) **요구사항:** - 이미지 크기: 최대 20MB - 형식: JPG, JPEG, PNG, WebP - 화면 비율: 2:5 ~ 5:2 - 짧은 변 > 300px **FLF 참고:** 비디오 해상도는 첫 번째 프레임을 따르며, 마지막 프레임은 이에 맞게 잘립니다 items: type: string format: uri maxItems: 2 example: - https://example.com/first.jpg - https://example.com/last.jpg quality: type: string description: |- 비디오 해상도 **모드별 지원:** - I2V: 512p, 768p, 1080p - T2V: 768p, 1080p - FLF: 768p, 1080p **길이 & 해상도:** - 512p: 6초, 10초 - 768p: 6초, 10초 - 1080p: 6초만 참고: 512p는 I2V 모드에서만 사용 가능 enum: - 512p - 768p - 1080p default: 768p example: 768p duration: type: integer description: |- 비디오 길이 (초) - 6초 (기본값) - 10초 (1080p에서는 사용 불가) enum: - 6 - 10 default: 6 example: 6 model_params: type: object description: 모델별 매개변수 properties: prompt_optimizer: type: boolean description: 프롬프트 자동 최적화. 정밀 제어를 위해 false로 설정 default: true example: true fast_pretreatment: type: boolean description: 빠른 전처리를 활성화하여 최적화 시간 단축 default: false example: true callback_url: type: string description: |- 작업 완료 시 HTTPS 콜백 URL **콜백 시점:** - 작업이 완료, 실패 또는 취소될 때 트리거됩니다 - 과금 확인 후 전송됩니다 **보안 제한:** - HTTPS 프로토콜만 지원 - 내부 IP 주소 금지 (127.0.0.1, 10.x.x.x, 172.16-31.x.x, 192.168.x.x 등) - URL 길이는 `2048`자를 초과할 수 없습니다 **콜백 메커니즘:** - 타임아웃: `10`초 - 실패 후 최대 `3`회 재시도 (실패 후 `1`/`2`/`4`초) - 콜백 응답 형식은 작업 조회 API와 동일 - 2xx 상태 코드는 성공으로 간주, 그 외 코드는 재시도 트리거 format: uri example: https://your-domain.com/webhooks/video-task-completed VideoGenerationResponse: type: object properties: created: type: integer description: 작업 생성 타임스탬프 example: 1757169743 id: type: string description: 작업 ID example: task-unified-1757169743-7cvnl5zw model: type: string description: 사용된 모델 이름 example: MiniMax-Hailuo-02 object: type: string enum: - video.generation.task description: 작업 유형 progress: type: integer description: 작업 진행률 (0-100) minimum: 0 maximum: 100 example: 0 status: type: string description: 작업 상태 enum: - pending - processing - completed - failed example: pending ErrorResponse: type: object properties: error: type: object properties: code: type: string description: 오류 코드 식별자 message: type: string description: 오류 설명 type: type: string description: 오류 유형 securitySchemes: bearerAuth: type: http scheme: bearer description: |- ##모든 API는 Bearer Token 인증이 필요합니다## **API Key 받기:** [API Key 관리 페이지](https://evolink.ai/dashboard/keys)를 방문하여 API Key를 받으세요 **요청 헤더에 추가:** ``` Authorization: Bearer YOUR_API_KEY ``` ````