Directorio de artigos
Cloudflare AI Por que a URL base sempre devolve un erro 404?
Este artigo ensínache en segundos como obter e configurar rapidamente un URL base de OpenAI compatible con Cloudflare. Inclúe modelos perfectos para a API REST oficial, o formato AI Gateway e clientes de terceiros (Dify/One-API), o que che axuda a poñer en funcionamento API de IA gratuítas cun só clic!
A semana pasada, un amigo que se dedica ao desenvolvemento independente púxose en contacto comigo de súpeto e envioume unha captura de pantalla que mostraba unha pantalla chea de erros 401. Díxome: "Irmán, levo todo o día intentando depurar a API de IA de Cloudflare, pero simplemente non funciona".
Botei unha ollada ao seu código. O URL base estaba configurado como /ai/v1, pero o corpo da solicitude estaba formatado como a API REST oficial, polo que os dous non coincidían en absoluto.
Dixo que só quería usar o SDK de OpenAI para depurar un modelo en Workers AI, hai algún problema?
Este é un gran problema.
Os servizos de IA de Cloudflare empregan tres URL base completamente diferentes dependendo do escenario. Cada un ten o seu propio formato e escenarios aplicables. Aínda que existe documentación, esta está dispersa por diferentes páxinas, o que dificulta saber a cal consultar no primeiro intento. Empregar o URL incorrecto producirá un erro 401 ou 400, o que che impedirá acceder ao servizo.
Cando me atopei con este problema por primeira vez, intentéino varias veces antes de descubrilo. Quedei sen palabras mirando a pantalla chea de mensaxes de erro.
Hoxe debuxarei claramente estes tres camiños para ti, para que non cometas máis erros despois de ler isto.
URL base da interface compatible con OpenAI
Comecemos co máis usado.
Se estás a usar o SDK de OpenAI ou ferramentas que admiten formatos de OpenAI personalizados como LangChain, Dify, NextChat ou One-API, esta é a estratexia correcta.
https://api.cloudflare.com/client/v4/accounts/{你的account_id}/ai/v1
Isto é algo que Cloudflare deseñou especificamente para aliñarse co formato da interface de OpenAI. Engade `/chat/completions` despois do punto final do diálogo completo. Substitúe o teu URL base de OpenAI orixinal por este e substitúe a clave API polo teu token de Cloudflare e debería executarse directamente. Probei modelos como `@cf/deepseek-ai/deepseek-r1-distill-qwen-32b` e `@cf/meta/llama-3.1-8b-instruct`, e todos funcionan ben.
Non obstante, cómpre sinalar que isto só admite modelos de diálogo baseados en texto.
API REST nativa oficial de Cloudflare
Se precisas usar Stable Diffusion para a creación de gráficos, Whisper para a transcrición de audio ou calquera modelo que non sexa textual, escolle a segunda ruta, que é a API REST nativa oficial de Cloudflare.
https://api.cloudflare.com/client/v4/accounts/{你的account_id}/ai/run
O nome do modelo pódese escribir na ruta, como /ai/run/@cf/bytedance/stable-diffusion-xl-lightning, ou pódese colocar no campo `model` do corpo da solicitude. Eu prefiro poñelo no campo; a ruta é máis curta e limpa. Ao principio tamén me confundiu este detalle. Algúns modelos aceptan ambos os métodos, mentres que outros só aceptan un. Presta atención a isto ao consultar a documentación.
URL base da pasarela de IA
Hai unha terceira vía: AI Gateway.
Este escenario é lixeiramente diferente. Se configuraches unha pasarela de IA no backend de Cloudflare para usar o proxy de API de terceiros, como o reenvío de solicitudes de OpenAI a través da pasarela de Cloudflare para o almacenamento en caché, a monitorización e a limitación da velocidade, o URL base sería...
https://gateway.ai.cloudflare.com/v1/{你的account_id}/{你的gateway_id}/openai
Engadir `/chat/completions` despois do punto final completo garante que todo o tráfico pase pola pasarela de Cloudflare e que o panel de rexistro mostre a latencia e o resultado de cada solicitude. Esta funcionalidade é incriblemente útil a medida que o equipo medra con máis proxectos, eliminando a necesidade de buscar entre os datos dos backends de varios provedores un por un.
Como elixir: Tres conxuntos de URL explicados nunha frase.
De acordo, iso abrangue os tres camiños. En resumo, só hai un principio.
O camiño que tomes depende das ferramentas que empregues.
Para usar o SDK de OpenAI para chamar un modelo de diálogo, vai a `/ai/v1`. Para chamar un modelo de imaxe/audio, vai a `/ai/run`. Para unha xestión unificada a través dunha pasarela, vai a `/gateway/`. O método de autenticación é o mesmo: coloca `Authorization: Bearer` seguido do teu token de API na cabeceira. Crea o token no backend de Cloudflare e lembra comprobar o permiso `Workers AI: Edit`.
Onde atopar o account_id? Inicia sesión no panel de administración de Cloudflare, desprázate cara abaixo ata a sección API na barra lateral dereita ou consulta a barra de enderezos do teu navegador; esa cadea alfanumérica de 32 caracteres é a que buscas.
Sinceramente, despois de axudarlle ao meu amigo a facelo ese día, díxome algo que creo que ten bastante razón: non era que non soubese como, senón que a documentación non mo explicara con claridade.
Moitas configuracións técnicas son así. Non é que sexan particularmente difíciles, pero hai demasiados puntos de entrada, o que fai que sexa doado perderse no primeiro intento. Se atopaches varios erros inexplicables ao configurar Cloudflare AI, o máis probable é que se deba a un URL base incorrecto ou a un formato incorrecto. Ten a man estes tres conxuntos de URL; podes atopar facilmente o correcto a próxima vez.
De nada.
Entón, xa que leches ata aquí, se che resultou útil, por favor, dálle a "Gústame" e compárteo. Se queres recibir actualizacións primeiro, tamén podes seguirme! ⭐
Grazas por ler o meu artigo. Ata a próxima.
Blog de Hope Chen Weiliang ( https://www.chenweiliang.com/ O artigo "Deixa de informar de erros! Configura facilmente Cloudflare para a compatibilidade con OpenAI con URL e interfaces base", compartido aquí, pode serche útil.
Benvido a compartir a ligazón deste artigo:https://www.chenweiliang.com/cwl-34252.html