GET/api/models/{slug}/waterfall

Get a model's waterfall

Returns the model's default chain, your organization's override (null when none) and served_default (the chain the gateway walks for you without an override, with your substituting BYOK keys in place of the platform rungs they replace). Every rung carries its live health. Pass override_revision back as expected_revision on a write.

認証: AuthorizationヘッダーにBearer形式のAPIキー

パスパラメータ

  • slugstring必須

    Model slug.

クエリパラメータ

  • org_idstring

    Acting organization. Implied by a key; a session caller must name one.

レスポンス

  • 200

    The default chain and your override.

    レスポンス
    • model_idstring
    • slugstring
    • org_idstring | null
    • defaultarray<object>
      default
      • idstring
      • positioninteger

        0 is tried first.

      • model_provider_idstring | null
      • provider_connection_idstring | null
      • target_kindenum
        "deployment""connection""model"
      • referenced_model_idstring | null
      • referenced_modelobject | null
        いずれか

        object

        • idstring
        • slugstring
        • display_namestring
        • statusstring
      • providerstring | null
      • provider_model_idstring | null
      • base_urlstring | null
      • statusstring
      • rungstring | null

        The token to send in a PUT or PATCH: the deployment id, byok:{connection_id} or model:{model_id}.

      • fundingenum
        "platform""own_key""own_endpoint""fallback_model"null
      • healthobject | null
        いずれか

        object

        • statestring

          Fleet verdict, for example healthy, degraded, recovering, throttled, circuit_open, disabled. A BYOK rung reports its connection status.

        • reasonstring | null
        • lifecycleenum
          "active""draining""retired"
    • overridearray | null

      Your organization's chain; null when you have none.

      override
      • idstring
      • positioninteger

        0 is tried first.

      • model_provider_idstring | null
      • provider_connection_idstring | null
      • target_kindenum
        "deployment""connection""model"
      • referenced_model_idstring | null
      • referenced_modelobject | null
        いずれか

        object

        • idstring
        • slugstring
        • display_namestring
        • statusstring
      • providerstring | null
      • provider_model_idstring | null
      • base_urlstring | null
      • statusstring
      • rungstring | null

        The token to send in a PUT or PATCH: the deployment id, byok:{connection_id} or model:{model_id}.

      • fundingenum
        "platform""own_key""own_endpoint""fallback_model"null
      • healthobject | null
        いずれか

        object

        • statestring

          Fleet verdict, for example healthy, degraded, recovering, throttled, circuit_open, disabled. A BYOK rung reports its connection status.

        • reasonstring | null
        • lifecycleenum
          "active""draining""retired"
    • default_revisioninteger
    • override_revisioninteger

      Send this back as expected_revision on a write.

    • default_stateenum
      "absent""available""empty""unavailable"
    • override_stateenum
      "absent""available""empty""unavailable"
    • model_references_enabledboolean

      Whether model:{model_id} fallback-model rungs are accepted.

    • semantics_activeboolean
    • failover_modeenum
      "maximize_cache""maximize_availability""maximize_cache_affinity"
    • throttle_cache_thresholdnumber | null
    • served_defaultarray | null

      The chain served to you without an override: the default with your substituting BYOK keys in place of the platform rungs they replace. Null without an acting organization.

      served_default
      • idstring
      • positioninteger

        0 is tried first.

      • model_provider_idstring | null
      • provider_connection_idstring | null
      • target_kindenum
        "deployment""connection""model"
      • referenced_model_idstring | null
      • referenced_modelobject | null
        いずれか

        object

        • idstring
        • slugstring
        • display_namestring
        • statusstring
      • providerstring | null
      • provider_model_idstring | null
      • base_urlstring | null
      • statusstring
      • rungstring | null

        The token to send in a PUT or PATCH: the deployment id, byok:{connection_id} or model:{model_id}.

      • fundingenum
        "platform""own_key""own_endpoint""fallback_model"null
      • healthobject | null
        いずれか

        object

        • statestring

          Fleet verdict, for example healthy, degraded, recovering, throttled, circuit_open, disabled. A BYOK rung reports its connection status.

        • reasonstring | null
        • lifecycleenum
          "active""draining""retired"
  • 401

    Missing, unknown or revoked API key.

    レスポンス
    • errorstring必須

      Human-readable message.

    • codestring

      Stable machine reason, when the route defines one (for example pro_required).

    • actionstring

      Stable remediation action, when the route defines one.

    • detailsobject

      Customer-safe string facts the caller needs to act (for example a suggested identifier).

  • 404

    The model or the organization is not visible to you.

    レスポンス
    • errorstring必須

      Human-readable message.

    • codestring

      Stable machine reason, when the route defines one (for example pro_required).

    • actionstring

      Stable remediation action, when the route defines one.

    • detailsobject

      Customer-safe string facts the caller needs to act (for example a suggested identifier).

  • 422

    A session caller omitted org_id.

    レスポンス
    • errorstring必須

      Human-readable message.

    • codestring

      Stable machine reason, when the route defines one (for example pro_required).

    • actionstring

      Stable remediation action, when the route defines one.

    • detailsobject

      Customer-safe string facts the caller needs to act (for example a suggested identifier).

リクエスト

curl https://api.experientiallabs.ai/api/models/gpt-6-luna/waterfall?org_id=3f6c2a1e-8b7d-4c2a-9e51-6a0d4b2f7c10 \
  -H "Authorization: Bearer YOUR_API_KEY"

レスポンス

{
  "model_id": "6adffebe-5ed8-4466-8d2c-976afee63237",
  "slug": "gpt-6-luna",
  "org_id": "3f6c2a1e-8b7d-4c2a-9e51-6a0d4b2f7c10",
  "default": [
    {
      "id": "81297474-de0d-401e-b193-61746f3a0576",
      "position": 0,
      "model_provider_id": "b6574b0e-933c-4b69-993e-2a0d21e32385",
      "provider_connection_id": null,
      "target_kind": "deployment",
      "referenced_model_id": null,
      "referenced_model": null,
      "provider": "openai",
      "provider_model_id": "gpt-6-luna",
      "base_url": null,
      "status": "active",
      "rung": "b6574b0e-933c-4b69-993e-2a0d21e32385",
      "funding": "platform",
      "health": {
        "state": "healthy",
        "reason": null,
        "lifecycle": "active"
      }
    }
  ],
  "override": null,
  "default_revision": 4,
  "override_revision": 0,
  "default_state": "available",
  "override_state": "absent",
  "model_references_enabled": false,
  "semantics_active": true,
  "failover_mode": "maximize_cache",
  "throttle_cache_threshold": 0.5,
  "served_default": [
    {
      "id": "81297474-de0d-401e-b193-61746f3a0576",
      "position": 0,
      "model_provider_id": "b6574b0e-933c-4b69-993e-2a0d21e32385",
      "provider_connection_id": null,
      "target_kind": "deployment",
      "referenced_model_id": null,
      "referenced_model": null,
      "provider": "openai",
      "provider_model_id": "gpt-6-luna",
      "base_url": null,
      "status": "active",
      "rung": "b6574b0e-933c-4b69-993e-2a0d21e32385",
      "funding": "platform",
      "health": {
        "state": "healthy",
        "reason": null,
        "lifecycle": "active"
      }
    }
  ]
}

https://api.experientiallabs.ai/api/models/gpt-6-luna/waterfall?org_id=3f6c2a1e-8b7d-4c2a-9e51-6a0d4b2f7c10