ナビゲーションにスキップ
BeatAPIWan 3.0Video API

Wan 3.0

Render 2–30 seconds in a single pass at 480p, 720p, or 1080p — the longest single take in the catalog.

Supported modes

ModeRequired inputRules
Text to videomodel, promptOmit images.
Image to videomodel, prompt, imagesOne image starts the render from that frame.
With referencesmodel, prompt, reference_videos or reference_audiosA reference video bills the request at 1.5x.

Reference inputs: images cannot be combined with reference_videos or reference_audios. Video and audio references use the public root fields. A request with reference video bills at 1.5x.

Async flow: Create the task, save data.id, then poll the Task with GET /v1/tasks/{task_id}. On succeeded, read data.output.media. On failed, read data.error_code and data.error_message, then follow the error and retry policy.

Using a local file? upload a local input first and pass the returned data.url.

認証

AuthorizationBearer

Send your API key as Authorization: Bearer <BEATAPI_API_KEY>.

ヘッダー

Idempotency-Keystringオプション<=255 characters

リクエスト

This endpoint expects an object.
model"wan-3.0"必須

Must be wan-3.0.

promptstring必須1-5000 characters
Video generation instructions.
imageslist of stringsオプション

Public HTTPS images. One starts an image-to-video render; more are used as visual references.

reference_videoslist of stringsオプション
Public HTTPS video references. A request that carries one is billed at 1.5x.
reference_audioslist of stringsオプション
Public HTTPS audio references.
durationintegerオプション2-30デフォルト値 5

Requested output duration in seconds. Any whole number in range; there is no long-clip surcharge.

aspect_ratioenumオプションデフォルト値 16:9
Output video aspect ratio.
許可された値:
resolutionenumオプションデフォルト値 720p
Output resolution tier. Price scales with it.
許可された値:

レスポンス

Video generation task accepted

エラー

400
Bad Request Error
401
Unauthorized Error
402
Payment Required Error
403
Forbidden Error
409
Conflict Error
429
Too Many Requests Error
500
Internal Server Error
503
Service Unavailable Error