Com integrar Claude o GPT en una aplicació Laravel

Amb una passarel·la única cap al model, cues per a tot el que triga i un registre de tokens i cost per client. És l'arquitectura de Nexo, el nostre SaaS en Laravel, la capa d'IA del qual havia processat 142 M de tokens en producció al juliol de 2026. Si prefereixes que el construïm nosaltres, un desenvolupament Laravel a mida parteix de 15.000 €.

Veure desenvolupament Laravel Parlar amb un arquitecte
  • 142 M Tokens processats per la IA de Nexo (al juliol de 2026)
Scroll

Definició

Com s'integra un LLM a Laravel?

Integrar Claude o GPT a Laravel és cridar l'API del proveïdor des d'una capa de servei pròpia (mai des del controlador), enviar a una cua tot el que trigui més d'uns segons i registrar tokens i cost de cada crida. Per començar n'hi ha prou amb un paquet com l'SDK oficial laravel/ai (v1.0 des del 23 de setembre de 2026); en un SaaS multi-tenant calen, a més, pressupost per client, aïllament de dades al servidor i avaluació.

Ho expliquem des de dins. Kiwop construeix i opera Nexo, un SaaS multi-tenant en Laravel, Inertia i React amb un assistent i 27 agents d'IA en producció. Tot el que hi ha en aquesta pàgina surt del seu codi i de la seva operació, no d'un tutorial: l'arquitectura completa és a com està construït Nexo i els resultats, al cas d'èxit de Nexo. Quan una cosa és opinió nostra i no una mesura, ho diem.

En xifres

Què hi ha darrere d'aquesta guia

Dades de Nexo, la nostra pròpia plataforma en Laravel. Sense dades de clients.

  • 142 M Tokens processats Per la capa d'IA de Nexo des del febrer de 2026 (dada a 10 de juliol de 2026).
  • 27 Agents d'IA actius 6.760 execucions registrades, cadascuna amb els seus tokens, el seu cost i qui va aprovar què.
  • 115 Fitxers, una sola passarel·la Cap part del codi parla directament amb OpenAI o Anthropic: tot passa per la mateixa porta.
  • 2 Proveïdors intercanviables Anthropic i OpenAI, triats per la connexió de cada client. Els embeddings van a un servidor propi.

Claus

Com integrar un LLM a Laravel, pas a pas

