Documentation /API v1

API Reference v1

Complete REST API documentation for Influencer Studio. Generate images, videos, and manage your account programmatically.

Quick Links

Interactive Swagger UI Authentication

Authentication

All API requests require authentication using a Bearer token. Include your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

You can generate API keys from your account settings.

Base URL

https://api.influencerstudio.com/api/v1

Images

POST/api/v1/images/generate

Generate images

Generate images from a text prompt with optional influencer and settings

Request Body

Image generation parameters

Content-Type: application/json

Responses

200Generation queued successfully
400Invalid request
401Unauthorized
404Influencer or workspace not found
Requires authentication
curl -X POST "https://api.influencerstudio.com/api/v1/images/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "prompt": "A professional headshot of a person in business attire, studio lighting",
  "model": "flux-krea",
  "settings": {
    "aspect_ratio": "1:1",
    "batch": 1
  }
}'
POST/api/v1/images/edit

Edit image

Edit an existing image using AI inpainting with a text prompt

Request Body

Image editing parameters

Content-Type: application/json

Responses

200Image edit queued successfully
400Invalid request
401Unauthorized
403Workspace does not belong to team
Requires authentication
curl -X POST "https://api.influencerstudio.com/api/v1/images/edit" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "image_url": "https://example.com/image.jpg",
  "prompt": "change the background to a beach"
}'
POST/api/v1/images/face-swap

Swap faces in images

Swap faces between a source image and target image

Request Body

Face swap parameters

Content-Type: application/json

Responses

200Face swap queued successfully
400Invalid request
401Unauthorized
404Workspace not found
Requires authentication
curl -X POST "https://api.influencerstudio.com/api/v1/images/face-swap" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "source_image": "https://example.com/face.jpg",
  "target_image": "https://example.com/body.jpg"
}'

Videos

POST/api/v1/videos/generate

Generate video

Generate a video from a text prompt with optional first frame image

Request Body

Video generation parameters

Content-Type: application/json

Responses

200Video generation queued successfully
400Invalid request or model not found
401Unauthorized
403Workspace does not belong to team
Requires authentication
curl -X POST "https://api.influencerstudio.com/api/v1/videos/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "prompt": "A person walking through a city, cinematic",
  "model": "kling-v2",
  "settings": {
    "aspect_ratio": "16:9",
    "duration": 5
  }
}'
POST/api/v1/videos/lipsync

Create lip sync video

Generate a lip-synced video by synchronizing video with audio

Request Body

Lip sync generation parameters

Content-Type: application/json

Responses

200Lip sync generation queued successfully
400Invalid request or model not found
401Unauthorized
404Workspace or generation not found
Requires authentication
curl -X POST "https://api.influencerstudio.com/api/v1/videos/lipsync" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "video_url": "https://example.com/video.mp4",
  "audio_url": "https://example.com/audio.mp3"
}'

Generations

GET/api/v1/generations/{id}/status

Get generation status

Poll the status of a generation and get result URLs when complete

Responses

200Generation status
401Unauthorized
403Workspace does not belong to team
404Generation not found
Requires authentication
curl -X GET "https://api.influencerstudio.com/api/v1/generations/{id}/status" \
  -H "Authorization: Bearer YOUR_API_KEY"

Billing

GET/api/v1/billing/plans

Get available credit plans

Returns all available one-time credit purchase plans

Responses

200List of available plans
401Unauthorized
Requires authentication
curl -X GET "https://api.influencerstudio.com/api/v1/billing/plans" \
  -H "Authorization: Bearer YOUR_API_KEY"
GET/api/v1/billing/credits

Get current credit balance

Returns the total credit balance for the authenticated team

Responses

200Total credits
401Unauthorized
Requires authentication
curl -X GET "https://api.influencerstudio.com/api/v1/billing/credits" \
  -H "Authorization: Bearer YOUR_API_KEY"
POST/api/v1/billing/top-up

Purchase credits

Create a Stripe checkout session to purchase credits (one-time purchases only)

Request Body

Credit purchase details

Content-Type: application/json

Responses

200Checkout URL created
400Invalid request
401Unauthorized
404Plan not found
Requires authentication
curl -X POST "https://api.influencerstudio.com/api/v1/billing/top-up" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "plan_id": "497267"
}'
POST/api/v1/billing/verification

Verify payment method

Create a Stripe checkout session to verify payment method and receive 500 free credits

Responses

200Verification checkout URL
401Unauthorized
Requires authentication
curl -X POST "https://api.influencerstudio.com/api/v1/billing/verification" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'