List active Effects

GET

https://api.beatapi.io/v1/effects

GET

/v1/effects

curl https://api.beatapi.io/v1/effects

{
  "data": {
    "object": "list",
    "data": [
      {
        "id": "video-muscle-max",
        "object": "effect",
        "name": "Muscle Transformation",
        "description": "string",
        "output_type": "image",
        "category": "transformation",
        "tags": [
          "string"
        ],
        "input": {
          "images_min": 1,
          "images_max": 1,
          "accepted_types": [
            "image/jpeg"
          ],
          "max_size_mb": 1,
          "max_dimension_px": 1,
          "subject_requirements": [
            "string"
          ]
        },
        "options": {
          "aspect_ratios": [
            "string"
          ],
          "resolutions": [
            "string"
          ],
          "duration_seconds": [
            1
          ],
          "bgm": true,
          "seed": true
        },
        "preview": {
          "cover_url": "string",
          "media_url": "string"
        },
        "version": 1,
        "status": "testing"
      }
    ]
  }
}

Returns only versioned Effects that have passed BeatAPI publication gates. Internal integration names, template ids, costs, and execution context are never exposed.

クエリパラメータ

output_typeenumオプション

許可された値:

categorystringオプション

レスポンス

Active Effect catalog

dataobject

エラー

400

Bad Request Error

429

Too Many Requests Error