API Reference

Sharing API

Name: twin.actor
Rating: 4.8 (2500 reviews)

Create shareable links for your generated videos. Share tokens allow public access without authentication.

Create Share Link

POST/share

Create a share token for a project

Request Body

Name	Type	Description
`project_id`required	`integer`	Project to share
`project_type`required	`string`	scene_project or avatar_project

bash

curl -X POST https://api.twin.actor/api/v1/share \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "project_id": 42,
    "project_type": "scene_project"
  }'

Response:

json

{
  "share_token": "abc123xyz",
  "share_url": "https://twin.actor/share/abc123xyz",
  "expires_at": null
}

Get Shared Content

GET/share/{token}

Get shared video (public, no auth)

This endpoint is public and returns video details for the share page.

bash

curl https://api.twin.actor/api/v1/share/abc123xyz