API 接入文档 · 一秒算力聚合

快速开始

Base URL

https://ai.yimiaocn.com/v1

获取 API Key

登录平台后，进入「API 密钥」页面，点击「创建令牌」即可生成 API Key（以 sk- 开头）。

一句话接入

from openai import OpenAI
client = OpenAI(base_url="https://ai.yimiaocn.com/v1", api_key="sk-你的密钥")
resp = client.chat.completions.create(model="doubao-seed-2-1-pro-260915",
    messages=[{"role":"user","content":"你好"}])
print(resp.choices[0].message.content)

与 OpenAI SDK 完全兼容，把 base_url 和 api_key 换成平台的即可，业务代码零改动。

认证方式

所有请求通过 HTTP Header 携带 API Key 认证：

Authorization: Bearer sk-你的密钥

Header	说明
`Authorization`	必填，格式 `Bearer <token>`
`Content-Type`	必填，固定 `application/json`

密钥请妥善保管，泄露请立即在控制台吊销并重新生成。

对话补全 Chat

用于所有文本类模型（豆包 Seed、DeepSeek、GLM、通义千问、Kimi 等）。

POST /v1/chat/completions

请求参数

参数	类型	说明
`model`	string	必填，模型 ID
`messages`	array	必填，消息列表，每项含 `role` 与 `content`
`temperature`	number	采样温度 0~2，默认 1
`max_tokens`	number	最大生成 token 数
`stream`	boolean	是否流式输出，默认 false

切换到上方任一「对话类」模型，即可在示例台看到它的完整调用代码。

向量化 Embedding

用于豆包 Embedding 系列模型，将文本 / 图片转为向量，用于检索、相似度、知识库等场景。

POST /v1/embeddings

请求参数

参数	类型	说明
`model`	string	必填，Embedding 模型 ID
`input`	string\|array	必填，文本或文本数组

图片生成 Image

使用 Seedream 系列模型进行文生图 / 图生图。

POST /v1/images/generations

请求参数

参数	类型	说明
`model`	string	必填，Seedream 模型 ID
`prompt`	string	必填，画面描述
`size`	string	输出尺寸，如 1024x1024
`n`	number	生成数量，默认 1

图片生成按次计费。

视频生成 Video

使用 Seedance 系列模型进行文生视频 / 图生视频，异步任务制。

POST /v1/videos/generations

请求参数

参数	类型	说明
`model`	string	必填，Seedance 模型 ID
`prompt`	string	视频描述
`image`	string	可选，图生视频的首帧图（URL 或 base64）

视频生成走平台「任务插件」，提交后返回任务 ID，轮询查询结果。

素材管理 Asset

火山引擎私域人像素材资产管理：创建素材组、上传素材、真人活体认证。上传后的素材可在视频生成时用 asset:// 引用。

BASE https://ai.yimiaocn.com/api/volc/asset

素材按用户自动隔离：每个 token 只能管理自己的素材组和素材，客户之间互不可见、无法操作对方资产。无需传 project_name，系统自动处理。

素材组 Asset Group

方法	路径	说明
`POST`	`/groups`	创建素材组
`GET`	`/groups`	查询我的素材组（可用 `?group_type=AIGC\|LivenessFace` 过滤）
`GET`	`/groups/:id`	查询组详情
`PUT`	`/groups/:id`	更新组（名称/描述）
`DELETE`	`/groups/:id`	删除组

创建素材组

参数	类型	说明
`name`	string	必填，组名
`group_type`	string	可选，`AIGC`=虚拟人像（默认），`LivenessFace`=真人人像
`description`	string	可选，描述

curl -X POST https://ai.yimiaocn.com/api/volc/asset/groups \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{"name":"我的虚拟主播","group_type":"AIGC"}'

返回的 data.Id 即 GroupId，上传素材时填入 group_id。

素材 Asset

方法	路径	说明
`POST`	`/assets`	上传素材
`GET`	`/assets`	查询素材列表（需 `?group_id=`）
`GET`	`/assets/:id`	查询素材详情（含处理状态）
`PUT`	`/assets/:id`	更新素材（改名）
`DELETE`	`/assets/:id`	删除素材

上传素材

参数	类型	说明
`group_id`	string	必填，所属素材组 ID
`url`	string	必填，素材文件公网可下载 URL
`asset_type`	string	必填，`Image` / `Video` / `Audio`
`name`	string	可选，素材名

curl -X POST https://ai.yimiaocn.com/api/volc/asset/assets \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{"group_id":"group-xxx","url":"https://example.com/avatar.png","asset_type":"Image","name":"主播形象图"}'

上传是异步的，返回素材 ID 后用 GET /assets/:id 轮询，Status 变为 Active 即处理完成。

真人认证 Real

真人人像（LivenessFace）素材需先完成活体认证拿 GroupId，才能上传素材。

方法	路径	说明
`POST`	`/real/session`	创建活体认证会话，返回 H5 认证链接
`POST`	`/real/result`	查询认证结果，成功后返回 GroupId

# 1. 创建认证会话
curl -X POST https://ai.yimiaocn.com/api/volc/asset/real/session \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{"callback_url":"https://你的回调地址"}'

# 2. 查询认证结果（byted_token 来自第 1 步）
curl -X POST https://ai.yimiaocn.com/api/volc/asset/real/result \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{"byted_token":"认证凭证"}'

全部模型（52）

点击任意模型卡片，跳转到上方示例台查看它的对接方式。