Transfer video bytes
Source-generated PUT /video-uploads/{upload_id}/content reference: authentication, fields, responses, errors, and operational safeguards.
On this page
Operation
PUT /video-uploads/{upload_id}/content
operationId: transfer_video_upload_v1_video_uploads__upload_id__content_put
Transfer raw video bytes using the returned PUT URL and X-AnimGen-Upload-Token; never attach API/OAuth credentials. Match Content-Type and byte_size exactly. Streaming is bounded even without Content-Length. Complete the upload before quoting/creating with its file ID.
Authentication and side effects
Use the complete returned signed URL. Do not attach a Bearer key.
This operation does not start paid generation. Other state changes are described above.
Parameters
| Parameter | Location | Type | Required | Constraints / default | Meaning |
|---|---|---|---|---|---|
upload_id |
path |
string |
Yes | format: uuid |
Owned public resource UUID; task, asset, and file IDs are not interchangeable. |
X-AnimGen-Upload-Token |
header |
string |
Yes | — | — |
Request body (application/octet-stream)
Body required: true
No object fields. See the schema type and constraints.
Responses
| HTTP | Body | Meaning |
|---|---|---|
204 |
— | Video bytes transferred; complete the session next. |
400 |
APIErrorEnvelope | Invalid input; correct the request before retrying. |
401 |
APIErrorEnvelope | Missing, expired, or revoked API key. |
403 |
APIErrorEnvelope | Account eligibility, account status, or key scope does not allow this operation. |
404 |
APIErrorEnvelope | Resource is unavailable, not owned, or its signature is invalid/expired. |
409 |
APIErrorEnvelope | Idempotency conflict; only IDEMPOTENCY_IN_PROGRESS is retryable with the original request. |
410 |
APIErrorEnvelope | Upload session expired; prepare a new upload. |
413 |
APIErrorEnvelope | Request or decoded image exceeds the configured limit. |
415 |
APIErrorEnvelope | Use supported image media types. |
422 |
APIErrorEnvelope | Video metadata or size is invalid. |
429 |
APIErrorEnvelope | Account-wide rate or queue limit; wait for Retry-After. |
500 |
APIErrorEnvelope | Internal failure; preserve the task/key and retry only when marked retryable. |
503 |
APIErrorEnvelope | Service/provider unavailable; retry only when error.retryable is true. |
Response headers
| HTTP | Header | Type | Meaning |
|---|---|---|---|
429 |
Retry-After |
integer |
Suggested wait in seconds; respect the server value and an overall deadline. |
503 |
Retry-After |
integer |
Suggested wait in seconds; respect the server value and an overall deadline. |
Related guides
Was this page helpful?
No search queries, code, or free text are collected. This switch controls documentation interactions only; general site analytics follow the privacy policy. Privacy policy