How do I call the endpoint?

Send an HTTP request to https://api.acedata.cloud/veo/tasks with a Bearer token in the Authorization header. See the documentation for request parameters and response format.

What authentication does Veo Video Generation require?

All 辰汐ai APIs use Bearer token authentication. Get your API key from the platform dashboard at https://chens.platform.acedata.cloud and include it as: Authorization: Bearer YOUR_TOKEN

How much does Veo Video Generation cost?

Veo Video Generation uses pay-as-you-go pricing with no monthly fees. Each API call costs credits based on the model and parameters used. Visit the service page for detailed pricing.

辰汐ai

Veo Tasks API

POSThttps://api.acedata.cloud/veo/tasks

This API can be used to query the video generation tasks of Veo.

Agent integrations

Related Products

Veo - 辰汐ai

Veo video generation platform, directly interfaces with this API, high-speed and stable availability.

https://hub.acedata.cloud/veo

Request Headers

acceptstring

Specify the response format returned by the server.

Please select

authorizationstring

Bearer token

Request Body

idstring

I see the ID of the task.

idsarray

List of task IDs for Veo.

typestring

Optional task type filter.

limitinteger

The maximum number of tasks returned.

actionstringRequired parameter

Operation type. Use `retrieve` to get a single task, and use `retrieve_batch` to batch retrieve multiple tasks.

offsetinteger

The number of matching tasks skipped during the list query.

trace_idstring

The tracking ID of the single task to be queried.

trace_idsarray

Tracking IDs for multiple tasks to be queried.

created_at_maxnumber

Only return tasks created before this Unix timestamp.

created_at_minnumber

Only return tasks created after the specified Unix timestamp.

Response

Operation executed successfully.

Response Body

idstring

Task ID.

typestring

Task type.

api_idstring

API Identifier.

elapsednumber

Processing duration (seconds).

requestobject

Standardized request parameters for recorded tasks.

object <string, unknown>

user_idstring

The account to which the task belongs.

responseoneOf

The result after the task is completed; do not return while the task is still running.

oneOf 1

costobject

Billing details for a single call (if any).

object <string, unknown>

dataarray

Generate video list.

Array of

idstring

Generated video identifier.

statestring

Current generation status.

video_urlstring

The download link will be available after successful generation.

created_atstring

The time of video generation creation.

complete_atstring

The time for video generation to reach the final state.

aspect_ratiostring

The aspect ratio returned by the interface.

is_extend_resultboolean

Is the video generated by an extended operation?

elapsednumber

Processing duration (seconds).

successboolean

Generation success completion.

task_idstring

Task ID for subsequent queries.

trace_idstring

Request tracking ID.

started_atnumber

Process start time, Unix timestamp (seconds).

finished_atnumber

Processing completion time, Unix timestamp (seconds).

oneOf 2

errorobject

codestring

Stable error code.

messagestring

Human-readable error message.

successboolean

Was the task execution successful?

trace_idstring

Request tracking ID.

created_atnumber

Task creation time, Unix timestamp (seconds).

started_atnumber

Process start time, Unix timestamp (seconds).

finished_atnumber

Processing completion time, Unix timestamp (seconds).

actor_user_idstring

Account for executing the authorization request.

credential_idstring

Credentials used to start tasks.

application_idstring

Application for billing.

authorization_idstring

Authorization used when starting the task.

Example

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "type": "videos",
  "elapsed": 45.3,
  "request": {
    "action": "text2video",
    "prompt": "A ceramic mug"
  },
  "response": {
    "data": [
      {
        "id": "veo-video-01",
        "state": "succeeded",
        "video_url": "https://cdn.acedata.cloud/veo/veo-video-01.mp4",
        "created_at": "2026-08-09T14:30:00Z",
        "complete_at": "2026-08-09T14:30:45Z"
      }
    ],
    "elapsed": 45.333,
    "success": true,
    "task_id": "550e8400-e29b-41d4-a716-446655440000",
    "trace_id": "550e8400-e29b-41d4-a716-446655440001",
    "started_at": 1786281000.123,
    "finished_at": 1786281045.456
  },
  "trace_id": "550e8400-e29b-41d4-a716-446655440001",
  "created_at": 1786281000.1,
  "started_at": 1786281000.2,
  "finished_at": 1786281045.5
}

Shell

Python

JavaScript

Java

PHP

Kind reminder: For streaming requests, the above code may not be fully applicable. Please refer to the integration documentation for changes.

Allow Use General Balance

When 'Allow General Balance' is enabled, the general balance is used automatically if an app's balance is insufficient.