> ## Documentation Index
> Fetch the complete documentation index at: https://docs.crun.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Bytedance DreamActor API
> Bytedance DreamActor 动作模仿模型。通过将参考视频中的动作迁移到参考图片上来生成视频。
## 查询任务状态
提交任务后，请使用统一查询接口查看进度并获取结果：
了解如何查询任务状态并获取生成结果
生产环境中，建议使用 `callback_url` 参数接收任务完成后的自动通知，而不是轮询状态接口。
## 相关资源
查看所有可用模型
查询账户剩余积分
## OpenAPI
````yaml zh/models/bytedance/dreamactor.json post /api/v1/client/job/CreateTask
openapi: 3.0.0
info:
title: Bytedance DreamActor 接口
description: crun.ai Bytedance DreamActor 接口文档
version: 1.0.0
contact:
name: Technical Support
email: support@crun.ai
servers:
- url: https://api.crun.ai
description: API 服务器
security:
- ApiKeyAuth: []
paths:
/api/v1/client/job/CreateTask:
post:
summary: Bytedance DreamActor 动作模仿生成
operationId: bytedance-dreamactor
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- model
- input
properties:
model:
type: string
enum:
- bytedance/dreamactor
description: |-
本接口使用的模型名称，为必填项。
- 当前接口仅支持传入 `bytedance/dreamactor`
callback_url:
type: string
format: uri
description: |-
可选。任务完成后的回调地址。
- 生成完成后，系统会向该地址发送 POST 请求，回传任务状态和结果
- 回调载荷结构与任务状态查询接口返回的 `data` 对象保持一致
- 你的回调接口应支持接收 JSON 格式的 POST 请求
- 成功接收后应返回 HTTP 200 状态码
example: https://your-domain.com/api/callback
input:
type: object
description: Bytedance DreamActor 动作模仿任务的输入参数。
required:
- img_urls
- video_urls
properties:
img_urls:
type: array
description: 单张人物肖像图片 URL，作为外观来源。
items:
type: string
format: uri
minItems: 1
maxItems: 1
example:
- https://example.com/reference-image.jpg
video_urls:
type: array
description: 单个参考视频 URL，作为动作来源。
items:
type: string
format: uri
minItems: 1
maxItems: 1
example:
- https://example.com/reference-motion.mp4
example:
model: bytedance/dreamactor
callback_url: https://your-domain.com/api/callback
input:
img_urls:
- https://example.com/reference-image.jpg
video_urls:
- https://example.com/reference-motion.mp4
responses:
'200':
description: 请求成功
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/ApiResponse'
- type: object
properties:
data:
type: object
properties:
task_id:
type: string
description: 任务 ID，可用于通过任务详情接口查询任务状态
example: task_12345678
example:
code: 200
message: success
data:
task_id: task_12345678
'422':
description: 参数校验错误
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/ApiResponse'
- type: object
properties:
errors:
type: array
description: 详细的参数校验错误信息
items:
type: string
example:
- >-
Value error, Invalid input for model
bytedance/dreamactor: img_urls must contain exactly
1 item
example:
code: 422
message: Missing Params or Type Error
errors:
- >-
Value error, Invalid input for model bytedance/dreamactor:
img_urls must contain exactly 1 item
'500':
$ref: '#/components/responses/Error'
components:
schemas:
ApiResponse:
type: object
properties:
code:
type: integer
enum:
- 200
- 401
- 402
- 404
- 422
- 429
- 455
- 500
- 501
- 505
description: |-
响应状态码
- **200**：成功，请求已成功处理
- **401**：未授权，缺少认证信息或认证无效
- **402**：额度不足，账户额度不足以完成本次操作
- **404**：资源不存在，请求的资源或接口不存在
- **422**：参数校验错误，请求参数未通过校验
- **429**：请求过于频繁，已超出当前资源的调用限制
- **455**：服务不可用，系统当前正在维护中
- **500**：服务器错误，处理请求时发生了意外错误
- **501**：生成失败，内容生成任务执行失败
- **505**：功能已禁用，请求的功能当前不可用
message:
type: string
description: 响应消息；失败时为错误说明
example: success
responses:
Error:
description: 服务器错误
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: x-api-key
description: |-
所有接口均需通过 API Key 进行认证。
获取 API Key：
1. 访问 [API Key 管理页面](https://crun.ai/zh/user-api-key) 获取你的 API Key
使用方式：
在请求头中添加：
x-api-key: YOUR_API_KEY
注意事项：
- 请妥善保管你的 API Key，不要泄露给他人
- 如果怀疑 API Key 已泄露，请立即在管理页面中重置
````