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",
  "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 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",
  "batch": 2,
  "settings": {
    "aspect_ratio": "1:1"
  }
}'

{
  "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/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"
}'

{
  "generation_id": "clxxxx1234567890",
  "status": "queued",
  "images": [
    "https://cdn.influencerstudio.com/generations/faceswap_001.jpg"
  ],
  "estimated_time": 20,
  "credits_used": 8
}

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-video/v2.6/pro/text-to-video",
  "settings": {
    "aspect_ratio": "16:9",
    "duration": 5
  }
}'

{
  "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/v2/pro"
}'

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

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": "llama-3.3-70b",
  "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"
}