API Reference v1

curl -X GET "https://influencerstudio.com/api/v1/influencers" \
  -H "Authorization: Bearer YOUR_API_KEY"

[
  {
    "id": "clxxxx_influencer_001",
    "name": "Sofia Martinez",
    "face_image": "https://cdn.influencerstudio.com/influencers/sofia_face.jpg",
    "best_full_image": "https://cdn.influencerstudio.com/influencers/sofia_full.jpg",
    "training_status": "completed",
    "ready_for_generation": true,
    "created_at": "2026-01-15T14:30:00.000Z"
  },
  {
    "id": "clxxxx_influencer_002",
    "name": "Marcus Chen",
    "face_image": "https://cdn.influencerstudio.com/influencers/marcus_face.jpg",
    "best_full_image": "https://cdn.influencerstudio.com/influencers/marcus_full.jpg",
    "training_status": "training",
    "ready_for_generation": false,
    "created_at": "2026-02-01T09:15:00.000Z"
  }
]

curl -X POST "https://influencerstudio.com/api/v1/influencers/create" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Sofia Martinez",
  "image_urls": [
    "https://example.com/photo1.jpg",
    "https://example.com/photo2.jpg",
    "https://example.com/photo3.jpg",
    "https://example.com/photo4.jpg",
    "https://example.com/photo5.jpg"
  ]
}'

{
  "influencer_id": "clxxxx_influencer_003",
  "name": "Sofia Martinez",
  "status": "completed",
  "ready_for_generation": true,
  "credits_used": 250
}

curl -X POST "https://influencerstudio.com/api/v1/influencers/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "influencer_id": "your-influencer-id",
  "prompt": "professional portrait photo, smiling",
  "outfit_image": "https://example.com/outfit.jpg",
  "location_image": "https://example.com/beach-background.jpg",
  "reference_pose_image": "https://example.com/pose-reference.jpg",
  "product_image": "https://example.com/iphone.jpg",
  "camera_style": "pro",
  "lora_url": "https://example.com/my-style.safetensors",
  "lora_type": "flux-2-klein",
  "batch": 2,
  "settings": {
    "aspect_ratio": "1:1"
  }
}'

{
  "generation_id": "clxxxx1234567890",
  "status": "queued",
  "images": [
    "https://cdn.influencerstudio.com/generations/influencer_001.jpg",
    "https://cdn.influencerstudio.com/generations/influencer_002.jpg"
  ],
  "estimated_time": 30,
  "credits_used": 48
}

curl -X POST "https://influencerstudio.com/api/v1/influencers/video" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "influencer_id": "your-influencer-id",
  "prompt": "Influencer walks toward camera on a beach, picks up a product, and shows it while smiling",
  "dialog": "Hey everyone! Check out this amazing new product!",
  "product_image": "https://example.com/product.jpg",
  "outfit_image": "https://example.com/summer-outfit.jpg",
  "location_image": "https://example.com/tropical-beach.jpg",
  "aspect_ratio": "9:16"
}'

{
  "generation_id": "clxxxx_video_001",
  "status": "queued",
  "first_frame_url": "https://cdn.influencerstudio.com/generations/frame_first.jpg",
  "last_frame_url": "https://cdn.influencerstudio.com/generations/frame_last.jpg",
  "video_url": null,
  "estimated_time": 180,
  "credits_used": 328,
  "has_voice_conversion": true
}

curl -X GET "https://influencerstudio.com/api/v1/music" \
  -H "Authorization: Bearer YOUR_API_KEY"

[
  {
    "id": "clxxxx_audio_001",
    "title": "Summer Vibes",
    "style": "pop, upbeat, electronic",
    "url": "https://cdn.influencerstudio.com/music/summer_vibes.mp3",
    "status": "completed",
    "generation_id": "clxxxx_gen_001",
    "created_at": "2026-02-15T10:00:00.000Z"
  }
]

curl -X POST "https://influencerstudio.com/api/v1/music/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "title": "Summer Vibes",
  "style": "pop, upbeat, electronic, feel-good",
  "lyrics": "Walking on sunshine, feeling alive\nEvery moment is a reason to thrive",
  "instrumental": false,
  "vocal_gender": "m",
  "model": "V4_5PLUS"
}'

