# Ark Global 接入
> 适用于要把 Ark 接入自己中转站的下游
> 按顺序完成五步：渠道、插件、价格、客户文档、资产库
## 第一步：创建渠道
先到 [ark 站](https://ark.oairoute.com/) 注册账号并创建 Key。ark 站的账号、Key 和余额与 api 站分开，两边不通用。
然后在你的中转后台创建渠道：
| 字段 | 填写 |
|---|---|
| 渠道类型 | 网关 → New API |
| 地址 | `https://ark.oairoute.com` |
| 密钥 | 在 ark 站创建的 Key |
> **Note:** 
> 地址只填域名，不要加 `/v1` 或其他后缀。

![配置渠道：在上游任务插件里选 Doubao](https://oairoute.com/assets/img/ark-channel-newapi-doubao-plugin.png)
## 第二步：添加插件源
插件提供按秒计费，并兼容资产库接口。
在中转后台依次打开「任务插件 → 插件市场 → 管理源 → 添加源」，填入：
```text
https://oairoute.com/plugins/index.json
```
若你的客户不方便配置插件源，也可以直接下载插件文件发给他。

- [下载最新版插件](https://oairoute.com/plugins/tasks/doubao/1.7.3/plugin.js)

对方在中转后台打开「任务插件 → Doubao → 上传新版本」，选中这个文件即可。
## 第三步：复制价格
价格表覆盖三条计费链路（Seedance 按量、Seedance 按秒、Seedream 按次）。在文档站上点开可直接预览成表格，弹窗里可复制全文，也可用「新窗口打开」看原始 md。
美元表按国际价格设置，照抄美元数字即可。给国内客户用的，直接用下面的人民币表，它按官方国内牌价逐档给出，与美元价不是固定汇率关系（各档约 6.50 ~ 6.67），不要自己换算。
- 中文：[查看中文价格表](https://oairoute.com/configs/doubao/billing-usd.zh-CN.md)
- 英文：[查看英文价格表](https://oairoute.com/configs/doubao/billing-usd.md)
- 人民币：[查看人民币价格表（国内客户用）](https://oairoute.com/configs/doubao/billing-cny.zh-CN.md)
## 第四步：把文档发给你的客户
下面两份是不带广告的空白文档，可以直接分发给你的客户。
- 中文：[https://ark-cn.apifox.cn](https://ark-cn.apifox.cn)
- 英文：[https://ark-docs.apifox.cn](https://ark-docs.apifox.cn)
## 第五步：开通资产库
资产库把图片、音频、视频先入库，生成时用素材 ID 引用，上游不必每次回源拉你的地址。不接这个功能可以跳过本步。
下游要做两件事，都在后台完成：
| 位置 | 填写 |
|---|---|
| 渠道的模型列表 | 追加 `doubao-asset` |
| 模型价格 | `doubao-asset` 填 `0` |
> **Note:**
> `doubao-asset` 是内部伪模型，不产生上游调用也不计费。没有它，素材请求会被判为找不到渠道；没有价格，会被判为未配置价格。
做完之后，你的客户直接用自己的站点令牌调素材接口，路径和方舟原生一致：
```bash
curl 'https://你的站点/doubao/api/?Action=CreateAsset&Version=2024-01-01' \
  -H 'Authorization: Bearer YOUR_SITE_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"GroupId":"group-20241101","URL":"https://example.com/cat.png","AssetType":"Image","Name":"cat"}'
```
`Action` 可选 `CreateAsset`、`GetAsset`、`ListAssets`、`UpdateAsset`、`DeleteAsset`、`CreateAssetGroup`、`GetAssetGroup`、`ListAssetGroups`、`UpdateAssetGroup`、`DeleteAssetGroup`，匹配时忽略大小写。`Version` 省略时按 `2024-01-01` 处理。
字段与响应的完整说明见 [素材库](https://docs.oairoute.com/api/video/assets.html)。
> **Note:**
> 入库是异步的：提交后素材处于 `Processing`，要等 `Status` 变成 `Active` 才能用于生成。每次素材调用会在你的日志里留一条模型名为 `doubao-asset`、额度为 0 的记录。