Soup.video

API Documentation

Overview Authentication Models Generate Workflows Status Billing Errors Changelog

The Soup.video API uses Bearer Tokens to authenticate requests. You can generate a Secret Key in your Developer Settings.

Creating an API Key

  1. Go to your Developer Settings.
  2. Click Create Secret Key.
  3. Copy your key. It will only be shown once.

Making Authenticated Requests

Include the API key in the Authorization HTTP header of your requests:

Authorization: Bearer sk_soup_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

Example

curl -X GET https://soup.video/api/models \
  -H "Authorization: Bearer sk_soup_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"

Security Best Practices

  • Do not expose your API keys in frontend code (like React, Vue, or Vanilla JS).
  • Only make requests from your secure backend servers.
  • If your key is compromised, revoke it immediately from the Developer Dashboard.