{
  "generation_id": "clxxxx_gen_music_001",
  "status": "queued",
  "estimated_time": 30,
  "credits_used": 50
}

curl -X GET "https://influencerstudio.com/api/v1/music/{id}" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "id": "clxxxx_audio_001",
  "title": "Summer Vibes",
  "style": "pop, upbeat, electronic",
  "url": "https://cdn.influencerstudio.com/music/summer_vibes.mp3",
  "status": "completed",
  "generation_id": "clxxxx_gen_001",
  "created_at": "2026-02-15T10:00:00.000Z"
}

curl -X GET "https://influencerstudio.com/api/v1/voices" \
  -H "Authorization: Bearer YOUR_API_KEY"

[
  {
    "id": "clxxxx_voice_001",
    "name": "Sofia Voice #1",
    "description": null,
    "type": "cloned",
    "audio_url": "https://cdn.influencerstudio.com/voices/sofia_preview.mp3",
    "influencer_id": "clxxxx_influencer_001",
    "influencer_name": "Sofia Martinez",
    "created_at": "2026-02-10T14:30:00.000Z"
  },
  {
    "id": "clxxxx_voice_002",
    "name": "Narrator Voice",
    "description": null,
    "type": "designed",
    "audio_url": "https://cdn.influencerstudio.com/voices/narrator_preview.mp3",
    "influencer_id": null,
    "influencer_name": null,
    "created_at": "2026-02-12T09:00:00.000Z"
  }
]

curl -X POST "https://influencerstudio.com/api/v1/voices/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "method": "clone",
  "audio_url": "https://example.com/voice-sample.mp3",
  "name": "My Custom Voice"
}'

{
  "voice_id": "clxxxx_voice_003",
  "name": "My Custom Voice",
  "type": "cloned",
  "audio_url": "https://cdn.influencerstudio.com/voices/custom_preview.mp3",
  "influencer_id": null,
  "status": "completed",
  "credits_used": 0
}

curl -X GET "https://influencerstudio.com/api/v1/voices/{id}" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "id": "clxxxx_voice_001",
  "name": "Sofia Voice #1",
  "description": null,
  "type": "cloned",
  "audio_url": "https://cdn.influencerstudio.com/voices/sofia_preview.mp3",
  "custom_voice_id": "cartesia_xxxxx",
  "influencer_id": "clxxxx_influencer_001",
  "influencer_name": "Sofia Martinez",
  "created_at": "2026-02-10T14:30:00.000Z"
}

curl -X GET "https://influencerstudio.com/api/v1/models/images" \
  -H "Authorization: Bearer YOUR_API_KEY"

curl -X GET "https://influencerstudio.com/api/v1/models/videos" \
  -H "Authorization: Bearer YOUR_API_KEY"

curl -X POST "https://influencerstudio.com/api/v1/images/generate-face" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "prompt": "beautiful woman with green eyes, natural lighting, professional headshot",
  "batch": 4,
  "gender": "female",
  "ethnicity": "White Caucasian",
  "hair_color": "blonde hair"
}'

{
  "generation_id": "clxxxx_gen_face_001",
  "status": "queued",
  "batch": 4,
  "estimated_time": 60,
  "credits_used": 0
}

curl -X POST "https://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": "studio-1",
  "lora_url": "https://example.com/my-custom-style.safetensors",
  "batch": 2,
  "settings": {
    "aspect_ratio": "1:1"
  },
  "lora_type": "flux-2-klein"
}'

{
  "generation_id": "clxxxx1234567890",
  "status": "queued",
  "images": [
    "https://cdn.influencerstudio.com/generations/img_001.jpg",
    "https://cdn.influencerstudio.com/generations/img_002.jpg"
  ],
  "estimated_time": 30,
  "credits_used": 48
}

curl -X POST "https://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",
  "model": "SEEDREAM"
}'

{
  "generation_id": "clxxxx1234567890",
  "status": "queued",
  "image_id": "clxxxx0987654321",
  "estimated_time": 15,
  "credits_used": 18
}

curl -X POST "https://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-3",
  "settings": {
    "aspect_ratio": "16:9",
    "duration": 5,
    "provider": "fal",
    "quality": "basic"
  }
}'

