If a Dify Cloud app calls a CometAPI model, adding a second credential and adding a second model solve different problems. Use a credential pool to distribute calls for one model; use a separately tested routing policy when the application must switch models. A pool is not evidence that model fallback has been configured.
What Dify’s pool actually changes
Dify’s Model Providers documentation describes load balancing across keys for the same model. It rotates through keys in turn and rests a key that hits its limit for one minute before trying it again. The section is labeled Professional / Team; check your Dify Cloud plan and installed provider before relying on it.
The documented configuration is:
- Find the model, open Configure, then Load Balancing.
- Use Add credential to populate its pool.
- Enable at least two keys and save.
Dify also allows adding a credential more than once to send more traffic its way. That is a weighting mechanism, not another independent key or a new quota allocation.
Apply this to the CometAPI connection, not just the provider name
The official CometAPI Dify guide explicitly distinguishes one provider credential from multiple model configurations. A shared connection can authenticate supported models, but each LLM node still selects a model ID.
The guide documents two integration paths: the dedicated CometAPI plugin, which sets its endpoint internally, and the generic OpenAI-API-compatible provider, where custom model entries use https://api.cometapi.com/v1. Neither description proves that every installed plugin version exposes Dify’s credential pool. Confirm that the particular model configuration offers it; do not assume it from endpoint compatibility.
For this integration, separate the configuration decisions:
| Goal | Configuration to evaluate | What it does not establish |
|---|---|---|
| Distribute requests while retaining one CometAPI model ID | That model’s supported credential pool | Independent CometAPI quota buckets or more aggregate capacity |
| Route to a different CometAPI model | A separate model configuration plus an explicit switching policy | Equivalent inputs, tools, output behavior, or automatic failover |
The distinction matters even when both model routes share one CometAPI key. Authentication can stay unchanged while the model contract changes. CometAPI’s production guidance recommends pinning tested IDs and pairing fallback models only when they support the same inputs and required tools; it also calls for testing every fallback route.
Two acceptance checks, not one availability claim
Here is a proposed check before enabling either mechanism—not a report of a deployment test:
- Credential distribution: keep the exact CometAPI model ID and representative prompt fixed. Confirm the enabled pool entries and any deliberate weighting. Run a small, permitted test and observe credential selection using non-secret labels wherever your instrumentation exposes it. If selection is not observable, record that verification gap rather than claiming the pool worked. Do not log keys or authorization headers, or force rate-limit exhaustion just to demonstrate rotation.
- Model switching: test the alternate ID separately in the actual Dify workflow. Check required inputs, tools, structured-output expectations and context needs, then define when switching is allowed and what counts as an acceptable result. A successful text-only call is not enough for a workflow that depends on tools or image input.
The cited pages do not establish that distinct CometAPI keys have independent account limits. Treat quota independence as something to confirm, not something created by Dify’s pool. The one-minute key rest is documented Dify behavior—not a promise of recovery, extra capacity, savings, or successful model fallback.
The practical boundary: if the requirement is “keep calling this model with a credential pool,” validate that configuration. If it is “continue with another model,” validate the alternate route and switching policy as a separate feature.