Skip to content

非公式 / UnofficialCloudflare, Inc. 非提携。アカウント情報は入力しないでください。Not affiliated with Cloudflare, Inc. Do not enter Cloudflare credentials here.Official docsこのサイトについてプライバシー

Workers バインディング

最終更新 Markdown で表示Agent セットアップ

AI バインディング(env.AI)を使うと、Worker から直接 AI モデルを呼び出し、AI Gateway の機能にアクセスできます。

手順ごとのセットアップガイドは、Workers AI を AI Gateway と一緒にセットアップする を参照してください。

設定

Wrangler 設定ファイル に AI バインディングを追加します。

{
	"ai": {
		"binding": "AI",
	},
}
[ai]
binding = "AI"

バインディングは Worker コード内で env.AI としてアクセスできます。

TypeScript を使う場合は、Wrangler 設定ファイルを変更するたびに wrangler types を実行します。バインディングに基づく env オブジェクトの型と、ランタイム型 が生成されます。

env.AI.run()

AI Gateway 経由で推論リクエストを実行します。Workers AI モデル(@cf/ プレフィックス)とサードパーティモデル({author}/{model} 形式)を受け付けます。

Workers AI モデル:

const resp = await env.AI.run(
	"@cf/moonshotai/kimi-k2.5",
	{
		prompt: "tell me a joke",
	},
	{
		gateway: {
			id: "default", // or use a specific gateway name
		},
	},
);
const resp = await env.AI.run(
	"@cf/moonshotai/kimi-k2.5",
	{
		prompt: "tell me a joke",
	},
	{
		gateway: {
			id: "default", // or use a specific gateway name
		},
	},
);

前払いの AI Gateway クレジット を使うには、ゲートウェイの Workers AI billing 設定 を Unified billing にし、バインディングリクエストでそのゲートウェイを指定します。前払いクレジットを使うと、本来 Workers Paid プランが必要な Workers AI モデルにアクセスでき、フロンティアモデルのレート制限が上がります。

サードパーティモデル:

const resp = await env.AI.run(
	"openai/gpt-4.1-mini",
	{
		messages: [{ role: "user", content: "tell me a joke" }],
	},
	{
		gateway: {
			id: "default", // or use a specific gateway name
		},
	},
);
const resp = await env.AI.run(
	"openai/gpt-4.1-mini",
	{
		messages: [{ role: "user", content: "tell me a joke" }],
	},
	{
		gateway: {
			id: "default", // or use a specific gateway name
		},
	},
);

サードパーティモデルには AI Gateway が必要で、Unified Billing を使います。Cloudflare がプロバイダーの資格情報を管理し、アカウントからクレジットを差し引きます。独自の API キーを渡す必要はありません。

利用できるモデルは モデルカタログ で確認できます。

ゲートウェイオプション

env.AI.run() の第 3 引数は、次のパラメーターを持つ gateway オブジェクトを受け付けます。

パラメーター 型 デフォルト 説明
id string 必須 AI Gateway の名前。Worker と同じアカウントである必要があります。最初の認証済みリクエストでゲートウェイを自動作成するには "default" を使います。詳細は デフォルトゲートウェイ を参照してください。
skipCache boolean false このリクエストで キャッシュ をスキップします。
cacheTtl number — 秒単位の キャッシュ TTL。
cacheKey string — このリクエスト向けのカスタム キャッシュキー。
collectLog boolean — このリクエストの ログを収集 するかどうか。
metadata object — ログエントリに付ける カスタムメタデータ。

env.AI.aiGatewayLogId

直近の env.AI.run() リクエストのログ ID を返します。

const myLogId = env.AI.aiGatewayLogId;

env.AI.gateway()

AI Gateway メソッドに直接アクセスするためのゲートウェイインスタンスを返します。

const gateway = env.AI.gateway("my-gateway");

ゲートウェイインスタンスは次のメソッドを公開します。

patchLog()

特定のログエントリにフィードバック、スコア、メタデータを送ります。第 2 引数のプロパティはすべて任意です。

await gateway.patchLog("my-log-id", {
	feedback: 1,
	score: 100,
	metadata: {
		user: "123",
	},
});

戻り値: Promise<void>

getLog()

特定のログエントリの詳細を取得します。AiGatewayLog 型がない場合は wrangler types を実行します。

const log = await gateway.getLog("my-log-id");

戻り値: Promise<AiGatewayLog>

getUrl()

AI Gateway のベース URL を返します。任意のプロバイダー名を渡すと、プロバイダー固有のエンドポイントを取得できます。

const baseUrl = await gateway.getUrl();
// https://gateway.ai.cloudflare.com/v1/my-account-id/my-gateway/

const openaiUrl = await gateway.getUrl("openai");
// https://gateway.ai.cloudflare.com/v1/my-account-id/my-gateway/openai

パラメーター: 任意の provider(string または AIGatewayProviders enum)

戻り値: Promise<string>

SDK 統合の例

OpenAI SDK:

import OpenAI from "openai";

const openai = new OpenAI({
	apiKey: "my api key", // defaults to process.env["OPENAI_API_KEY"]
	baseURL: await env.AI.gateway("my-gateway").getUrl("openai"),
});

Vercel AI SDK with OpenAI:

import { createOpenAI } from "@ai-sdk/openai";

const openai = createOpenAI({
	baseURL: await env.AI.gateway("my-gateway").getUrl("openai"),
});

Vercel AI SDK with Anthropic:

import { createAnthropic } from "@ai-sdk/anthropic";

const anthropic = createAnthropic({
	baseURL: await env.AI.gateway("my-gateway").getUrl("anthropic"),
});

役に立ちましたか?