{
  "generation_id": "clxxxx1234567890",
  "status": "queued",
  "videos": [
    "https://cdn.influencerstudio.com/generations/video_001.mp4"
  ],
  "estimated_time": 120,
  "credits_used": 50
}

curl -X POST "https://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",
  "model": "sync-lipsync/v3"
}'

{
  "generation_id": "clxxxx1234567890",
  "status": "queued",
  "estimated_time": 60,
  "credits_used": 25
}

curl -X POST "https://influencerstudio.com/api/v1/videos/motion-control" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "video_url": "https://example.com/reference-video.mp4",
  "character_image_url": "https://example.com/character.jpg",
  "character_orientation": "video",
  "element_binding": [
    {
      "element_index": 0,
      "source_video_url": "https://example.com/face-reference.mp4"
    }
  ]
}'

{
  "generation_id": "clxxxx_motion_001",
  "status": "queued",
  "estimated_time": 180
}

curl -X POST "https://influencerstudio.com/api/v1/videos/wan22" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "mode": "t2v",
  "prompt": "A beautiful woman walks confidently along a sunlit beach, slow motion, cinematic",
  "loras": [
    {
      "path": "https://example.com/loras/T2V_14b_HighNoise_v2.safetensors",
      "scale": 1,
      "transformer": "high"
    },
    {
      "path": "https://example.com/loras/T2V_14b_LowNoise_v2.safetensors",
      "scale": 1,
      "transformer": "low"
    }
  ],
  "settings": {
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "num_frames": 81,
    "frames_per_second": 16
  }
}'

{
  "generation_id": "clxxxx_wan22_001",
  "video_url": "https://cdn.influencerstudio.com/generations/wan22_video_001.mp4",
  "mode": "text-to-video"
}

curl -X POST "https://influencerstudio.com/api/v1/videos/reference-to-video" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "kling-3",
  "prompt": "@Element1 holds @Image1 up to the camera and smiles, then walks into the scene shown in @Image2.",
  "elements": [
    {
      "frontal_image_url": "https://example.com/character-front.jpg",
      "reference_image_urls": [
        "https://example.com/character-side.jpg",
        "https://example.com/character-back.jpg",
        "https://example.com/character-three-quarter.jpg"
      ]
    }
  ],
  "image_urls": [
    "https://example.com/product.jpg",
    "https://example.com/golden-hour-cafe.jpg"
  ],
  "start_image_url": "https://example.com/opening-frame.jpg",
  "multi_prompt": [
    {
      "prompt": "Medium close-up: @Element1 holds @Image1, smiles warmly, soft natural window light.",
      "duration": "5"
    },
    {
      "prompt": "Wide shot: @Element1 turns and walks into @Image2, cinematic, golden hour.",
      "duration": "5"
    }
  ],
  "duration": "5",
  "aspect_ratio": "16:9",
  "script": "You're going to love this — it completely changed my morning routine.",
  "voice_id": "your-voice-id",
  "resolution": "720p"
}'

{
  "generation_id": "clxxxx_ref_video_001",
  "status": "queued",
  "estimated_time": 180
}

curl -X POST "https://influencerstudio.com/api/v1/videos/talking-head" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "script": "[excited] Hey everyone! Welcome to my channel. [calm] Today I want to talk about something really important.",
  "model": "veed-lipsync",
  "influencer_id": "your-influencer-id",
  "template_id": "tech-studio",
  "angle_id": "front-16-9",
  "aspect_ratio": "9:16",
  "audio_settings": {
    "speed": 1,
    "emotion": "neutral",
    "language": "en"
  },
  "audio_mode": "generate"
}'

{
  "generation_id": "clxxxx_talking_head_001",
  "status": "queued",
  "estimated_time": 120
}

curl -X POST "https://influencerstudio.com/api/v1/videos/upscale" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "video_url": "https://example.com/video.mp4",
  "model": "topaz",
  "upscale_factor": 2,
  "topaz_video_model": "Proteus",
  "output_quality": "high",
  "target_fps": 30
}'

{
  "generation_id": "clxxxx_gen_upscale_001",
  "status": "queued",
  "estimated_time": 180
}

curl -X POST "https://influencerstudio.com/api/v1/videos/upscale/seedvr" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "video_url": "https://example.com/video.mp4",
  "upscale_mode": "factor",
  "upscale_factor": 2,
  "output_quality": "high",
  "target_resolution": "720p"
}'

