> ## Documentation Index
> Fetch the complete documentation index at: https://aisa.one/docs/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> - Base URLs: models `https://api.aisa.one/v1` (Gemini GenerateContent: `https://api.aisa.one/v1beta`); data APIs `https://api.aisa.one/apis/v1`. The `servers` of each operation in https://aisa.one/openapi.yaml is authoritative.
> - Auth: `Authorization: Bearer $AISA_API_KEY`. Never print, log, or commit the key.
> - MCP (preferred for agents): `https://mcp.aisa.one/mcp`, signed in with OAuth, so there is no key to paste.
> - Agent Skill: `npx skills add AIsa-team/agent-skills --skill aisa`. Fallback with the AIsa CLI: `aisa skills install aisa`.
> - Spending: docs, https://aisa.one/models, https://aisa.one/api, `/v1/models`, and MCP `search`, `list_categories`, `get_details`, `batch_quote`, and the `account` operation are free. Quote the exact calls before running them (MCP `batch_quote`, CLI `aisa quote --json`). If the quote reports `auto_execute_eligible: true`, run it unless the user set a tighter limit or asked only for a quote. Otherwise, tell the user in one message the planned calls, the quoted price, and a total USD budget for the task, then wait for approval. Direct HTTP calls follow the stricter rule at https://aisa.one/docs/get-started/cli.md#direct-http-fallback. Do not make paid calls to test availability. Full rule: https://aisa.one/llms.txt

# Seedance API - Access Dreamina Seedance Video Models via AIsa

> AIsa guide to ByteDance Dreamina Seedance video model IDs, with an API compatible with the official BytePlus ModelArk (Ark) video generation API.

AIsa routes ByteDance Dreamina Seedance video models through BytePlus, ByteDance's official international enterprise platform.

AIsa is compatible with the official BytePlus ModelArk (Ark) video generation API: the official Ark SDK and existing Ark code work after changing only the base URL and API key. Seedance is also available through the AIsa video API, `POST /v1/video/generations`.

## Supported Seedance models

| Model ID | Type | Endpoints | Best for |
| - | - | - | - |
| `dreamina-seedance-2-0-260128` | Video | `/v1/video/generations` | Dreamina Seedance video generation |
| `dreamina-seedance-2-0-fast-260128` | Video | `/v1/video/generations` | Faster, lower-cost Seedance video route |
| `dreamina-seedance-2-5` | Video | `/v1/video/generations` | Newer Dreamina Seedance video route |

Current prices for these models are on [aisa.one/models](https://aisa.one/models).

## Official Ark API compatibility

| | Official ModelArk | AIsa |
| - | - | - |
| Base URL | `https://ark.ap-southeast.bytepluses.com/api/v3` | `https://api.aisa.one/v1/ark/api/v3` |
| API key | ModelArk API key | AIsa API key |

Paths, request bodies and responses are the official ones; see the [ModelArk Video Generation API](https://docs.byteplus.com/en/docs/ModelArk/Video_Generation_API). Use the BytePlus model IDs in the table above.

```python theme={null}
import os

from byteplussdkarkruntime import Ark

client = Ark(base_url="https://api.aisa.one/v1/ark/api/v3", api_key=os.environ["AISA_API_KEY"])

task = client.content_generation.tasks.create(
    model="dreamina-seedance-2-0-fast-260128",
    content=[{"type": "text", "text": "A paper boat drifting across a calm lake at sunrise"}],
)
result = client.content_generation.tasks.get(task_id=task.id)
print(result.status)
```

Not supported: `callback_url` (poll the task instead), and listing or deleting tasks.

## Data privacy

Seedance requests are routed through BytePlus enterprise infrastructure. For compliance and data residency requirements, [contact us](mailto:developer@aisa.one).

## Next

* [Seedream models](https://aisa.one/docs/models/bytedance.md)
* [Model Catalog](https://aisa.one/docs/guides/models.md)
* [AI model pricing](https://aisa.one/docs/guides/pricing.md#models)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.