Skip to content

veo_upsample_api_integration_guide.md

Latest commit

 

History

History
97 lines (72 loc) · 3.46 KB

veo_upsample_api_integration_guide.md

File metadata and controls

97 lines (72 loc) · 3.46 KB
Raw

Integration and Use of Veo Upsample API

This document introduces the Veo Upsample API. This API is used to upsample an already-generated Veo video to a higher resolution or export it as an animated GIF preview.

Application Process

To use the API, you first need to apply for the corresponding service on the Veo service page. If you are not logged in or registered, you will be automatically redirected to the login page.

Basic Usage

The following parameters are required when calling this API:

  • video_id: The task ID of the source video. Can be a video generated by /veo/videos, /veo/extend, /veo/reshoot, or /veo/objects.
  • action: The upsample action. Supports the following three values:
    • 1080p: Upsample the video to 1080p resolution.
    • 4k: Upsample the video to 4K resolution.
    • gif: Convert the video to an animated GIF preview.

Request Example

curl -X POST 'https://api.acedata.cloud/veo/upsample' \
  -H 'accept: application/json' \
  -H 'authorization: Bearer {token}' \
  -H 'content-type: application/json' \
  -d '{
    "video_id": "dd01fc69-e1f7-4b68-aa8c-463f6b748d11",
    "action": "4k"
  }'

Response Example

The response is the same asynchronous task format as /veo/videos. You can track the task status using the task_id at the /veo/tasks endpoint:

{
  "success": true,
  "task_id": "8f5a90ae-3f86-4c4f-86f7-7126f5e92c76",
  "trace_id": "0f3e09c2-4c2e-46ea-9cdc-a31ec48b7c12",
  "data": [
    {
      "id": "253eedc47f1c4eb2a370ed2312168f4b",
      "video_url": "https://platform.cdn.acedata.cloud/veo/8f5a90ae.mp4",
      "created_at": "2025-07-25 16:07:43",
      "complete_at": "2025-07-25 16:10:28",
      "state": "succeeded"
    }
  ]
}

The returned fields are described as follows:

  • success: Whether the upsample task was submitted successfully.
  • task_id: The ID of this upsample task.
  • data: The upsampled video result.
    • video_url: The URL of the upsampled video.

Pricing

  • action=1080p: 0.16 Credit / request
  • action=4k: 0.50 Credit / request
  • action=gif: 0.13 Credit / request

If the action value is not one of the above, the default charge is 0.50 Credit. It is recommended to always pass an explicit supported value.

Asynchronous Callback

This API supports asynchronous mode. Pass a callback_url field in the request body, and the result will be delivered via a POST request to that URL once the task completes.

Error Handling

When calling the API, if an error occurs, the API will return the corresponding error code and message. For example:

  • 400 token_mismatched: Bad request, possibly due to missing or invalid parameters.
  • 400 api_not_implemented: Bad request, possibly due to missing or invalid parameters.
  • 401 invalid_token: Unauthorized, invalid or missing authorization token.
  • 429 too_many_requests: Too many requests, you have exceeded the rate limit.
  • 500 api_error: Internal server error, something went wrong on the server.

Error Response Example

{
  "success": false,
  "error": {
    "code": "api_error",
    "message": "fetch failed"
  },
  "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}

Conclusion

Through this document, you have learned how to use the Veo Upsample API to upsample an already-generated Veo video to 1080p or 4K resolution, or export it as a GIF preview. We hope this document can help you better integrate and use this API. If you have any questions, please feel free to contact our technical support team.