> ## Documentation Index > Fetch the complete documentation index at: https://docs.gravitex.ai/llms.txt > Use this file to discover all available pages before exploring further. # Seedance Overview > Seedance video generation: the two API surfaces and the models they support ## Introduction Seedance is ByteDance Seed's multimodal video generation family. It supports text-to-video, image-to-video (first / first-and-last frame), multimodal reference generation, and face-consistent generation backed by an asset library. Unified access through the GravitexAI gateway: * **Base URL**: `https://api.gravitex.ai` * **Authentication**: `Authorization: Bearer sk-xxxxxxxxxx` * **Content-Type**: `application/json` ## Two API surfaces Seedance is exposed through two parallel API surfaces on this platform. They offer the same capabilities and differ only in protocol style: | | Platform API | Official mirror API | | ------------------ | ---------------------------------------------------------------- | ----------------------------------------------------------------------- | | Path style | `/v1/...` (OpenAI style) | `/api/v3/...` (BytePlus Ark native) | | Request / response | Platform-normalized, more compact fields | **Identical** to the BytePlus Ark official API | | Best for | New integrations that prefer a compact REST style | Existing official SDK code — change only `base_url` and `Authorization` | | Asset library | `/v1/asset-groups`, `/v1/assets` | Action style: `Action=CreateAssetGroup`, etc. | | Entry point | [Platform API overview](/en/api-reference/endpoint/seedance-2.0) | [Official mirror overview](/en/api-reference/endpoint/seedance-2.0-new) | **Asset library data is shared** between the two surfaces (the same asset groups and assets can be referenced from either), but **video task routing is independent**: query a task on the same surface where you created it. ## Models covered by these docs | Model ID | Description | Platform API | Official mirror | Resolution | | ------------------- | -------------------------------------------------------------------------- | :----------: | :-------------: | ---------------------------------- | | `seedance-2-0` | Standard; production quality | ✅ | ✅ | `480p`, `720p`, `1080p`, `4K` | | `seedance-2-5` | Next-generation multimodal model; video generation, editing, and extension | ✅ | ✅ | Same as `seedance-2-0` | | `seedance-2-0-mini` | Cost-effective tier; about half the generation cost of `seedance-2-0` | ✅ | ✅ | `480p`, `720p` (no `1080p` / `4K`) | | `seedance-2-0-fast` | Fast iteration | ✅ | ✅ | `480p`, `720p` (no `1080p` / `4K`) | Models iterate quickly — the console model gallery is the source of truth for the current list, pricing, and capability comparison. ## Supported endpoints ### Platform API **Video generation** | Method | Path | Description | | ------ | --------------------------------------------------- | ------------------------------------------------------------------------------------------ | | `POST` | `/v1/video/generations` | [Create video generation](/en/api-reference/endpoint/seedance-2.0/create-video-generation) | | `GET` | `/v1/video/generations/{task_id}` | [Get video generation](/en/api-reference/endpoint/seedance-2.0/get-video-generation) | | `GET` | `/v1/video/generations/moderation-result/{task_id}` | [Get moderation result](/en/api-reference/endpoint/seedance-2.0/get-moderation-result) | **Asset library** | Method | Path | Description | | -------- | ----------------------------- | ---------------------------------------------------------------------------------------------------------- | | `POST` | `/v1/asset-groups` | [Create asset group](/en/api-reference/endpoint/seedance-2.0/create-asset-group) | | `GET` | `/v1/asset-groups` | [List asset groups](/en/api-reference/endpoint/seedance-2.0/list-asset-groups) | | `DELETE` | `/v1/asset-groups/{group_id}` | [Delete asset group](/en/api-reference/endpoint/seedance-2.0/delete-asset-group) | | `POST` | `/v1/assets` | [Create asset](/en/api-reference/endpoint/seedance-2.0/create-asset) | | `GET` | `/v1/assets` | [List assets](/en/api-reference/endpoint/seedance-2.0/list-assets) | | `GET` | `/v1/assets/{virtual_id}` | [Get asset](/en/api-reference/endpoint/seedance-2.0/get-asset) | | `DELETE` | `/v1/assets/{virtual_id}` | [Delete asset](/en/api-reference/endpoint/seedance-2.0/delete-asset) | | `POST` | `/v1/visual-validate/session` | [Create asset group (real person)](/en/api-reference/endpoint/seedance-2.0/create-visual-validate-session) | ### Official mirror API **Video generation** | Method | Path | Description | | -------- | ----------------------------------------- | ------------------------------------------------------------------------------------------------------- | | `POST` | `/api/v3/contents/generations/tasks` | [Create video generation](/en/api-reference/endpoint/seedance-2.0-new/create-video-generation) | | `GET` | `/api/v3/contents/generations/tasks/{id}` | [Get video generation](/en/api-reference/endpoint/seedance-2.0-new/get-video-generation) | | `DELETE` | `/api/v3/contents/generations/tasks/{id}` | [Cancel / delete video generation](/en/api-reference/endpoint/seedance-2.0-new/delete-video-generation) | **Asset library** (all via `/api/v3/seedance?Action=...&Version=2024-01-01`) | Action | Description | | ----------------------------- | ---------------------------------------------------------------------------------------------------------------------- | | `CreateAssetGroup` | [Create asset group](/en/api-reference/endpoint/seedance-2.0-new/create-asset-group) | | `ListAssetGroups` | [List asset groups](/en/api-reference/endpoint/seedance-2.0-new/list-asset-groups) | | `GetAssetGroup` | [Get asset group](/en/api-reference/endpoint/seedance-2.0-new/get-asset-group) | | `UpdateAssetGroup` | [Update asset group](/en/api-reference/endpoint/seedance-2.0-new/update-asset-group) | | `DeleteAssetGroup` | [Delete asset group](/en/api-reference/endpoint/seedance-2.0-new/delete-asset-group) | | `CreateAsset` | [Create asset](/en/api-reference/endpoint/seedance-2.0-new/create-asset) | | `ListAssets` | [List assets](/en/api-reference/endpoint/seedance-2.0-new/list-assets) | | `GetAsset` | [Get asset](/en/api-reference/endpoint/seedance-2.0-new/get-asset) | | `UpdateAsset` | [Update asset](/en/api-reference/endpoint/seedance-2.0-new/update-asset) | | `DeleteAsset` | [Delete asset](/en/api-reference/endpoint/seedance-2.0-new/delete-asset) | | `CreateVisualValidateSession` | [Create asset group (real person)](/en/api-reference/endpoint/seedance-2.0-new/create-visual-validate-session) | | `GetVisualValidateResult` | [Get validation result and create asset group](/en/api-reference/endpoint/seedance-2.0-new/get-visual-validate-result) | ## Asset library types | Library | Platform `group_type` | Mirror `GroupType` | How to create | | ----------- | --------------------- | ------------------ | --------------------------------------- | | Virtual | `aigc` | `AIGC` | Create the asset group directly | | Real person | `liveness_face` | `LivenessFace` | Requires H5 liveness verification first | ## Typical flow 1. (Optional) Create an asset group → create assets → poll until `status: active` (usually 1–3 minutes) 2. Create a video generation task, referencing assets with `asset://` 3. Poll the task about every 5 seconds until `completed` (usually 30–120 seconds) 4. If it `failed` on moderation, call [Get moderation result](/en/api-reference/endpoint/seedance-2.0/get-moderation-result) on the platform API ## Reference `/v1/video/generations` and `/v1/assets`, OpenAI style Identical request / response to BytePlus Ark Latest model list and pricing Create API keys and track usage