curl --request POST \
--url https://gengen.farm/api/gengen/v1/responses \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "seed-2-0-lite-260428",
"input": [
{
"role": "user",
"content": [
{
"type": "input_video",
"file_id": "file-20251018abcdefg"
},
{
"type": "input_text",
"text": "Describe the sequence of actions in the video."
}
]
}
]
}
'{
"id": "<string>",
"object": "response",
"created_at": 123,
"status": "<string>",
"model": "<string>",
"output": [
{}
],
"output_text": "<string>",
"usage": {
"input_tokens": 1,
"output_tokens": 1,
"total_tokens": 1,
"input_tokens_details": {},
"output_tokens_details": {}
},
"error": {}
}{
"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": "seedance.insufficient_balance",
"error": "Insufficient available balance"
}{
"error_code": "gengen.api_key_revoked",
"error": "GENGEN API key has been revoked"
}{
"error_code": "<string>",
"error_params": {},
"error": "<string>"
}Video API
Create a video understanding response
Analyze a video with the BytePlus Responses API. Supply a
provider-recognized file_id, a public URL, or a Base64 data URL.
Set stream: true for native Responses SSE events; otherwise the upstream
Responses object is returned as a single JSON document. Terminal events are
delivered after wallet settlement. Background execution is not supported.
POST
/
responses
curl --request POST \
--url https://gengen.farm/api/gengen/v1/responses \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "seed-2-0-lite-260428",
"input": [
{
"role": "user",
"content": [
{
"type": "input_video",
"file_id": "file-20251018abcdefg"
},
{
"type": "input_text",
"text": "Describe the sequence of actions in the video."
}
]
}
]
}
'{
"id": "<string>",
"object": "response",
"created_at": 123,
"status": "<string>",
"model": "<string>",
"output": [
{}
],
"output_text": "<string>",
"usage": {
"input_tokens": 1,
"output_tokens": 1,
"total_tokens": 1,
"input_tokens_details": {},
"output_tokens_details": {}
},
"error": {}
}{
"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": "seedance.insufficient_balance",
"error": "Insufficient available balance"
}{
"error_code": "gengen.api_key_revoked",
"error": "GENGEN API key has been revoked"
}{
"error_code": "<string>",
"error_params": {},
"error": "<string>"
}Authorizations
A workspace API key beginning with gengen_live_.
Body
application/json
Supported values:
seed-2-0-lite-260428— Seed 2.0 Litedola-seed-2-1-turbo-260628— Seed 2.1 Turboseed-2-0-pro-260328— Seed 2.0 Pro
Available options:
seed-2-0-lite-260428, dola-seed-2-1-turbo-260628, seed-2-0-pro-260328 Minimum array length:
1- Option 1
- Option 2
- Option 3
Show child attributes
Show child attributes
Return native Responses SSE events with final usage and wallet settlement.
Background execution is not supported.
Optional provider caching configuration.
Required range:
x >= 1Response
A BytePlus Responses object or typed SSE stream.
The BytePlus Responses API result, returned without reshaping.