Wan 2.6 비동기 비디오 생성

API 문서

이 엔드포인트를 사용하여 Wan 2.6 작업을 제출하고 상태를 확인하세요. 각 호출은 길이와 오디오(동기화된 대화, 효과음, 음악) 유무에 따라 크레딧을 소모합니다.

인증

모든 요청은 API 키를 헤더에 포함해야 합니다. Authorization header:

Authorization: Bearer <YOUR_API_KEY>

누락되거나 유효하지 않은 키는 반환됩니다. 401 Unauthorized.

POST

https://wan26ai.app/api/generate

생성 작업 생성

새로운 Wan 2.6 작업을 제출합니다. 호출은 렌더링이 비동기적으로 완료되는 동안 즉시 task_id 를 반환합니다.

매개변수	유형	필수	설명
model	string	예	docs.params.model
prompt	string (max 5000 chars)	예	메인 장면 설명 (텍스트 또는 이미지 흐름).
duration	string	아니요	렌더링 길이 (초 단위) ("5" 또는 "10").
resolution	string	아니요	docs.params.resolution
image_urls	string[]	아니요	선택적 참조 이미지 URL (이미지-투-비디오에 필요).
video_urls	string[]	아니요	docs.params.video_urls
callback_url	string	아니요	docs.params.callback_url
public	boolean	아니요	작업을 공개 갤러리에 노출합니다.

크레딧 소비

크레딧은 작업이 생성될 때 차감됩니다. 실패한 작업은 자동으로 환불됩니다.

사전 설정	차감된 크레딧
720p × 5s	80
720p × 10s	150
720p × 15s	220
1080p × 5s	115
1080p × 10s	220
1080p × 15s	325

요청 예시

{
  "model": "wan/2-6-text-to-video",
  "prompt": "A golden retriever running through a sunlit meadow, slow motion, cinematic",
  "duration": "5",
  "resolution": "1080p"
}

// Image-to-Video example:
{
  "model": "wan/2-6-image-to-video",
  "prompt": "Add gentle wind motion to the scene",
  "duration": "5",
  "resolution": "720p",
  "image_urls": ["https://example.com/reference.jpg"]
}

// Video-to-Video example:
{
  "model": "wan/2-6-video-to-video",
  "prompt": "Transform to anime style",
  "duration": "5",
  "resolution": "720p",
  "video_urls": ["https://example.com/source.mp4"]
}

응답 예시

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "n35abc123def456wan26",
    "status": "IN_PROGRESS"
  }
}

GET / POST

https://wan26ai.app/api/status

작업 상태 확인

이 엔드포인트를 사용하여 최신 기록을 폴링하세요. 작업이 여전히 IN_PROGRESS(진행 중) 상태일 때는 응답하기 전에 공급자에게 한 번 더 쿼리합니다.

매개변수	유형	필수	설명
task_id	string	예	/generate에서 반환된 ID. 쿼리 (?task_id=) 또는 JSON 본문을 통해 전송합니다.

필드	설명
task_id	/generate에서 반환된 ID.
status	SUCCESS (성공)
request	제출된 페이로드의 정리된 복사본.
response	상태가 SUCCESS일 때의 미디어 URL 배열.
consumed_credits	작업에 청구된 크레딧 (환불 시 0).
error_message	상태가 FAILED일 때의 공급자 오류 메시지.
created_at	작업이 저장된 UTC 타임스탬프.

요청 예시

GET https://wan26ai.app/api/status?task_id=n35abc123def456wan26
Authorization: Bearer <YOUR_API_KEY>

# or POST
POST https://wan26ai.app/api/status
Authorization: Bearer <YOUR_API_KEY>
Content-Type: application/json

{
  "task_id": "n35abc123def456wan26"
}

응답 예시

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "n35abc123def456wan26",
    "status": "SUCCESS",
    "request": {
      "model": "wan/2-6-text-to-video",
      "prompt": "A golden retriever running through a sunlit meadow",
      "duration": "5",
      "resolution": "1080p"
    },
    "response": [
      "https://static.gogloai.com/wan26/video_001.mp4"
    ],
    "consumed_credits": 115,
    "error_message": null,
    "created_at": "2025-12-17T10:30:00Z"
  }
}

오류 처리

401 Unauthorized - API 키 누락 또는 유효하지 않음.
402 Payment Required - 크레딧 잔액이 차감액을 충당할 수 없음.
429 Too Many Requests - 폴링 간격 또는 요청 속도를 줄이십시오.
500 - 일시적인 문제; 지수 백오프를 사용하여 다시 시도하십시오.