curl --request GET \
--url https://gengen.farm/api/gengen/v1/contents/generations/tasks/{id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://gengen.farm/api/gengen/v1/contents/generations/tasks/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
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));{
"id": "seedance20:cgt-20260419-abcdef1234567890",
"model": "dreamina-seedance-2-0-260128",
"status": "succeeded",
"outputs": {
"videos": [
"https://example.com/generated-video.mp4"
],
"images": []
},
"usage": {
"completion_tokens": 23040,
"total_tokens": 23040
},
"createdAt": "2026-04-19T08:00:00.000Z",
"updatedAt": "2026-04-19T08:01:30.000Z",
"statusUpdateTime": "2026-04-19T08:01:30.000Z"
}{
"error_code": "gengen.model_required",
"error_params": {
"field": "model"
},
"error": "A model is required"
}{
"error_code": "gengen.auth_required",
"error": "Missing Authorization bearer token"
}{
"error_code": "gengen.api_key_revoked",
"error": "GENGEN API key has been revoked"
}{
"error_code": "seedance.task_not_found",
"error": "Seedance task was not found for this API key"
}{
"error_code": "<string>",
"error_params": {
"failedAsset": {
"url": "<string>",
"field": "assets.referenceImages",
"index": 1,
"mediaType": "Image",
"stage": "validation"
}
},
"error": "<string>"
}Retrieve a video generation task
Retrieve the latest task state from the selected provider. A successful
terminal retrieval can finalize the wallet charge associated with the task.
Seedance returns provider token counts in usage when available.
completion_tokens counts generated tokens and total_tokens is the
provider’s total. Other models have their own usage fields on their
respective retrieve pages.
Use the same API key that created the task; another key in the same workspace
cannot retrieve it.
During automatic reference registration, stage is preparingAssets.
If a reference fails, error.failedAsset.url identifies the original input,
with field and zero-based index identifying its normalized position.
Signed query parameters are preserved. Polling a failed task still returns
HTTP 200; inspect status and error.
Seedance retrieval adds a non-error message when the task is still
processing and the upstream creation time is more than 420 seconds old.
Exactly 420 seconds, pending or terminal states, and missing, invalid,
or future upstream creation times do not trigger this notice. Local queue
timestamps are not used as a fallback. Continue polling the same task.
curl --request GET \
--url https://gengen.farm/api/gengen/v1/contents/generations/tasks/{id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://gengen.farm/api/gengen/v1/contents/generations/tasks/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
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));{
"id": "seedance20:cgt-20260419-abcdef1234567890",
"model": "dreamina-seedance-2-0-260128",
"status": "succeeded",
"outputs": {
"videos": [
"https://example.com/generated-video.mp4"
],
"images": []
},
"usage": {
"completion_tokens": 23040,
"total_tokens": 23040
},
"createdAt": "2026-04-19T08:00:00.000Z",
"updatedAt": "2026-04-19T08:01:30.000Z",
"statusUpdateTime": "2026-04-19T08:01:30.000Z"
}{
"error_code": "gengen.model_required",
"error_params": {
"field": "model"
},
"error": "A model is required"
}{
"error_code": "gengen.auth_required",
"error": "Missing Authorization bearer token"
}{
"error_code": "gengen.api_key_revoked",
"error": "GENGEN API key has been revoked"
}{
"error_code": "seedance.task_not_found",
"error": "Seedance task was not found for this API key"
}{
"error_code": "<string>",
"error_params": {
"failedAsset": {
"url": "<string>",
"field": "assets.referenceImages",
"index": 1,
"mediaType": "Image",
"stage": "validation"
}
},
"error": "<string>"
}Path Parameters
Response
The latest task state and outputs.
Standard task fields are listed first. Additional provider-native and legacy aliases can be appended for compatibility.
Optional informational notice for a Seedance task that is still processing more than 420 seconds after upstream creation. This notice is omitted otherwise; existing upstream passthrough messages are unchanged.
"Video generation is taking longer than usual. Seedance may be experiencing high demand. Your video is still generating."