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": "resp_01JCWexample",
"object": "response",
"created_at": 1745380000,
"status": "completed",
"model": "seed-2-0-lite-260428",
"output": [
{
"type": "message",
"role": "assistant",
"content": [
{
"type": "output_text",
"text": "A chef slices vegetables, then places them in a bowl."
}
]
}
],
"usage": {
"input_tokens": 2048,
"output_tokens": 256,
"total_tokens": 2304
}
}{
"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": {
"failedAsset": {
"url": "<string>",
"field": "assets.referenceImages",
"index": 1,
"mediaType": "Image",
"stage": "validation"
}
},
"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
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": "resp_01JCWexample",
"object": "response",
"created_at": 1745380000,
"status": "completed",
"model": "seed-2-0-lite-260428",
"output": [
{
"type": "message",
"role": "assistant",
"content": [
{
"type": "output_text",
"text": "A chef slices vegetables, then places them in a bowl."
}
]
}
],
"usage": {
"input_tokens": 2048,
"output_tokens": 256,
"total_tokens": 2304
}
}{
"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": {
"failedAsset": {
"url": "<string>",
"field": "assets.referenceImages",
"index": 1,
"mediaType": "Image",
"stage": "validation"
}
},
"error": "<string>"
}Body
application/json
Response
A BytePlus Responses object or typed SSE stream.
The BytePlus Responses API result, returned without reshaping.