The Models endpoint provides a real-time list of all active AI models on Soup.video, along with their pricing formulas (in both Credits and USD) and expected schema parameters.

Retrieve Models

Endpoint: GET /api/models

Example Request

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

Example Response

{
  "models": [
    {
      "id": "seedance-2",
      "name": "Seedance 2.0",
      "type": "video",
      "description": "Bytedance Seedance 2.0 supports text-to-video, image-to-video...",
      "pricing": {
        "type": "per_second",
        "base_cost_usd": "$0.50",
        "base_cost_credits": 50,
        "rates": {
          "480p": {
            "video": "$0.08",
            "no_video": "$0.10"
          },
          "720p": {
            "video": "$0.15",
            "no_video": "$0.25"
          },
          "1080p": {
            "video": "$0.36",
            "no_video": "$0.56"
          }
        }
      },
      "params": [
        {
          "name": "prompt",
          "type": "string",
          "required": true
        },
        {
          "name": "resolution",
          "type": "string",
          "required": true,
          "expected_values": [
            "480p",
            "720p",
            "1080p"
          ],
          "default_value": "720p"
        }
      ]
    }
  ]
}