Skip to main content
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": {}
}
  • Query character creation task status
  • Get created character details
  • Get character ID for subsequent video generation

​
Authorizations

​
Authorization
string
required
All endpoints require Bearer Token authenticationGet your API Key from the API Key Management Page

​
Path Parameters

​
task_id
string
required
Character creation task IDGet from the id field returned by create character endpoint

​
Response

​
id
string
Unique task identifier
​
object
string
Object type, always generation.task
​
model
string
Model name used
​
status
string
Task status
  • queued - Queued for processing
  • in_progress - Processing
  • completed - Successfully completed
  • failed - Failed
​
progress
integer
Task progress percentage (0-100)
​
created_at
integer
Task creation timestamp (Unix timestamp)
​
completed_at
integer
Task completion timestamp (only present when completed)
​
result
object
Task result (only returned when status is completed)
​
metadata
object
Task metadata
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": {}
}

​
Using Character in Video Generation

After creating a character, you can use it in video generation: 
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"
  }'
Use @character or @username in prompt to reference the created character.