Skip to content

[AI Gateway] Add REST API changelog#30899

Open
ethulia wants to merge 3 commits into
productionfrom
ml/changelog
Open

[AI Gateway] Add REST API changelog#30899
ethulia wants to merge 3 commits into
productionfrom
ml/changelog

Conversation

@ethulia
Copy link
Copy Markdown
Collaborator

@ethulia ethulia commented May 18, 2026

Summary

Screenshots (optional)

Documentation checklist

  • Is there a changelog entry (guidelines)? If you don't add one for something awesome and new (however small) — how will our customers find out? Changelogs are automatically posted to RSS feeds, the Discord, and X.
  • The change adheres to the documentation style guide.
  • If a larger change - such as adding a new page- an issue has been opened in relation to any incorrect or out of date information that this PR fixes.
  • Files which have changed name or location have been allocated redirects.

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented May 18, 2026

This pull request requires reviews from CODEOWNERS as it changes files that match the following patterns:

Pattern Owners
/src/content/changelog/ @cloudflare/pm-changelogs, @cloudflare/product-owners

ask-bonk[bot]
ask-bonk Bot reviewed May 18, 2026
View reviewed changes
Copy link
Copy Markdown
Contributor

@ask-bonk ask-bonk Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

One style issue to address before merge.

MEDIUM —

  • Uses LLM-filler phrase "straightforward", which the style guide explicitly prohibits. Posted an inline suggestion to fix.

Comment thread src/content/changelog/ai-gateway/2026-05-18-rest-api.mdx Outdated
@ask-bonk ask-bonk Bot added changelog Adds or updates changelog entries/pages. documentation Documentation edits labels May 18, 2026
@ask-bonk
Copy link
Copy Markdown
Contributor

ask-bonk Bot commented May 18, 2026

Review complete. Posted 1 inline suggestion and added labels changelog, documentation.

Summary: This PR adds a new AI Gateway changelog entry announcing the REST API on api.cloudflare.com with three endpoints (/ai/run, /ai/v1/chat/completions, /ai/v1/responses), a curl example, unified billing, and default gateway routing.

Issue flagged:

  • MEDIUM — src/content/changelog/ai-gateway/2026-05-18-rest-api.mdx:29
    • Uses the LLM-filler phrase "straightforward", which the style guide explicitly prohibits. Inline suggestion posted to rephrase the sentence directly.

Everything else looks good: valid frontmatter, correct product reference, working internal links with trailing slashes, appropriate code block formatting, and no unescaped MDX characters.

github run

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented May 18, 2026 •
edited
Loading

Preview URL: https://10d6bf3a.preview.developers.cloudflare.com
Preview Branch URL: https://ml-changelog.preview.developers.cloudflare.com

Files with changes (up to 15)

Original Link Updated Link
https://developers.cloudflare.com/changelog/post/2026-05-18-rest-api/ https://ml-changelog.preview.developers.cloudflare.com/changelog/post/2026-05-18-rest-api/

@ethulia @ask-bonk
Update src/content/changelog/ai-gateway/2026-05-18-rest-api.mdx
cec0d5e 
Co-authored-by: ask-bonk[bot] <249159057+ask-bonk[bot]@users.noreply.github.com>
@ethulia ethulia marked this pull request as ready for review May 18, 2026 20:48
@ethulia ethulia requested review from a team as code owners May 18, 2026 20:48
mchenco
mchenco reviewed May 18, 2026
View reviewed changes
Comment thread src/content/changelog/ai-gateway/2026-05-18-rest-api.mdx Outdated
date: 2026-05-18
---

AI Gateway now has its own REST API on `api.cloudflare.com`. You can call any model — whether from OpenAI, Anthropic, Google, or hosted on Workers AI — through one unified API, using the same endpoints and authentication regardless of provider. Three endpoints are available:
Copy link
Copy Markdown
Contributor

@mchenco mchenco May 18, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

AI Gateway now uses the AI REST API on api.cloudflare.com

(because it's not its own REST API)

mchenco
mchenco reviewed May 18, 2026
View reviewed changes
Comment thread src/content/changelog/ai-gateway/2026-05-18-rest-api.mdx Outdated

Every request through the REST API is routed through your account's default gateway, which is created automatically on first use. To route requests through a specific gateway, add the `cf-aig-gateway-id` header.

If you are already calling Workers AI models through the existing REST API, replace `/ai/run/@cf/{model}` with `/ai/run`, and move the model name into the request body with `"provider": "cloudflare"`.
Copy link
Copy Markdown
Contributor

@mchenco mchenco May 18, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

we should clarify that this path will still work

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@ask-bonk ask-bonk[bot] ask-bonk[bot] left review comments

@irvinebroque irvinebroque irvinebroque approved these changes

@mchenco mchenco mchenco approved these changes

Assignees

No one assigned

Labels

changelog Adds or updates changelog entries/pages. documentation Documentation edits product:changelog size/s

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

3 participants

@ethulia @irvinebroque @mchenco