> ## 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 - 通过 AIsa 访问即梦 Seedance 视频模型

> 字节跳动即梦 Seedance 视频模型 ID 指南；接口兼容 BytePlus ModelArk（Ark）官方视频生成 API。

AIsa 通过字节跳动官方的国际企业平台 BytePlus 路由即梦 Seedance 视频模型。

AIsa 兼容 BytePlus ModelArk（Ark）官方视频生成 API：官方 Ark SDK 和已有的 Ark 代码只需改 base URL 和 API Key 即可使用。Seedance 也可以通过 AIsa 视频接口 `POST /v1/video/generations` 调用。

## 支持的 Seedance 模型

| 模型 ID | 类型 | 端点 | 适合 |
| - | - | - | - |
| `dreamina-seedance-2-0-260128` | 视频 | `/v1/video/generations` | 即梦 Seedance 视频生成 |
| `dreamina-seedance-2-0-fast-260128` | 视频 | `/v1/video/generations` | 更快、成本更低的 Seedance 视频路由 |
| `dreamina-seedance-2-5` | 视频 | `/v1/video/generations` | 较新的即梦 Seedance 视频路由 |

这些模型的当前价格见 [aisa.one/models](https://aisa.one/models)。

## 兼容官方 Ark API

| | 官方 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 |

路径、请求体和返回体都与官方一致，见 [ModelArk 视频生成 API](https://docs.byteplus.com/zh-CN/docs/ModelArk/Video_Generation_API)。请使用上表中的 BytePlus 模型 ID。

```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": "日出时分，一只纸船漂过平静的湖面"}],
)
result = client.content_generation.tasks.get(task_id=task.id)
print(result.status)
```

暂不支持：`callback_url`（请改为轮询任务），以及任务列表和删除任务。

## 数据隐私

Seedance 请求会通过 BytePlus 企业基础设施路由。如需合规和数据驻留要求，请[联系我们](mailto:developer@aisa.one)。

## 下一步

* [Seedream 模型](https://aisa.one/docs/zh/models/bytedance.md)
* [模型目录](https://aisa.one/docs/zh/guides/models.md)
* [AI 模型价格](https://aisa.one/docs/zh/guides/pricing.md#模型)


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