Colossyan API
  • Welcome
  • Getting Started
    • Quickstart
    • Extracting request bodies from the web-editor
  • Basics
    • Authentication
    • Endpoints
    • Video Generation
      • Generating using a template
      • Generating a video manually
      • Receiving a generated video
    • Using template variables
      • Script template variables
      • Text template variables
    • Generated videos
      • Retrieve a video
      • Delete a video
    • Video generation job
      • Retrieve video generation job
      • Delete video generation job
    • Assets
      • Actors
      • Voices
  • Advanced
    • Advanced use-cases
    • Timing
  • Experimental
    • Knowledge to draft
Powered by GitBook
On this page

Was this helpful?

Export as PDF
  1. Basics
  2. Assets

Actors

PreviousAssetsNextVoices

Last updated 2 months ago

Was this helpful?

Actors

Retrieve a list of actors

get

Fetches a list of actors that the user has access to.

Authorizations
Responses
200
A list of actors
application/json
401
Unauthorized. Authentication required.
500
Internal server error.
get
GET /api/v1/assets/actors HTTP/1.1
Host: app.colossyan.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
[
  {
    "name": "text",
    "display_name": "text",
    "preview_url": "text",
    "version": "v1",
    "gender": "Male",
    "age": 1,
    "ethnicity": "Caucasian",
    "clothing_style": "Casual",
    "quality": "lite",
    "emotions": [
      "text"
    ],
    "default_voice": "text",
    "views": [
      {
        "viewVariantType": "front",
        "aspectRatio": {
          "height": 1,
          "width": 1,
          "ratio": 1
        },
        "supportedActorTrackVariants": [
          "full_body"
        ],
        "pictarSourceUrl": "text",
        "images": {
          "thumbnail": "text",
          "editor": "text",
          "editor-happy": "text",
          "editor-sad": "text"
        },
        "videos": {
          "base": "text",
          "baseTransparent": "text",
          "dynamicPreviewUrl": "text"
        },
        "bubbleVariantDefaults": {
          "crop": {
            "left": 1,
            "top": 1,
            "right": 1,
            "bottom": 1
          }
        },
        "shoulderVariantDefaults": {
          "crop": {
            "left": 1,
            "top": 1,
            "right": 1,
            "bottom": 1
          }
        }
      }
    ],
    "features": {
      "side_view": true,
      "emotions": true,
      "hand_gesture": true
    }
  }
]
  • Actors
  • GETRetrieve a list of actors