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": []
},
"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": {},
"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. Use the same API key that created the task; another key in the same workspace cannot retrieve it.
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": []
},
"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": {},
"error": "<string>"
}Authorizations
A workspace API key beginning with gengen_live_.
Path Parameters
The public task ID returned by the create endpoint. URL-encode the ID when placing it in the path, including any colon in the provider prefix.
Response
The latest task state and outputs.
Standard task fields are listed first. Additional provider-native and legacy aliases can be appended for compatibility.
Public GENGEN task ID.
Public model ID selected for the task.
Task state. Common values include pending, queued, running,
processing, succeeded, completed, failed, cancelled, and
expired.
Show child attributes
Show child attributes
Compatibility timestamp returned by a provider or legacy endpoint.
Compatibility timestamp returned by a provider or legacy endpoint.
Compatibility timestamp returned by a provider or legacy endpoint.
Compatibility alias for id.
Compatibility alias for the first video output.
Compatibility alias for outputs.videos.
Compatibility-only provider field containing the effective Seedance 2.5 output format.
mp4, mov