# Wan 3.0 Prime

> Alibaba's Wan 3.0 Prime generates video from a text prompt (or an optional starting image) with coherent motion and lighting, at 480p, 720p or 1080p and 2 to 30 seconds long.

- **Provider**: replicate
- **Model ID**: alibaba/wan-3-prime
- **Category**: video_generation
- **Credits**: 3260 per request
- **Pricing Type**: input_based

## API Endpoint

Base URL: https://api.core.today/v1

### Create Prediction
POST /predictions

### Get Status
GET /predictions/{job_id}

### Cancel
DELETE /predictions/{job_id}

## Authentication

Header: `X-API-Key: YOUR_API_KEY`

## Input Parameters

- `duration` (integer, optional): Duration of the generated video in seconds (Default: `5`; Range: min: 2, max: 30)
- `image` (string, optional): Optional first-frame image to animate into a video (jpg/png/bmp/webp, ≤10MB). When provided, the video is generated from this image guided by the prompt.
- `aspect_ratio` (string, optional): Aspect ratio of the generated video. 'adaptive' lets the model choose the best ratio for the prompt. Ignored when an image is provided (the input image's aspect ratio is used). (Default: `adaptive`; Options: `adaptive`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4`)
- `seed` (integer, optional): Random seed for reproducible generation. Range: 0-2147483647
- `negative_prompt` (string, optional): Negative prompt — describes content that should not appear in the video (Default: ``)
- `prompt` (string, **required**): Text prompt for video generation. Up to 20000 characters (Alibaba Wan 3.0). Each Chinese character or letter counts as one; text beyond the limit is silently truncated upstream (not rejected), so the gateway rejects it up front instead.
- `resolution` (string, optional): Output video resolution (Default: `1080p`; Options: `480p`, `720p`, `1080p`)
- `enable_prompt_expansion` (boolean, optional): Automatically expand and optimize the prompt for better results. Improves quality for short prompts but increases latency. (Default: `True`)

## Example Request

```json
{
  "model": "alibaba/wan-3-prime",
  "input": {
    "duration": 5,
    "aspect_ratio": "adaptive",
    "prompt": "a man doing jumping jacks",
    "resolution": "1080p",
    "negative_prompt": "",
    "enable_prompt_expansion": true
  }
}
```

## Response Format

```json
{
  "job_id": "abc123",
  "status": "pending",
  "provider": "replicate",
  "model": "black-forest-labs/flux-schnell",
  "created_at": "2026-01-01T00:00:00Z",
  "result": null,
  "error": null
}
```

Status values: `pending`, `processing`, `completed`, `failed`, `cancelled`

## Usage Flow

1. POST /predictions with model and input → receive job_id
2. Poll GET /predictions/{job_id} until status is `completed` or `failed`
3. Result contains output URL(s) or data

## Output Type

url

## Tags

wan, alibaba, video-generation, text-to-video, image-to-video, long-form

## Documentation

https://replicate.com/alibaba/wan-3-prime