← Cloudflare AI Gateway / ai-gateway / configuration

Vlastní domény

Vlastní domény umožňují odesílat požadavky AI Gateway prostřednictvím vlastního názvu hostitele, například ai.example.com, místo výchozího gateway.ai.cloudflare.com koncový bod.

Hostname identifikuje váš účet a gateway, takže ID účtu a ID gateway můžete v URL adresách požadavků vynechat. Požadavky směřují přímo na nativní trasy poskytovatelů AI Gateway a na trasy kompatibilní s OpenAI compat trasy.

Vlastní domény jsou zároveň základem pro kontroly s podporou rozpoznávání identity prostřednictvím Cloudflare Access, které uživatelům umožní ověřit se u vašeho poskytovatele identity, než budou moct volat vaši bránu.

Pokud je například vaše vlastní doména ai.example.com, požadavek na poskytovatele OpenAI používá:

https://ai.example.com/openai/v1/chat/completions

Namísto:

https://gateway.ai.cloudflare.com/v1/{account_id}/{gateway_id}/openai/v1/chat/completions

Totéž platí pro koncový bod kompatibilní s OpenAI. Například https://ai.example.com/compat/chat/completions směruje přes stejnou bránu pomocí compat trasa.

Přidání vlastní domény:

1. V Cloudflare dashboard ↗, přejděte na AI > AI Gateway.
2. Vyberte gateway, který chcete nakonfigurovat.
3. Přejděte na Domény kartě.
4. Vyberte Přidat doménu a zadejte hostname, který chcete použít. Volitelně zvolte subdoménu.
5. AI Gateway automaticky vytvoří záznam DNS v dashboardu.

Po nastavení domény na ni můžete odesílat požadavky. Chcete-li vyžadovat, aby se uživatelé před voláním brány ověřili, nastavit Cloudflare Access pro doménu.

Vlastní domény můžete také vytvářet a spravovat přes Cloudflare API.

Na rozdíl od dashboardu API za vás nevytvoří záznam DNS. Po vytvoření vlastní domény použijte vrácený cname_target k vytvoření proxovaného záznamu CNAME pro váš hostname.

curl "https://api.cloudflare.com/client/v4/accounts/%7Baccount_id%7D/ai-gateway/gateways/%7Bgateway_id%7D/custom-domains" \
	--request POST \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
	--json '{
		"domain": "ai.example.com",
		"zone_id": "395566f4c8a5b9d2a5fc0d457b007c44"
	}'

Odpověď obsahuje stav vlastní domény a cíl CNAME:

{
	"success": true,
	"result": {
		"hostname": "ai.example.com",
		"gateway_id": "my-gateway",
		"status": "pending_dcv",
		"cname_target": "<cname-target>",
		"created_at": 1782925200000,
		"modified_at": 1782925200000
	}
}

V zóně, které patří vaše vlastní doména, vytvořte proxovaný záznam CNAME. Nastavte content do cname_target vrácený při vytvoření vlastní domény.

curl "https://api.cloudflare.com/client/v4/zones/%7Bzone_id%7D/dns_records" \
	--request POST \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
	--json '{
		"type": "CNAME",
		"name": "ai",
		"content": "<cname-target>",
		"proxied": true
	}'

Vlastní doména zůstává v pending_dcv do dokončení ověření vlastnictví domény.

curl "https://api.cloudflare.com/client/v4/accounts/%7Baccount_id%7D/ai-gateway/gateways/%7Bgateway_id%7D/custom-domains" \
	--request GET \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN"

curl "https://api.cloudflare.com/client/v4/accounts/%7Baccount_id%7D/ai-gateway/gateways/%7Bgateway_id%7D/custom-domains/%7Bhostname%7D" \
	--request GET \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN"

curl "https://api.cloudflare.com/client/v4/accounts/%7Baccount_id%7D/ai-gateway/gateways/%7Bgateway_id%7D/custom-domains/%7Bhostname%7D" \
	--request DELETE \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN"

Odesílejte požadavky na vlastní doménu bez ID účtu nebo ID gateway v cestě:

curl -X POST "https://ai.example.com/openai/v1/chat/completions" \
  --header "Content-Type: application/json" \
  --data '{
    "model": "gpt-4.1-mini",
    "messages": [
      {
        "role": "user",
        "content": "What is Cloudflare?"
      }
    ]
  }'

Pokud je doména chráněna Cloudflare Access, požadavek musí obsahovat také platný Access token. Podrobnosti najdete v Cloudflare Access.

Vlastní domény zatím nejsou podporovány u novějších koncových bodů AI Gateway obsluhovaných prostřednictvím Cloudflare REST API (api.cloudflare.com).