跳转到主要内容
GET
https://dashlyai.cc
/
v1
/
characters_tasks
/
{task_id}
curl --request GET \
  --url 'https://dashlyai.cc/v1/characters_tasks/task_01KBYT59JDHB4A3KDDR9N9JVWP' \
  --header 'Authorization: Bearer <token>'

{
  "id": "task_01KBYT59JDHB4A3KDDR9N9JVWP",
  "object": "generation.task",
  "model": "sora-2",
  "status": "in_progress",
  "progress": 60,
  "created_at": 1765251461,
  "metadata": {}
}
  • 查询角色创建任务的状态
  • 获取已创建角色的详细信息
  • 用于获取角色 ID 以进行后续视频生成

​
Authorizations

​
Authorization
string
必填
所有接口均需要使用 Bearer Token 进行认证获取 API Key：访问 API Key 管理页面 获取您的 API Key

​
Path Parameters

​
task_id
string
必填
角色创建任务的 ID从创建角色接口返回的 id 字段获取

​
Response

​
id
string
任务唯一标识符
​
object
string
对象类型，固定为 generation.task
​
model
string
使用的模型名称
​
status
string
任务状态
  • queued - 排队等待处理
  • in_progress - 处理中
  • completed - 成功完成
  • failed - 失败
​
progress
integer
任务进度百分比（0-100）
​
created_at
integer
任务创建时间戳（Unix 时间戳）
​
completed_at
integer
任务完成时间戳（仅在完成时存在）
​
result
object
任务结果（仅在 completed 状态时返回）
​
metadata
object
任务元数据
curl --request GET \
  --url 'https://dashlyai.cc/v1/characters_tasks/task_01KBYT59JDHB4A3KDDR9N9JVWP' \
  --header 'Authorization: Bearer <token>'

{
  "id": "task_01KBYT59JDHB4A3KDDR9N9JVWP",
  "object": "generation.task",
  "model": "sora-2",
  "status": "in_progress",
  "progress": 60,
  "created_at": 1765251461,
  "metadata": {}
}

​
使用角色生成视频

创建角色后，可以在视频生成时使用角色： 
curl --request POST \
  --url https://dashlyai.cc/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "sora-2",
    "prompt": "@character is dancing in the rain",
    "character_url": "task_01KBYT59JDHB4A3KDDR9N9JVWP",
    "character_timestamps": "1,5",
    "size": "16:9"
  }'
在 prompt 中可以使用 @character 或 @username 来引用创建的角色。