> ## Documentation Index > Fetch the complete documentation index at: https://evolink.ai/docs/llms.txt > Use this file to discover all available pages before exploring further. # Wan3.0 Text-to-Video 텍스트-비디오 > - `prompt`만으로 동영상을 생성하며 **어떤 미디어 입력도 받지 않습니다** - 최대 **30초** 길이의 동영상을 생성할 수 있고 `duration: -1` 스마트 길이를 지원합니다 - 시작/종료 프레임 제어가 필요하면 [Wan3.0 이미지-비디오](/ko/api-manual/video-series/wan3.0/wan3.0-image-to-video)를, 참조 소재가 필요하면 [Wan3.0 참조-비디오](/ko/api-manual/video-series/wan3.0/wan3.0-reference-video)를 사용하세요 - 비동기 처리 모드, 반환된 작업 ID로 [상태 조회](/ko/api-manual/task-management/get-task-detail) - 생성된 동영상 링크는 24시간 유효하므로 가능한 한 빨리 저장하세요 ## 과금 안내 - **과금 공식**: 과금 시간 = 입력 동영상 길이 + 출력 동영상 길이, 초 단위로 과금 - **해상도 배율**: `480p` = 1x(기준), `720p` = 2x, `1080p` = 4x - 참조 이미지, 참조 오디오, 참조 파일, 웹페이지 링크는 **모두 과금되지 않음** - `duration`에 `-1`(스마트 길이)을 전달하면 상한인 `30`초 기준으로 최대 금액을 선차감하고, 작업 성공 후 실제 산출 길이로 정산하며 차액은 자동으로 환불됩니다 - `audio` 트랙을 켜거나 꺼도 **가격은 동일**합니다 - **실패한 작업은 과금되지 않으며**, 동결된 금액은 전액 환불됩니다 ## OpenAPI ````yaml ko/api-manual/video-series/wan3.0/wan3.0-text-to-video.json POST /v1/videos/generations openapi: 3.1.0 info: title: Wan3.0 Text-to-Video API description: Wan 3.0 텍스트-비디오. 텍스트 프롬프트만으로 최대 30초 길이의 동영상을 생성합니다 license: name: MIT version: 1.0.0 servers: - url: https://api.evolink.ai description: 프로덕션 환경 security: - bearerAuth: [] tags: - name: 비디오 생성 description: AI 비디오 생성 관련 API paths: /v1/videos/generations: post: tags: - 비디오 생성 summary: Wan3.0 Text-to-Video 텍스트-비디오 description: >- - `prompt`만으로 동영상을 생성하며 **어떤 미디어 입력도 받지 않습니다** - 최대 **30초** 길이의 동영상을 생성할 수 있고 `duration: -1` 스마트 길이를 지원합니다 - 시작/종료 프레임 제어가 필요하면 [Wan3.0 이미지-비디오](/ko/api-manual/video-series/wan3.0/wan3.0-image-to-video)를, 참조 소재가 필요하면 [Wan3.0 참조-비디오](/ko/api-manual/video-series/wan3.0/wan3.0-reference-video)를 사용하세요 - 비동기 처리 모드, 반환된 작업 ID로 [상태 조회](/ko/api-manual/task-management/get-task-detail) - 생성된 동영상 링크는 24시간 유효하므로 가능한 한 빨리 저장하세요 ## 과금 안내 - **과금 공식**: 과금 시간 = 입력 동영상 길이 + 출력 동영상 길이, 초 단위로 과금 - **해상도 배율**: `480p` = 1x(기준), `720p` = 2x, `1080p` = 4x - 참조 이미지, 참조 오디오, 참조 파일, 웹페이지 링크는 **모두 과금되지 않음** - `duration`에 `-1`(스마트 길이)을 전달하면 상한인 `30`초 기준으로 최대 금액을 선차감하고, 작업 성공 후 실제 산출 길이로 정산하며 차액은 자동으로 환불됩니다 - `audio` 트랙을 켜거나 꺼도 **가격은 동일**합니다 - **실패한 작업은 과금되지 않으며**, 동결된 금액은 전액 환불됩니다 operationId: createWan30TextToVideo requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/VideoGenerationRequest' examples: basic: summary: 기본 텍스트-비디오 value: model: wan3.0-text-to-video prompt: >- A kitten runs across a rooftop in the moonlight, city neon flickers in the distance, cinematic quality, smooth camera work. duration: 5 quality: 720p aspect_ratio: '16:9' generate_audio: true smart_duration: summary: 스마트 길이 + 1080p value: model: wan3.0-text-to-video prompt: >- A high-end smart glasses product ad, minimalist and futuristic, the camera glides over the lens and hinge details and finally settles on the brand logo. duration: -1 quality: 1080p aspect_ratio: '16:9' silent: summary: 무음 동영상 value: model: wan3.0-text-to-video prompt: >- An aerial shot sweeps over snow-capped mountains at dawn, a sea of clouds drifting slowly through the valleys. duration: 8 quality: 480p generate_audio: false 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_parameter 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: wan3.0-text-to-video' 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 - prompt properties: model: type: string description: 모델 이름, `wan3.0-text-to-video`로 고정 enum: - wan3.0-text-to-video example: wan3.0-text-to-video default: wan3.0-text-to-video prompt: type: string description: >- 동영상 생성을 위한 텍스트 프롬프트. 중국어와 영어를 지원하며 **한자/알파벳은 각각 1자로 계산**되고, 최대 길이는 `20000`자이며 초과분은 자동으로 잘립니다(오류가 발생하지 않음) **참고:** 이 모델은 순수 텍스트-비디오 모델이므로 어떤 미디어 입력도 받지 않습니다. example: >- A kitten runs across a rooftop in the moonlight, city neon flickers in the distance, cinematic quality, smooth camera work. duration: type: integer description: >- 생성할 동영상의 길이(초), 기본값은 `5` **값 설명:** - `2` ~ `30` 사이의 임의의 정수 - `-1`: 스마트 길이. 프롬프트와 입력 소재에 따라 모델이 출력 길이를 자동으로 결정 **스마트 길이의 과금 방식:** 제출 시점에는 모델이 얼마나 긴 영상을 만들지 알 수 없으므로 상한인 `30`초 기준으로 **최대 금액을 선차감**하고, 작업 성공 후 실제 산출 길이로 정산하며 초과 동결분은 자동으로 환불됩니다. 잔액이 최대 선차감액을 감당하지 못하면 명시적인 초 수를 사용하세요. default: 5 example: 5 quality: type: string description: |- 동영상 해상도, 기본값은 `720p` **선택 가능한 값:** - `480p`: 선명도가 낮고 가격이 가장 저렴(과금 기준 등급) - `720p`: 표준 선명도, 기본값이며 가격은 `480p`의 2배 - `1080p`: 고선명도, 가격은 `480p`의 4배 enum: - 480p - 720p - 1080p default: 720p example: 720p aspect_ratio: type: string description: |- 동영상 종횡비, 기본값은 `adaptive` **선택 가능한 값:** - `adaptive`: 자동. 입력 소재의 비율과 프롬프트의 의도에 따라 모델이 적합한 종횡비를 추천하며, 기본값입니다 - `16:9`(가로), `9:16`(세로), `1:1`(정사각형), `4:3`, `3:4` enum: - adaptive - '16:9' - '9:16' - '1:1' - '4:3' - '3:4' default: adaptive example: '16:9' generate_audio: type: boolean description: |- 출력 동영상에 오디오 트랙을 포함할지 여부, 기본값은 `true` **선택 가능한 값:** - `true`: 출력 동영상에 소리(음성, 효과음, 배경 음악)를 포함하며, 기본값입니다 - `false`: 무음 동영상 출력 **소리를 켜든 끄든 가격은 동일**하며 추가 요금이 없습니다. default: true example: true seed: type: integer description: |- 랜덤 시드. 생성 결과를 재현하는 데 사용하며 기본값은 랜덤 **설명:** - 범위: `0` ~ `2147483647` - 시드를 고정하면 프롬프트를 조정할 때 파라미터 변화로 인한 간섭이 줄어 재현성이 높아집니다 minimum: 0 maximum: 2147483647 example: 42 callback_url: type: string description: >- 작업 완료 후 HTTPS 콜백 주소 **콜백 시점:** - 작업 완료(completed), 실패(failed) 또는 취소(cancelled) 시 트리거 - 과금 확인 완료 후 전송 **보안 제한:** - 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: 1761313744 id: type: string description: 작업 ID example: task-unified-1774857405-abc123 model: type: string description: 실제 사용된 모델 이름 example: wan3.0-text-to-video 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 task_info: $ref: '#/components/schemas/VideoTaskInfo' description: 비디오 작업 상세 정보 type: type: string enum: - text - image - audio - video description: 작업 출력 유형 example: video usage: $ref: '#/components/schemas/VideoUsage' description: 사용량 및 과금 정보 ErrorResponse: type: object properties: error: type: object properties: code: type: string description: 오류 코드 식별자 message: type: string description: 오류 설명 type: type: string description: 오류 유형 VideoTaskInfo: type: object properties: can_cancel: type: boolean description: 작업 취소 가능 여부 example: true estimated_time: type: integer description: 예상 완료 시간(초) minimum: 0 example: 165 video_duration: type: integer description: 비디오 길이(초) example: 8 VideoUsage: type: object description: 사용량 및 과금 정보 properties: billing_rule: type: string description: 과금 규칙 enum: - per_call - per_token - per_second example: per_second credits_reserved: type: number description: 예상 소비 크레딧 minimum: 0 example: 50 user_group: type: string description: 사용자 그룹 카테고리 example: default 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 ``` ````