wan3.0-video-prime API

Sử dụng ID mẫu chính xác wan3.0-video-prime. Trường mô hình phải khớp chính xác với trang này.

Đầu ra mẫuwan3.0-video-primePOST /v1/videos5.0s

Thông số: duration=5resolution=1080Pratio=16:9

Câu lệnh: A smooth gimbal shot glides through a sunlit modern living room with concrete walls, warm oak furniture and floor-to-ceiling windows overlooking a pine forest. Dust motes float in the light beams, curtains move gently. Architectural visualization quality, photoreal, no text.

Yêu cầu tạo ra mẫu này

{
  "model": "wan3.0-video-prime",
  "prompt": "A smooth gimbal shot glides through a sunlit modern living room with concrete walls, warm oak furniture and floor-to-ceiling windows overlooking a pine forest. Dust motes float in the light beams, curtains move gently. Architectural visualization quality, photoreal, no text.",
  "seconds": "5",
  "duration": 5,
  "resolution": "1080P",
  "ratio": "16:9",
  "aspect_ratio": "16:9"
}

Xác thực và điểm cuối

Sử dụng khóa API Modelflare với https://modelflare.dev/v1. Điểm vào cổng là POST /v1/videos.

HTTP

Authorization: Bearer YOUR_MODELFLARE_API_KEY

Tạo nhiệm vụ

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan3.0-video-prime",
    "input": {"prompt": "A white cat runs through a neon-lit street in the rain, cinematic tracking shot"},
    "parameters": {"resolution": "1080P", "duration": 5, "audio": true}
  }'

Thăm dò ý kiến và tải xuống

Lưu ID nhiệm vụ. Thăm dò GET /v1/videos/{task_id} và tải xuống với GET /v1/videos/{task_id}/content. URL kết quả có thể hết hạn, vì vậy hãy chuyển tệp ngay.

bash

curl https://modelflare.dev/v1/videos/TASK_ID \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY"

Ghi chú yêu cầu

Wan thường sử dụng input và parameters; không được trộn lẫn các chế độ hướng dẫn khung và phương tiện tham chiếu.

Tham số yêu cầu

Wan3.0 sử dụng input.prompt hoặc input.media với các điều khiển đầu ra trong parameters. Phương tiện có thể đại diện cho khung, tài liệu tham khảo, âm thanh, tệp hoặc trang web.

Cánh đồng	Bắt buộc	Ghi chú
model	Có	wan3.0-video-prime
input.prompt	Có điều kiện	Cung cấp cái này hoặc input.media
input.media[]	Có điều kiện	first_frame, last_frame, reference_*, file hoặc link
parameters.resolution	Không	480P / 720P / 1080P (mặc định 1080P)
parameters.ratio	Không	16:9 / 9:16 / 1:1 / 4:3 / 3:4 / adaptive
parameters.duration	Không	2–30 giây hoặc -1 trong thời gian tự động
parameters.audio	Không	Có tạo âm thanh đồng bộ hay không
parameters.prompt_extend	Không	Đặt sai khi hợp đồng mô hình chuyên dụng này yêu cầu
parameters.seed	Không	Hạt giống ngẫu nhiên tùy chọn
parameters.watermark	Không	Có nên thêm hình mờ hay không

Giới hạn đầu vào và đầu ra

Wan3.0 hỗ trợ văn bản, khung hình đầu tiên/cuối cùng, tối đa 10 hình ảnh tham chiếu, 5 video tham chiếu, 5 clip âm thanh tham chiếu và một đầu vào tệp hoặc trang web. Đầu ra là 480P, 720P hoặc 1080P trong 2–30 giây hoặc định giờ tự động -1. Khung hình đầu tiên/cuối cùng, phương tiện tham chiếu, tệp và trang web là các quy trình làm việc loại trừ lẫn nhau được chọn bởi input.media[].type.

Ví dụ về quy trình làm việc được ghi lại

Wan3.0 sử dụng một phong bì input/parameters cho văn bản, hướng dẫn khung, phương tiện tham chiếu, tệp và trang web; những quy trình công việc này loại trừ lẫn nhau.

Khung hình đầu tiên và cuối cùng

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan3.0-video-prime",
    "input": {"prompt": "镜头从第一帧平滑推进到最后一帧", "media": [
      {"type": "first_frame", "url": "https://example.com/first.png"},
      {"type": "last_frame", "url": "https://example.com/last.png"}
    ]},
    "parameters": {"resolution": "1080P", "duration": 8, "ratio": "adaptive", "audio": true}
  }'

Phương tiện tham khảo

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan3.0-video-prime",
    "input": {"prompt": "保持角色、动作和音色一致", "media": [
      {"type": "reference_image", "url": "https://example.com/character.png"},
      {"type": "reference_video", "url": "https://example.com/motion.mp4"},
      {"type": "reference_audio", "url": "https://example.com/voice.mp3"}
    ]},
    "parameters": {"resolution": "720P", "duration": -1, "ratio": "adaptive"}
  }'

Lỗi và tác vụ không thành công

Tham số mô hình không hợp lệ trả về 4xx cùng với ID yêu cầu. Tác vụ không đồng bộ cũng có thể bị lỗi sau khi quá trình tạo thành công; sử dụng error_code và error_message từ phản hồi thăm dò làm lý do nhiệm vụ cuối cùng. Đừng thử lại cùng một yêu cầu với hình dạng JSON khác.

Phạm vi được hỗ trợ

Trang này bao gồm các cuộc gọi chỉnh sửa và tạo mô hình Modelflare. Tính năng làm giàu bản đồ hoặc tìm kiếm, quản lý giọng nói và quản lý thư viện thành phần là các API tài nguyên nằm ngoài bề mặt lệnh gọi mô hình công khai này và không phải là các trường yêu cầu bắt buộc.

Định giá và thanh toán

Mô hình này sử dụng tính phí video theo giây. Xem trang định giá mẫu để biết giá khách hàng hiện tại, giá niêm yết tham khảo và thông số kỹ thuật đầy đủ.

Ghi chú

Trang này ghi lại giao diện công cộng của Modelflare; các trường và giới hạn hiển thị ở đây là hợp đồng hiện tại.

Các biến thể

ID mẫu	Sự khác biệt
wan3.0-video-prime	Mô hình được ghi lại trên trang này.