GET
/v1/schemas/byteplus/video/contents/generations/tasks/{id}?kind=output
Accept:
| field | recorded source |
|---|---|
| schema | Source linked above. generated Source tracee3379046f28d4628702fa094c1ce8678f3e103e6579a5dad417f19e5c90f67e3{
"fetchedAt": 1791090611,
"extractorVersion": "1",
"verifiedAt": null
} |
Response body
25 properties · 9 required · 5 $defs| property | type | description | constraints |
|---|---|---|---|
| id* | string | Task id returned by the create call. | |
| model* | string | ||
| status* | string | queued, running, succeeded, failed, or cancelled. The video URL is present once this is succeeded. A task can also be marked expired when execution_expires_after elapses. | |
| content* | Content | Output of a completed task. video_url is the file; last_frame_url is set when the create call passed return_last_frame: true. Both URLs are valid for 24 hours. | |
| usage* | Usage | ||
| frames* | integer | ||
| framespersecond* | integer | ||
| created_at* | integer | ||
| updated_at* | integer | ||
| safety_identifier | string | ||
| error | ContentGenerationError | ||
| subdivisionlevel | string | ||
| fileformat | string | ||
| resolution | string | ||
| ratio | string | ||
| output_format | string | ||
| duration | integer | ||
| seed | integer | ||
| revised_prompt | string | ||
| service_tier | string | ||
| execution_expires_after | integer | ||
| priority | integer | ||
| generate_audio | boolean | ||
| draft | boolean | ||
| draft_task_id | string |
Types
5 $defsCompletionTokensDetailsobject
| reasoning_tokens* | integer | ||
| provisioned_tokens | integer |
Contentobject
| video_url* | string | URL of the generated video. Present when status is succeeded. Valid for 24 hours; a Dreamina Seedance 2.5 URL can be downloaded up to 100 times. Download or copy it before it expires. | |
| last_frame_url* | string | URL of the last frame. Returned when the create call set return_last_frame: true. Valid for 24 hours. | |
| file_url* | string |
ContentGenerationErrorobject
| code* | string | ||
| message* | string |
PromptTokensDetailobject
| cached_tokens* | integer | ||
| provisioned_tokens | integer |
Usageobject
| prompt_tokens* | integer | ||
| completion_tokens* | integer | ||
| total_tokens* | integer | ||
| prompt_tokens_details* | PromptTokensDetail | ||
| completion_tokens_details* | CompletionTokensDetails |
Validate a payload
before you spend tokensshell
$ curl -X POST https://modelschemas.com/v1/validate \
-d '{"provider":"byteplus","endpointId":"contents/generations/tasks/{id}","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}