Video to Audio API Documentation

Overview

Generate semantically-aware ambient sound effects and background audio that match the visual content of a video clip.

Primary Endpoint

POST/api/v1/thinkSound/start

Start ThinkSound generation

Request Parameters

Name	Type	Required	Description
name	string	No	Name of the ThinkSound task
video_url	string	Yes	URL of the source video (must be .mp4, .avi, .mov, or .mkv)
caption	string	No	Caption for the generation
cot_description	string	No	Chain of thought description
seed	number	No	Random seed for reproducible results
webhook_url	string	No	HTTPS URL to receive task.completed / task.failed notifications. Best-effort delivery, single attempt, no retries; clients should treat the detail API as the source of truth.
webhook_token	string	No	Optional plaintext token returned in the X-A2e-Webhook-Token header so receivers can verify the request originated from a2e.

Request Example

curl -X POST "https://www.a2e.com.cn/api/v1/thinkSound/start" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "My Audio-Visual Generation",
  "video_url": "https://example.com/video.mp4",
  "caption": "Generate audio for this silent video",
  "cot_description": "Detailed description of the audio generation process",
  "seed": 12345,
  "webhook_url": "https://your-server.example.com/a2e/webhook",
  "webhook_token": "a-shared-secret"
}'

Related Endpoints

POST/api/v1/thinkSound/start

Start ThinkSound generation

DELETE/api/v1/thinkSound/{_id}

Delete ThinkSound task

GET/api/v1/thinkSound/{_id}

Get ThinkSound task details

GET/api/v1/thinkSound/allRecords

Get all ThinkSound records

POST/api/v1/thinkSound/batchDetail

Batch query task details

Responses

200

ThinkSound generation started successfully

400

Bad Request - Invalid parameters or video format

401

Unauthorized - Invalid or missing bearer token