Overview
Build Seedance 1.5 Video integrations with A2E. Review authentication, request parameters, task creation, status, and result endpoints.
Primary Endpoint
POST
/api/v1/seedanceVideo/startStart Seedance 1.5 Pro video generation
Request Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| name | string | No | Name of the video generation task |
| mode | enum: text-to-video | image-to-video | No | Generation mode. For first-last-frames usage, send mode=image-to-video together with image_url + end_image_url; the backend will normalize it. |
| prompt | string | Yes | Text prompt describing the desired video |
| image_url | string | No | Input image URL (required for image-to-video mode; also used as the first frame in first-last-frames usage) |
| end_image_url | string | No | Last frame image URL. When provided together with image_url, mode is automatically treated as first-last-frames. |
| duration | enum: 5 | 10 | No | Video duration in seconds |
| aspect_ratio | enum: 16:9 | 9:16 | 1:1 | No | Video aspect ratio |
| resolution | enum: 480p | 720p | No | Video resolution |
| camera_fixed | boolean | No | Whether the camera is fixed |
| generate_audio | boolean | No | Whether to generate audio |
| 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/seedanceVideo/start" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"name": "My Seedance Video",
"mode": "image-to-video",
"prompt": "A girl holding a fox, the girl opens her eyes...",
"image_url": "https://example.com/input.jpg",
"end_image_url": "https://example.com/last.jpg",
"duration": "5",
"aspect_ratio": "16:9",
"resolution": "720p",
"camera_fixed": false,
"generate_audio": false,
"webhook_url": "https://your-server.example.com/a2e/webhook",
"webhook_token": "a-shared-secret"
}'Responses
200
Video generation task started successfully
400
Bad Request - Invalid parameters
401
Unauthorized - Invalid or missing bearer token