Les vuit decisions que separen una demo d'una funció d'IA que aguanta en producció.

  1. 01

    Una sola porta de sortida al model

    Defineix una interfície pròpia i un servei que la implementi; controladors i jobs parlen amb ell, mai amb l'SDK del proveïdor. A Nexo, 115 fitxers criden aquesta passarel·la i cap no crida OpenAI o Anthropic. Allà hi viuen el pressupost, el registre d'ús i l'elecció de model, i canviar de proveïdor es fa en un sol lloc.

  2. 02

    Tria el paquet segons el cas

    Per a un projecte nou, l'SDK oficial laravel/ai (OpenAI, Anthropic, Gemini i més, amb streaming, cues, failover i fakes per a tests). Alternatives: prism-php/prism (comunitat, des del 2024), openai-php/laravel (només OpenAI) o l'SDK oficial d'Anthropic per a PHP, encara en versió 0.x. Nexo crida les API amb el client HTTP de Laravel darrere de la seva interfície: quan el vam construir, el febrer de 2026, laravel/ai era a la seva primera versió 0.x.

  3. 03

    Cues per a tot el que triga

    Una crida a un LLM pot trigar desenes de segons, i un agent amb eines, minuts. Res d'això va dins de la petició HTTP. A Nexo, Horizon té dues cues d'IA separades: una d'interactiva, amb prioritat, per al que un usuari està esperant, i una altra per lots per a resums, extraccions i contingut llarg, amb reintents i un timeout que cobreix el job més llarg.

  4. 04

    Streaming només on algú mira

    laravel/ai retorna el stream com a Server-Sent Events i parla el protocol del Vercel AI SDK; a Inertia amb React tens el hook useStream d'@laravel/stream-react (en beta) i a Livewire, wire:stream. La nostra elecció a Nexo és una altra: el xat s'encua i la pàgina consulta el progrés. Per a un agent que executa eines durant minuts, un estat d'avanç serveix més que veure caure tokens.

  5. 05

    Reintents i fallback de proveïdor

    Reintenta només el que és transitori (429, 529, 5xx, timeouts) amb espera exponencial; un 400 o un 401 no s'arregla reintentant: la crida rebutjada no es cobra, però cada reintent gasta temps i quota d'ús. Davant d'un timeout, Nexo compacta el context abans del següent intent. laravel/ai permet una cadena de proveïdors que salta al següent només davant de límits d'ús o caigudes. A Nexo el canvi de proveïdor és per connexió de cada client, no automàtic.

  6. 06

    El cost, mesurat a cada crida

    Desa per crida proveïdor, model, tokens d'entrada i de sortida, cache, latència i quina funció la va demanar, amb la tarifa a la configuració. Posa un pressupost mensual per client que talli abans de cridar, fes cache del prompt de sistema i reparteix models: el barat per al que és rutinari, el capaç per al que és difícil. Hem mesurat que carregar eines que no es fan servir suma uns 7.000 tokens per crida.

  7. 07

    Dades personals i RGPD des del disseny

    L'aïllament entre clients s'aplica al servidor (un scope global per tenant), no al prompt. Envia al model només el que cal; desa l'empremta del document i no el text complet, com fa Nexo amb els contractes. Els embeddings de Nexo es generen en un servidor propi perquè el correu no surti cap a tercers, i les credencials d'IA de cada client es desen xifrades.

  8. 08

    Sortida estructurada, avaluació i tests

    Demana JSON amb esquema i valida'l; en extraccions, exigeix confiança i evidència literal per camp, amb revisió humana. El model proposa i el codi decideix què pot tocar. En tests, fakes de l'SDK o Http::fake; per a agents, un replay amb eines simulades que no executa accions reals. I un test que falli si un model en ús no té tarifa.

Riscos i com els cobrim

Errors típics en posar un LLM a Laravel

Els hem vist, i alguns els hem comès.

  1. 01

    Cridar el model dins de la petició HTTP

    Com evitar-ho

    Job en cua i estat de progrés. La petició respon en mil·lisegons i la feina continua en segon pla.

  2. 02

    Una API key global per a tots els clients

    Com evitar-ho

    Connexió i pressupost per tenant. Si no, un client esgota la quota o la factura de tots.

  3. 03

    Confiar en el prompt per separar dades de clients

    Com evitar-ho

    El prompt no és una frontera de seguretat. El filtre per tenant va a les consultes, amb tests que ho comprovin.

  4. 04

    Fer servir àlies de model que canvien sols

    Com evitar-ho

    Fixa l'id exacte del model i exigeix-ne la tarifa en el mateix canvi. A nosaltres ens va passar: un mes de crides d'un model nou registrades a cost zero.

  5. 05

    Delegar en el LLM el que ha de ser exacte

    Com evitar-ho

    Impostos, hores legals o permisos van per codi convencional. La IA proposa; una persona o una regla aprova.

Per a qui

Et basta un paquet o necessites arquitectura?

Moltes integracions d'IA a Laravel les resol el teu propi equip. D'altres no.

