Retrieve Wan video task
curl --request GET \
--url https://gengen.farm/api/gengen/v1/contents/generations/tasks/{id}import requests
url = "https://gengen.farm/api/gengen/v1/contents/generations/tasks/{id}"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://gengen.farm/api/gengen/v1/contents/generations/tasks/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));Video API
Retrieve Wan video task
Retrieve status and video outputs for a Wan 2.7, Wan Animate or Wan 3.0 Spicy task.
Retrieve Wan video task
curl --request GET \
--url https://gengen.farm/api/gengen/v1/contents/generations/tasks/{id}import requests
url = "https://gengen.farm/api/gengen/v1/contents/generations/tasks/{id}"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://gengen.farm/api/gengen/v1/contents/generations/tasks/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));GET https://gengen.farm/api/gengen/v1/contents/generations/tasks/{id}
Path parameter
Pass the complete ID returned at creation. Wan 2.7 uses
wan27:, Wan Animate uses wananimate:, and Wan 3.0 Spicy uses <public-model-id>:<uuid>. URL-encode the ID when placing it in
the path.curl --request GET \
--url https://gengen.farm/api/gengen/v1/contents/generations/tasks/wan27%3Awan-remote-task \
--header 'Authorization: Bearer gengen_live_xxxxxxxxxxxxxxxx'
Response
{
"id": "wan27:wan-remote-task",
"model": "wan2.7-i2v-spicy",
"status": "succeeded",
"outputs": {
"videos": [
"https://example.com/wan-output.mp4"
],
"images": []
},
"usage": {
"priceRowId": "wan-27-720-video",
"resolution": "720p",
"requestedDurationSeconds": 5,
"billableSeconds": 5
},
"createdAt": "2026-06-17T08:00:00.000Z",
"updatedAt": "2026-06-17T08:01:00.000Z",
"statusUpdateTime": "2026-06-17T08:01:00.000Z"
}
| Field | Type | Description |
|---|---|---|
id | string | Public GENGEN task ID |
model | string | Public model ID selected at creation |
status | string | Normalized task status |
outputs.videos | string[] | Generated video URLs after success |
outputs.images | string[] | Reserved image outputs; empty for Wan video tasks |
usage | object | Billable seconds and the price row on success. See Usage. |
createdAt | string | ISO 8601 task creation time when available |
updatedAt | string | ISO 8601 latest update time when available |
statusUpdateTime | string | ISO 8601 status transition time when available |
outputs.videos contains the original provider download URLs. GENGEN reads the generated video to measure its billable duration and returns the provider URL directly.
If generation fails, read error.message for the provider’s reason and error.upstreamCode when supplied. An accepted task can report a media or duration error asynchronously with HTTP 200 and status: "failed".
Pending work can report pending or processing. Wan 3.0 Spicy can also report retrying. A successful task reports succeeded.
A task is visible only to the authorized GENGEN API key scope that owns it. Retrieve requests
do not create a new generation charge.
Usage
On success,usage.resolution is the pricing tier string (for example, "720p"). Match usage.priceRowId to the same model in the price catalog and multiply its per-second rate by usage.billableSeconds.
| Model | How to read the seconds |
|---|---|
| Wan 2.7 Spicy | requestedDurationSeconds is the requested length when available. Billing uses whole seconds. |
| Wan Animate | inputVideoDurationSeconds is the source length when available. Billing rounds it up to a whole second. |
| Wan 3.0 Spicy, Prime Spicy, Pro Spicy and Prime Pro Spicy | outputDurationSeconds is the generated length and inputVideoDurationSeconds is the combined reference-video length. billableSeconds includes both and can be fractional. |