{
  "generation_id": "clxxxx_gen_upscale_001",
  "status": "queued",
  "estimated_time": 180
}

curl -X POST "https://influencerstudio.com/api/v1/videos/upscale/topaz" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "video_url": "https://example.com/video.mp4",
  "upscale_mode": "factor",
  "target_resolution": "720p",
  "output_quality": "high",
  "target_fps": 30
}'

{
  "generation_id": "clxxxx_gen_upscale_002",
  "status": "queued",
  "estimated_time": 180
}

curl -X POST "https://influencerstudio.com/api/v1/models-3d/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "prompt": "A medieval knight in full armor",
  "settings": {
    "mode": "preview",
    "art_style": "realistic",
    "topology": "quad",
    "target_polycount": 50000,
    "symmetry_mode": "off",
    "should_remesh": true,
    "is_a_t_pose": true,
    "enable_pbr": true,
    "enable_prompt_expansion": true
  },
  "model": "meshy/v6/text-to-3d"
}'

{
  "generation_id": "clxxxx1234567890",
  "status": "queued",
  "model_url": "https://cdn.influencerstudio.com/generations/model_001.glb",
  "estimated_time": 180,
  "credits_used": 100
}

curl -X POST "https://influencerstudio.com/api/v1/text/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "prompt": "Write a creative story about a dog",
  "model": "venice-uncensored",
  "settings": {
    "temperature": 0.5,
    "max_tokens": 2000,
    "system_prompt": "You are a helpful teacher who explains complex topics simply"
  }
}'

{
  "generation_id": "clxxxx1234567890",
  "text": "Once upon a time, there was a fluffy golden retriever named Max who loved to chase butterflies in the meadow...",
  "model": "gpt-5.4",
  "usage": {
    "prompt_tokens": 25,
    "completion_tokens": 150,
    "total_tokens": 175
  }
}

curl -X GET "https://influencerstudio.com/api/v1/generations/{id}/status" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "generation_id": "clxxxx1234567890",
  "status": "completed",
  "result_urls": [
    "https://cdn.influencerstudio.com/generations/img_001.jpg",
    "https://cdn.influencerstudio.com/generations/img_002.jpg"
  ],
  "credits_used": 48,
  "total_items": 2,
  "completed_items": 2,
  "failed_items": 0,
  "items": [
    {
      "id": "clxxxx_img_001",
      "type": "image",
      "status": "COMPLETED",
      "url": "https://cdn.influencerstudio.com/generations/img_001.jpg",
      "created_at": "2026-02-03T10:00:00.000Z",
      "updated_at": "2026-02-03T10:00:30.000Z"
    },
    {
      "id": "clxxxx_img_002",
      "type": "image",
      "status": "COMPLETED",
      "url": "https://cdn.influencerstudio.com/generations/img_002.jpg",
      "created_at": "2026-02-03T10:00:00.000Z",
      "updated_at": "2026-02-03T10:00:35.000Z"
    }
  ]
}

curl -X GET "https://influencerstudio.com/api/v1/billing/plans" \
  -H "Authorization: Bearer YOUR_API_KEY"

[
  {
    "id": "plan_starter",
    "name": "Starter Pack",
    "description": "500 credits for basic usage",
    "storeId": "store_123",
    "variants": [
      {
        "id": "497267",
        "active": true,
        "price": 9.99,
        "currency": "USD",
        "interval": "one_time",
        "interval_count": 1
      }
    ]
  }
]

curl -X GET "https://influencerstudio.com/api/v1/billing/credits" \
  -H "Authorization: Bearer YOUR_API_KEY"

1500

curl -X POST "https://influencerstudio.com/api/v1/billing/top-up" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "plan_id": "497267"
}'

{
  "checkoutUrl": "https://checkout.stripe.com/c/pay/cs_test_xxxxx"
}

curl -X GET "https://influencerstudio.com/api/v1/storyboard" \
  -H "Authorization: Bearer YOUR_API_KEY"

curl -X GET "https://influencerstudio.com/api/v1/storyboard/{projectId}" \
  -H "Authorization: Bearer YOUR_API_KEY"