BYOK (Bring Your Own Key)
Plus plan runs with your own API key: what you pay Edgaze and what you pay your provider.
Buyers using their own provider keys and creators choosing a listing credential mode.
Overview#
Buyer-BYOK (Plus) runs charge creator margin plus $0.002 for Edgaze orchestration. The provider bills usage to the buyer's saved key.
The displayed price on the product page reflects margin plus orchestration only. It is lower than a fully hosted run on the same margin.
How it works#
Each listing declares one provider-key mode. In buyer-BYOK mode, a Plus subscriber saves every required provider key in API Vault before running. In creator-connected mode, the creator supplies the keys and pays the provider directly. Edgaze-hosted listings require no buyer key.
For buyer-BYOK, the displayed Edgaze price is margin plus $0.002. Provider usage appears on the buyer's provider account and is not paid from the Edgaze wallet.
On success, the buyer pays or consumes a bundle run at the displayed Edgaze price. The creator earns 80% of margin.
If a run fails#
Failure releases the margin charge. You are not charged the creator's margin. Orchestration handling on failure follows the standard failure policy. The run surface shows BYOK pricing context alongside the error.
Special cases#
- Multiple providers: The key owner must have every provider listed on the product page.
- Insufficient provider quota: The run may fail. Treated as a failure for margin billing.
- Bundle funding: BYOK runs can consume bundle runs if the version matches. Orchestration still applies to the displayed price.
What you see in Edgaze#
- Credential mode and required providers on the listing before the run action
- Reduced displayed price versus a non-BYOK listing on the same margin
- API Vault key status and Plus gating
Related policies#
Was this useful?
Your response helps us improve the documentation.
Related documentation
How workflow runs are priced, funded, settled, and refunded. Step-by-step guides for buyers, creators, and developers.
How to open a workflow, fund a run, and what happens when it completes.
How the per-run price is built, what the creator earns, and what Edgaze keeps.