Skip to main content

​
Introduction

The Seedance official mirror API has identical request and response bodies to the BytePlus Ark Seedance official API—only the Base URL and authentication differ. Existing official SDK code needs only a change to base_url and Authorization. Base URL: https://api.gravitex.ai
This is a separate API from the platform simplified endpoints (/v1/video/generations, /v1/assets, etc.): asset library data is shared, but video task routing is independent.

​
Authentication

All endpoints: Authorization: Bearer sk-{your_token_key}, Content-Type: application/json.

​
Asset library types

Recommended flow: create asset group → CreateAsset → poll until Status: Active → Create video generation task → Get video generation task.

​
Endpoint directory

​
Video generation tasks

Create video generation task

POST /api/v3/contents/generations/tasks

Get video generation task

GET /api/v3/contents/generations/tasks/

Cancel / delete video generation task

DELETE /api/v3/contents/generations/tasks/

​
Asset library (unified envelope Action)

All asset library operations use the same endpoint, distinguished by the Action query parameter:
Responses use the { ResponseMetadata, Result } envelope (except the two liveness validation Actions, which return a flat structure).

CreateAssetGroup

Create asset group (forced AIGC)

CreateAsset

Create asset

ListAssetGroups

List asset groups

ListAssets

List assets

GetAsset

Get asset

GetAssetGroup

Get asset group

UpdateAsset

Update asset (Name)

UpdateAssetGroup

Update asset group (Name/Description)

DeleteAsset

Delete asset

DeleteAssetGroup

Delete asset group (cascade)

​
Live person asset library (LivenessFace)

CreateVisualValidateSession

Start liveness validation session

GetVisualValidateResult

Get validation result and create asset group
  1. (Optional) CreateAssetGroup → CreateAsset → poll until Status: Active
  2. POST /api/v3/contents/generations/tasks to submit a task
  3. GET /api/v3/contents/generations/tasks/{id} poll until succeeded
  4. Optionally DELETE to cancel queued tasks or clean up completed records

​
Error handling

Asset library errors use the envelope ResponseMetadata.Error.{Code,Message}: Video generation task API errors return the corresponding upstream status code and error body.