Create influencer

curl -X POST "https://mvp.tryunsora.com/api/v1/influencer-studio/create" \
  -H "Authorization: Bearer uns_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Fitness creator in athleisure, gym mirror selfie, natural light",
    "aspectRatio": "9:16",
    "styleMode": "mirror_selfie",
    "cameraAngle": "pov"
  }'

curl -X POST "https://mvp.tryunsora.com/api/v1/influencer-studio/create" \
  -H "Authorization: Bearer uns_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Luxury travel influencer at rooftop pool, golden hour",
    "aspectRatio": "4:3",
    "count": 3,
    "styleMode": "golden_hour",
    "age": 25
  }'

Creates AI influencer image job(s). Each image in count is a separate generation row and credit charge. Poll each id via Poll generation status (type: INFLUENCER).

Headers

Header	Required	Description
`Authorization`	Yes	`Bearer uns_live_*` API key or Clerk JWT
`Content-Type`	Yes	`application/json`

Request body

string

required

Describe the influencer scene, outfit, mood, or action.

string

Output aspect ratio. Default: 1:1.Allowed: 1:1, 16:9, 9:16, 4:3, 3:4

integer

Number of images to generate (separate jobs). Min 1, max 10. Default: 1.

string

Optional framing preset.Allowed: pov, portrait, full-body, close-up, side-profile

string

Optional look / lighting preset.Allowed: ugc, casual_daylight, cozy_indoor, low_light_intimate, raw_flash, golden_hour, moody_night, car_selfie, mirror_selfie, luxury_influencer, cinematic, travel_content, beauty_closeup, party_night_out

integer

Optional subject age in years. Min 18, max 70.

Async completion

Poll each generations[].id via Poll generation status until COMPLETED or FAILED. Webhooks are not supported on the public API.

Response

Single image (count: 1):

{
  "success": true,
  "generations": [
    { "id": "cm123abc", "status": "QUEUED" }
  ],
  "creditsDeducted": 10,
  "creditsRemaining": 90
}

Multiple images (count > 1) return one entry per job in generations. Credits deducted = per-image cost × count.

Example

curl -X POST "https://mvp.tryunsora.com/api/v1/influencer-studio/create" \
  -H "Authorization: Bearer uns_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Fitness creator in athleisure, gym mirror selfie, natural light",
    "aspectRatio": "9:16",
    "styleMode": "mirror_selfie",
    "cameraAngle": "pov"
  }'

curl -X POST "https://mvp.tryunsora.com/api/v1/influencer-studio/create" \
  -H "Authorization: Bearer uns_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Luxury travel influencer at rooftop pool, golden hour",
    "aspectRatio": "4:3",
    "count": 3,
    "styleMode": "golden_hour",
    "age": 25
  }'

Errors

HTTP	When
`400`	Missing/invalid prompt, `aspectRatio`, `cameraAngle`, `styleMode`, or `age`
`401`	Invalid auth
`402`	Insufficient credits
`404`	User not found
`500`	Server error

API documentation

CLI

User

Accounts

Posts

Generation status

Video generator

Image generator

Music generator

Voiceover

AI influencer

Thumbnail generator

Clipping

Uploads

Create influencer

Headers

Request body

Async completion

Response

Example

Errors

​Headers

​Request body

​Async completion

​Response

​Example

​Errors

Headers

Request body

Async completion

Response

Example

Errors