curl --request POST \
--url https://gengen.farm/api/gengen/v1/contents/generations/tasks \
--header 'Authorization: Bearer gengen_live_xxxxxxxxxxxxxxxx' \
--header 'Content-Type: application/json' \
--data '{"model":"wan-3.0-pro-spicy","prompt":"A sailboat enters the harbor at sunrise.","controls":{"resolution":"2k","duration":5}}'{
"id": "wan27:task_123",
"model": "wan2.7-i2v-spicy",
"status": "pending",
"outputs": {
"videos": [],
"images": []
},
"createdAt": "2026-06-17T08:00:00.000Z",
"updatedAt": "2026-06-17T08:00:00.000Z",
"statusUpdateTime": "2026-06-17T08:00:00.000Z"
}{
"error_code": "<string>",
"error": "<string>",
"error_params": {}
}{
"error_code": "<string>",
"error": "<string>",
"error_params": {}
}{
"error_code": "<string>",
"error": "<string>",
"error_params": {}
}{
"error_code": "<string>",
"error": "<string>",
"error_params": {}
}{
"error_code": "<string>",
"error": "<string>",
"error_params": {}
}Video API
Create a Wan video task
Choose one of four Wan 3.0 Spicy models, Wan 2.7 image to video, or Wan Animate motion transfer.
POST
/
contents
/
generations
/
tasks
curl --request POST \
--url https://gengen.farm/api/gengen/v1/contents/generations/tasks \
--header 'Authorization: Bearer gengen_live_xxxxxxxxxxxxxxxx' \
--header 'Content-Type: application/json' \
--data '{"model":"wan-3.0-pro-spicy","prompt":"A sailboat enters the harbor at sunrise.","controls":{"resolution":"2k","duration":5}}'{
"id": "wan27:task_123",
"model": "wan2.7-i2v-spicy",
"status": "pending",
"outputs": {
"videos": [],
"images": []
},
"createdAt": "2026-06-17T08:00:00.000Z",
"updatedAt": "2026-06-17T08:00:00.000Z",
"statusUpdateTime": "2026-06-17T08:00:00.000Z"
}{
"error_code": "<string>",
"error": "<string>",
"error_params": {}
}{
"error_code": "<string>",
"error": "<string>",
"error_params": {}
}{
"error_code": "<string>",
"error": "<string>",
"error_params": {}
}{
"error_code": "<string>",
"error": "<string>",
"error_params": {}
}{
"error_code": "<string>",
"error": "<string>",
"error_params": {}
}Wan 3.0 Spicy
The following requirements apply to the four models in the Wan 3.0 Spicy Body tab.| Model | Output resolutions |
|---|---|
wan-3.0-spicy | 480p, 720p, 1080p |
wan-3.0-prime-spicy | 480p, 720p, 1080p |
wan-3.0-pro-spicy | 1080p, 2k, 4k |
wan-3.0-prime-pro-spicy | 1080p, 2k, 4k |
Media inputs
Supply public HTTP or HTTPS URLs. A signed URL is usable if it can be read without additional headers. Extensionless media links are supported. Data URIs and bare Base64 are rejected. GENGEN measures each reference video and supplies that same version to the provider. For mutable URLs, the provider reads a private copy using a link valid for 24 hours. The copy becomes eligible for automatic deletion one day after upload, regardless of task status. This policy applies only to the reference copy.| Input | Per-file requirements | Per-request limits |
|---|---|---|
| Keyframe or reference image | JPEG, PNG without alpha, BMP or WebP. Up to 20 MB, sides 240–8000 px, longest/shortest side ≤8 | One first and one last frame, or up to 10 reference images |
| Reference video | MP4 or MOV, up to 100 MB, sides 240–4096 px, longest/shortest side ≤8, 1–15 seconds | Up to 5, at most 15 seconds combined |
| Reference audio | WAV or MP3, up to 15 MB, 1–15 seconds | Up to 5, at most 15 seconds combined |
| Document | DOCX, DOC, XLSX, XLS, PPTX, PPT, PDF, TXT, KEY, PAGES, NUMBERS or MD, up to 100 MB. PDF, DOCX, DOC, PPTX, PPT, KEY and PAGES have a 50-page limit | One document or one public web page |
Video duration
All four editions accept 2–30 seconds of output, or-1 for smart duration. With reference videos, the sum of all reference video lengths plus the generated video length must be at most 30 seconds. The references themselves may total at most 15 seconds. For example, two clips of 4 and 6 seconds allow up to 20 seconds of output. Upload, queue and processing time do not count. GENGEN checks reference video lengths before submission. The provider also validates the media and enforces the combined limit.
Text to video
{"model":"wan-3.0-pro-spicy","prompt":"A sailboat enters the harbor at sunrise.","controls":{"resolution":"2k","duration":5}}
Keyframes
A single last frame is sufficient. You may also supply a first frame or both.{"model":"wan-3.0-spicy","assets":{"lastFrameImage":"https://example.com/harbor.jpg"}}
References
Keyframes and reference inputs are mutually exclusive. UseproviderOptions.wan.file for a document or providerOptions.wan.link for a public web page.
{"model":"wan-3.0-prime-spicy","prompt":"Follow Video 1 with the colors of Image 1.","assets":{"referenceImages":["https://example.com/palette.jpg"],"referenceVideos":["https://example.com/motion.mp4"]},"controls":{"duration":-1}}
Wan 3.0 Spicy billing
The charge uses the model and resolution rate applied at submission, multiplied by measured output video seconds plus total input video seconds. Smart duration reserves up to 30 combined seconds. Disabling audio does not change the price. Failed tasks incur no generation charge. See pricing. For pending tasks, poll the returned ID. The successful task detail includesusage with billable seconds and the applicable price row. See usage fields.Body
application/json
- Wan 3.0 Spicy
- Wan 2.7 image to video
- Wan Animate motion transfer
Supply a prompt, keyframes, or references. Media inputs must be public HTTP or HTTPS URLs. Keyframes and references are mutually exclusive.
Response
The task was accepted.