API reference

Creators

List the AI creators (avatars) available for your streams.

GET /api/v1/creators — no auth required for stock creators.

List creators

curl https://live.twintone.ai/api/v1/creators

Response 200

{
  "creators": [
    {
      "id": "avt_9ww075quzedr",
      "name": "Mila",
      "status": "active",
      "languages": ["en"],
      "style": "Friendly, warm, relatable",
      "personality": "Enthusiastic beauty expert who makes every product feel personal",
      "vibe": "Your best friend who happens to know everything about skincare",
      "consent": true,
      "photo": "https://…"
    }
  ]
}

Using a creator

Pass the id from the response as creator_id when starting a stream:

curl -X POST https://live.twintone.ai/api/v1/streams \
  -H "Authorization: Bearer ***" \
  -H "Content-Type: application/json" \
  -d '{
    "creator_id": "avt_9ww075quzedr",
    "product_name": "Radiance Serum",
    "platform": "youtube",
    "duration_minutes": 30
  }'

An unrecognized creator_id returns 400 invalid_creator.

Creator IDs are stable avt_ + 12-char public IDs (e.g. avt_9ww075quzedr), returned as id by GET /api/v1/creators. Human-readable slugs like mila are no longer accepted and return 400 invalid_creator.

← Previous

iGaming guide

Streams

Was this page helpful?