Skip to content

update(doc): Update hosted key/byok section#4098

Merged
TheodoreSpeaks merged 3 commits intostagingfrom
doc/update-byok
Apr 10, 2026
Merged

update(doc): Update hosted key/byok section#4098
TheodoreSpeaks merged 3 commits intostagingfrom
doc/update-byok

Conversation

@TheodoreSpeaks
Copy link
Copy Markdown
Collaborator

Summary

We've added a lot more hosted keys for non-agent blocks. Updated documentation to show pricing and supported hosted keys.

Type of Change

  • Bug fix
  • New feature
  • Breaking change
  • Documentation
  • Other: ___________

Testing

I read the documentation.

Checklist

  • Code follows project style guidelines
  • Self-reviewed my changes
  • Tests added/updated and passing
  • No new warnings introduced
  • I confirm that I have read and agree to the terms outlined in the Contributor License Agreement (CLA)

Screenshots/Videos

@vercel
Copy link
Copy Markdown

vercel bot commented Apr 10, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
docs Ready Ready Preview, Comment Apr 10, 2026 9:41pm

Request Review

@cursor
Copy link
Copy Markdown

cursor bot commented Apr 10, 2026

PR Summary

Low Risk
Documentation-only changes, but adds/updates many pricing tables across multiple locales, so the main risk is incorrect or inconsistent published pricing/provider info.

Overview
Adds a new Hosted Tool Pricing section to execution/costs.mdx (EN/DE/ES/FR/JA/ZH) with per-operation cost tables for hosted tool providers (e.g. Firecrawl, Exa, Serper, Perplexity, Linkup, Parallel AI, Jina AI, Google Cloud, Brandfetch).

Updates BYOK docs (including enterprise/index.mdx in DE/ES/FR/JA/ZH and the EN costs page) to list the expanded set of supported providers and clarify that hosted keys cover both model and tool providers; also tweaks Mistral usage to include the Agent block and makes small punctuation/formatting fixes in the EN costs page.

Reviewed by Cursor Bugbot for commit f19ebea. Bugbot is set up for automated code reviews on this repo. Configure here.

@greptile-apps
Copy link
Copy Markdown
Contributor

greptile-apps bot commented Apr 10, 2026

Greptile Summary

This PR updates the hosted key / BYOK documentation across six languages to reflect newly supported providers (Firecrawl, Exa, Serper, Linkup, Parallel AI, Perplexity, Jina AI, Google Cloud, Brandfetch, Fireworks, and Mistral for Agent blocks). The English costs.mdx also gains a full new "Hosted Tool Pricing" section with per-operation pricing tables for all nine tool providers.

  • The new "Hosted Tool Pricing" section (and the restructured BYOK table + setup steps) was added only to the English file; the five translated costs.mdx files (de, es, fr, ja, zh) received only a one-line BYOK sentence update, leaving non-English readers without the hosted tool pricing information entirely.
  • The translated costs.mdx files still display a 1.4× hosted-model multiplier while the English doc now states 1.1×, making the translated pricing tables factually inconsistent with the source.

Confidence Score: 3/5

Hold for updates: two P1 content gaps mean non-English users see missing pricing sections and an incorrect multiplier.

Two P1 findings: the new "Hosted Tool Pricing" section is entirely absent from all five non-English docs, and the 1.4× vs 1.1× multiplier inconsistency makes the translated pricing tables factually wrong relative to the English source.

All five translated costs.mdx files (de, es, fr, ja, zh) need the "Hosted Tool Pricing" section added and the hosted-model multiplier corrected to 1.1×.

Important Files Changed

Filename Overview
apps/docs/content/docs/en/execution/costs.mdx Adds "Hosted Tool Pricing" section with per-operation tables for 9 providers and restructures BYOK section with a full provider table and setup steps; Firecrawl cost description is ambiguous ("credit" terminology conflicts with Sim's own credit unit).
apps/docs/content/docs/de/execution/costs.mdx Only updated the BYOK paragraph to list new providers; missing the new "Hosted Tool Pricing" section entirely, and still shows a 1.4× multiplier that conflicts with the English doc's 1.1× figure.
apps/docs/content/docs/es/execution/costs.mdx Same gap as the German file: BYOK sentence updated, but the new "Hosted Tool Pricing" section is absent and the 1.4× multiplier tables are not corrected.
apps/docs/content/docs/fr/execution/costs.mdx Same gap as other translated files: BYOK sentence updated, "Hosted Tool Pricing" section missing, multiplier not corrected.
apps/docs/content/docs/ja/execution/costs.mdx Same gap as other translated files: BYOK sentence updated, "Hosted Tool Pricing" section missing, multiplier not corrected.
apps/docs/content/docs/zh/execution/costs.mdx Same gap as other translated files: BYOK sentence updated, "Hosted Tool Pricing" section missing, multiplier not corrected.
apps/docs/content/docs/de/enterprise/index.mdx Adds 10 new BYOK provider rows to the supported-providers table; translation looks accurate.
apps/docs/content/docs/es/enterprise/index.mdx Same provider table additions as the German file; translation is consistent.
apps/docs/content/docs/fr/enterprise/index.mdx Same provider table additions; French translation looks accurate.
apps/docs/content/docs/ja/enterprise/index.mdx Same provider table additions; Japanese translation looks accurate.
apps/docs/content/docs/zh/enterprise/index.mdx Same provider table additions; Chinese translation looks accurate.

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
    A[Workflow Execution] --> B{API Key Source}
    B -->|Sim Hosted Key| C[1.1× multiplier applied]
    B -->|BYOK| D[Base provider price, no markup]
    C --> E{Block Type}
    E -->|Agent block| F[OpenAI / Anthropic / Google / Mistral / Fireworks]
    E -->|Tool block| G[Firecrawl / Exa / Serper / Perplexity / Linkup / Parallel AI / Jina AI / Google Cloud / Brandfetch]
    D --> H[Any supported provider at cost]
    F --> I[Billed in Sim credits]
    G --> I
    H --> I
Loading

Comments Outside Diff (1)

  1. apps/docs/content/docs/de/execution/costs.mdx, line 52-85 (link)

    P1 Hosted-model multiplier inconsistency across languages

    The English doc states a 1.1× pricing multiplier (e.g. GPT-5.1 hosted input: $1.38 = $1.25 × 1.1), but the German, Spanish, French, Japanese, and Chinese docs all still show 1.4× (e.g. GPT-5.1 hosted input: $1.75 = $1.25 × 1.4). This discrepancy is present in the untouched sections of these files and makes the translated pricing tables factually incorrect relative to the English source. The same mismatch is visible in es, fr, ja, and zh.

Reviews (1): Last reviewed commit: "Update cost page with new byok providers" | Re-trigger Greptile

@TheodoreSpeaks TheodoreSpeaks merged commit 34f77e0 into staging Apr 10, 2026
12 checks passed
@TheodoreSpeaks TheodoreSpeaks deleted the doc/update-byok branch April 10, 2026 21:48
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant