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 YuJun APIs use Bearer token authentication. Get your API key from the platform dashboard at https://platform.yujuntc.fun 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.

YuJun

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 - Ace Data Cloud

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

Maximum number of tasks to return.

actionstringRequired parameter

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

offsetinteger

Number of matching tasks to skip for list retrieval.

trace_idstring

Trace identifier of one task to retrieve.

trace_idsarray

Trace identifiers of tasks to retrieve.

created_at_maxnumber

Return tasks created before this Unix timestamp.

created_at_minnumber

Return tasks created after this Unix timestamp.

Response

Operation executed successfully.

Response Body

idstring

Task identifier.

typestring

Task type.

api_idstring

API identifier.

elapsednumber

Processing duration in seconds.

requestobject

Normalized request parameters recorded for the task.

object <string, unknown>

user_idstring

Account that owns the task.

responseoneOf

Completed task result; absent while the task is still running.

oneOf 1

costobject

Per-call billing details when available.

object <string, unknown>

dataarray

Generated video entries.

Array of

idstring

Generated video identifier.

statestring

Current generation state.

video_urlstring

Download URL, available after generation succeeds.

created_atstring

Time at which video generation was created.

complete_atstring

Time at which video generation reached a terminal state.

aspect_ratiostring

Aspect ratio reported by routes that expose it.

is_extend_resultboolean

Whether the video was produced by the extend operation.

elapsednumber

Processing duration in seconds.

successboolean

Whether generation completed successfully.

task_idstring

Task identifier for later retrieval.

trace_idstring

Request trace identifier.

started_atnumber

Unix timestamp in seconds when processing started.

finished_atnumber

Unix timestamp in seconds when processing finished.

oneOf 2

errorobject

codestring

Stable error code.

messagestring

Human-readable error message.

successboolean

Whether task execution succeeded.

trace_idstring

Request trace identifier.

created_atnumber

Unix timestamp in seconds when the task was created.

started_atnumber

Unix timestamp in seconds when processing started.

finished_atnumber

Unix timestamp in seconds when processing finished.

actor_user_idstring

Account that executed an authorized request.

credential_idstring

Credential used to start the task.

application_idstring

Application used for billing.

authorization_idstring

Authorization used to start 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.