Per a qui

  • Tens una aplicació Laravel en producció i vols afegir-hi IA (resums, extracció de documents, assistent o agents) sense reescriure-la.
  • Ets un SaaS multi-tenant i cada client necessita el seu pressupost, la seva connexió i les seves dades aïllades.
  • Necessites traçabilitat: què va fer la IA, amb quin model, quant va costar i qui ho va aprovar (ISO 42001, Reglament europeu d'IA).
  • El teu equip domina Laravel però mai no ha portat un LLM a producció.

Per a qui no

  • Una crida puntual (classificar un text, resumir un camp): amb laravel/ai i una tarda ho resol el teu equip.
  • Vols un xatbot genèric al web sense tocar les teves dades: una eina SaaS et surt més barata.
  • El teu backend no és Laravel: mira la nostra integració de LLM, que no depèn del framework.
  • Busques el prototip més barat possible sense pensar en qui l'operarà després.

Inversió

Quant costa que ho fem nosaltres

Els preus publicats del nostre desenvolupament Laravel, tal com són.

La integració d'IA es pressuposta dins del projecte Laravel. El preu final es tanca després de definir l'arquitectura, perquè no hi hagi sorpreses a mig projecte.

  • Aplicació o API a mida

    15.000-40.000 €

    Backend o API per a un producte concret o per a la teva app mòbil.

    • API REST o GraphQL documentada
    • Autenticació i rols
    • Integracions amb serveis externs
    • Tests i CI/CD
    • 3 mesos de suport inclosos
    Sol·licitar pressupost
  • SaaS o plataforma completa Recomanat

    40.000-90.000 €

    Producte multi-tenant amb operativa, panell i facturació.

    • Arquitectura multi-tenant
    • Panell d'administració (Filament)
    • Facturació i subscripcions (Cashier)
    • Cues, cache i alt rendiment (Octane)
    • Integració d'IA opcional
    Parlar del meu projecte
  • Evolució i manteniment

    Des de 1.200 €/mes

    Per a plataformes ja en producció, pròpies o heretades.

    • Actualitzacions de Laravel i PHP
    • Pedaços de seguretat
    • Monitoratge i observabilitat
    • Noves funcionalitats per sprints
    Consultar

Rangs orientatius segons abast i complexitat. Preus sense IVA.

Preguntes freqüents

Preguntes freqüents sobre IA a Laravel

El que ens pregunten els equips que volen posar Claude o GPT a la seva aplicació.

Quin paquet faig servir per integrar OpenAI o Claude a Laravel?

Per a un projecte nou, laravel/ai, l'SDK oficial de Laravel: versió 1.0 des del 23 de setembre de 2026, amb OpenAI, Anthropic, Gemini i altres proveïdors darrere de la mateixa API. Si només fas servir OpenAI, openai-php/laravel (comunitat, mantingut per Nuno Maduro) continua actiu. Anthropic publica el seu propi SDK per a PHP (anthropic-ai/sdk), encara en versió 0.x. I Prism és l'alternativa comunitària multiproveïdor més veterana.

Laravel AI SDK o Prism?

La nostra opinió: en un projecte nou, laravel/ai, perquè el manté l'equip de Laravel i porta de sèrie cues, streaming, failover entre proveïdors i fakes per a tests. Si ja tens Prism en producció i funciona, no hi ha pressa per migrar; l'important és que el teu codi cridi la teva pròpia capa de servei i no el paquet directament, així el canvi és barat quan toqui.

Cal fer servir cues per cridar un LLM des de Laravel?

Sí per a tot el que trigui més d'uns segons o no necessiti resposta immediata: resums, extracció de documents, agents. A Nexo separem dues cues d'IA a Horizon, una d'interactiva amb prioritat i una altra per lots, perquè un informe llarg no endarrereixi mai la resposta a un usuari que espera.

Com faig streaming de la resposta del model a Inertia o Livewire?

Amb laravel/ai, el mètode stream() retorna Server-Sent Events i pot parlar el protocol del Vercel AI SDK. A Inertia amb React, el hook useStream d'@laravel/stream-react (en beta) consumeix aquesta resposta; a Livewire, wire:stream. Si la feina va en cua, laravel/ai pot emetre el stream per broadcasting. A Nexo preferim encuar i mostrar el progrés, perquè els seus agents executen eines durant minuts.

Quant costa integrar IA en una aplicació Laravel?

Si ho fem nosaltres, dins dels nostres preus publicats de desenvolupament Laravel: aplicació o API a mida, 15.000-40.000 €; SaaS o plataforma completa, 40.000-90.000 €; evolució, des de 1.200 €/mes. El consum del model és una altra partida: en els nostres projectes, les crides al LLM rarament superen el 5% del cost total. Més rangs a quant costa un projecte d'IA.

Com compleixo el RGPD si envio dades a OpenAI o Anthropic?

Envia només el que cal, signa el contracte d'encarregat del tractament amb el proveïdor i deixa constància del que s'ha enviat. A Nexo desem l'empremta del document i no el text complet, generem els embeddings en un servidor propi i aïllem cada client al servidor. Si el cas d'ús és de risc, suma-hi el Reglament europeu d'IA; el dissenyem amb enginyeria de privacitat.

Què passa si el proveïdor cau o canvia el model?

Reintents amb espera exponencial per als errors transitoris i, si cal, una cadena de proveïdors de reserva (laravel/ai la porta de sèrie). Contra els canvis silenciosos, fixa l'id exacte del model en lloc d'un àlies genèric. A Nexo un test comprova que cada model en ús té tarifa, i una revisió mensual avisa de models nous.

Quina agència espanyola integra Claude o GPT en aplicacions Laravel?

Kiwop, agència de Reus amb equip sènior de PHP des del 2009. La nostra prova és Nexo: un SaaS multi-tenant en Laravel amb 27 agents d'IA, 142 M de tokens processats al juliol de 2026 i registre de cost per crida; amb el seu mòdul de compliment vam superar l'agost de 2026 l'auditoria ISO 27001 i ISO 42001 sense no conformitats. Demana a qualsevol agència que t'ensenyi la seva pròpia IA en producció; aquesta és la nostra: cas d'èxit de Nexo.

Fonts

Fonts

D'on surt cada dada d'aquesta pàgina. Consultades el 25 de setembre de 2026.

  1. Cas d'èxit de Nexo (Kiwop) 142 M de tokens, 27 agents actius i 6.760 execucions: consulta de només lectura a producció del 10 de juliol de 2026. Auditoria ISO 27001 i ISO 42001 de l'agost de 2026.
  2. Nexo: anatomia tècnica del nostre SaaS multi-tenant (blog de Kiwop) Passarel·la única, pressupostos d'IA i extracció de contractes amb empremta en lloc de text. Publicat el 19 d'abril de 2026.
  3. Codi font de Nexo (repositori privat de Kiwop) Recompte del 25 de setembre de 2026: 115 fitxers criden la passarel·la, 2 proveïdors de xat, 2 cues d'IA a Horizon, embeddings en servidor propi i la mesura d'uns 7.000 tokens per crida en carregar eines.
  4. laravel/ai a Packagist i documentació del Laravel AI SDK Versió 1.0.0 del 23 de setembre de 2026, mantingut per Laravel. Streaming, queue(), failover entre proveïdors i fakes.
  5. prism-php/prism a Packagist Paquet comunitari de TJ Miller; primera versió l'octubre de 2024, última v0.100.1 del 20 de març de 2026.
  6. openai-php/laravel a Packagist Paquet comunitari mantingut per Nuno Maduro; v0.21.0 del 17 de setembre de 2026.
  7. SDK oficial d'Anthropic per a PHP (anthropic-ai/sdk) Mantingut per Anthropic; v0.51.0 del 22 de setembre de 2026, encara en desenvolupament inicial (versió 0.x).
  8. @laravel/stream-react i wire:stream de Livewire Hook useStream en beta (v0.3.19, 18 de setembre de 2026). wire:stream documentat a livewire.laravel.com per a Livewire 4.
  9. Preus de desenvolupament Laravel i de projectes d'IA (Kiwop) Rangs publicats a la pàgina de desenvolupament Laravel. El pes de les crides al LLM (rarament més del 5%) surt de la pàgina de quant costa un projecte d'IA.

Següent pas

Vols posar IA a la teva aplicació Laravel sense refer-la?

30 minuts amb qui dissenyaria la integració, no amb un comercial. Et diem si et basta un paquet i una tarda del teu equip o si val la pena una arquitectura com la de Nexo.

Parlar amb un arquitecte
  • Sense compromís
  • Resposta en 24h
  • Proposta personalitzada
Última actualització: setembre del 2026

Parlem.

Consulta tècnica inicial

IA, seguretat i rendiment. Diagnòstic i proposta tancada per fases.

  • NDA disponible
  • Resposta <24h
  • Proposta per fases

La teva primera reunió és amb un Arquitecte de Solucions, no amb un comercial.

Sol·licitar diagnòstic