Tässä luvussa käymme läpi, miten saat kehitysympäristösi valmiiksi OpenAI API:n käyttöä varten PHP:llä. Oikein asennettu ja konfiguroitu ympäristö on perusta onnistuneelle kehitystyölle. Käymme vaiheittain läpi tarvittavien työkalujen asennuksen ja konfiguroinnin sekä ensimmäisen API-kutsun suorittamisen paikallisessa ympäristössäsi.
PHP:n ja tarvittavien kirjastojen asennus
Ennen kuin aloitat, varmista että sinulla on seuraavat komponentit asennettuna:
1. PHPAsennus
- PHP-versio: Suositeltava versio on PHP 7.4 tai uudempi, jotta yhteensopivuus uusimpien kirjastojen kanssa varmistetaan.
- Asennusohjeet:
- Windows: Lataa PHPvirallisilta sivuilta ja seuraa asennusohjeita.
- macOS: Voit käyttää Homebrew’ta komennolla
brew install php. - Linux: Asenna pakettienhallinnan kautta, esimerkiksi Ubuntu:
sudo apt-get install php.
2. Composerin Asennus
Composer on PHPriippuvuuksien hallintatyökalu, joka helpottaa kirjastojen asentamista ja päivittämistä.
- Asennus:
- Suorita seuraava komento terminaalissa:
[bash]<br>php -r "copy(’https://getcomposer.org/installer’, ’composer-setup.php’);" <br>php composer-setup.php <br>php -r "unlink(’composer-setup.php’);"<br>[/bash] - Siirrä
composer.pharjärjestelmän laajuiseen käyttöön:bashCopy codesudo mv composer.phar /usr/local/bin/composer
- Suorita seuraava komento terminaalissa:
3. OpenAIPHP-kirjaston Asentaminen
OpenAI tarjoaa virallisen PHP-kirjaston, joka helpottaa API-kutsujen tekemistä.
- Asennus Composerilla:Siirry projektihakemistoosi ja suorita:bashCopy code
composer require openai/openaiTämä komento asentaa OpenAIPHP-kirjaston sekä kaikki tarvittavat riippuvuudet.
Eroavaisuudet:
- Mukautettavuus: API:n avulla voit säätää mallin toiminnan parametreja tarkasti, kuten määrittää vastauksen pituuden, luovuuden tason ja tyyliin liittyviä ominaisuuksia.
- Integraatio: Voit integroida OpenAI mallit suoraan omiin sovelluksiisi, verkkosivustoihisi tai palveluihisi, jolloin käyttäjät voivat hyödyntää tekoälyä saumattomasti osana käyttökokemusta.
- Automaatio: API mahdollistaa tekoälytoimintojen automatisoinnin suurissa mittakaavoissa, mikä on välttämätöntä esimerkiksi massadatan käsittelyssä tai reaaliaikaisissa sovelluksissa.
- Skaalautuvuus: API on suunniteltu kestämään suuria käyttömääriä, ja se tarjoaa työkaluja kuormanhallintaan ja suorituskyvyn optimointiin.
- Kustannukset: API-käyttö on yleensä maksullista käyttömäärän perusteella, kun taas ChatGPT:n käyttö selaimessa voi olla rajoitettua tai edellyttää erillistä tilausta.
Esimerkki: Yksinkertainen API-kutsu PHP:llä ja vastauksen käsittely
Seuraavassa esimerkissä näytämme, miten voit tehdä yksinkertaisen API-kutsun OpenAIpalveluun PHPavulla ja käsitellä vastauksen.
Vaihe 1: Valmistelut
- API-avaimen hankkiminen: Rekisteröidy OpenAIsivustolla ja hanki henkilökohtainen API-avain.
- PHPcURL-laajennuksen varmistaminen: Varmista, että PHP-asennuksessasi on cURL-laajennus aktivoitu.
Vaihe 2: API-kutsun toteutus
[php]<?php
// Aseta API-avain
$api_key = ’YOUR_OPENAI_API_KEY’;
// Määritä pyyntödata
$data = array(
’prompt’ => ’Kirjoita lyhyt esittely PHP-ohjelmoinnista.’,
’max_tokens’ => 50,
’temperature’ => 0.7,
’model’ => ’text-davinci-003’
);
// Alusta cURL-istunto
$ch = curl_init(’https://api.openai.com/v1/completions’);
// Aseta cURL-asetukset
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, array(
’Content-Type: application/json’,
’Authorization: Bearer ’ . $api_key
));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
// Suorita pyyntö ja tallenna vastaus
$response = curl_exec($ch);
// Tarkista virheet
if ($response === false) {
echo ’cURL-virhe: ’ . curl_error($ch);
} else {
// Käsittele vastaus
$response_data = json_decode($response, true);
$generated_text = $response_data[’choices’][0][’text’];
echo ’Vastaus API:lta: ’ . $generated_text;
}
// Sulje cURL-istunto
curl_close($ch);
?>
[/php]
Selitys
API-avaimen asettaminen: Korvaa 'YOUR_OPENAI_API_KEY' omalla API-avaimellasi.Pyyntödatassa määritetään:
- prompt: Syöte, johon malli perustaa vastauksensa.
- max_tokens: Maksimimäärä tokeneita vastauksessa.
- temperature: Määrittää vastauksen luovuuden tason (0.0–1.0).
- model: Käytettävä malli (esim.
text-davinci-003).
cURL-asetukset: Määritetään HTTP-otsikot ja pyyntödata JSON-muodossa.
Vastauksen käsittely: JSON-vastaus dekoodataan, ja relevantti teksti poimitaan ja tulostetaan.
Mahdollinen tuloste
[csharp]Vastaus API:lta: PHP on suosittu palvelinpuolen skriptikieli, joka on suunniteltu verkkokehitykseen. Se on helppokäyttöinen ja integroituu hyvin HTML:ään, mikä tekee siitä erinomaisen valinnan dynaamisten verkkosivustojen ja sovellusten luomiseen.
[/csharp]
Huomioita
Virheenkäsittely: Esimerkissä on yksinkertainen virheenkäsittely cURL-virheille. Laajemmassa sovelluksessa kannattaa käsitellä myös API:n palauttamat virheet.
Tietoturva: Älä koskaan tallenna API-avaimia julkisesti saatavilla oleviin paikkoihin, kuten julkisiin GitHub-repositorioihin.
Yhteenveto
Tässä johdantoluvussa olemme tutustuneet siihen, mikä API on ja miten se mahdollistaa tekoälypalveluiden hyödyntämisen sovelluksissa. Olemme myös tarkastelleet, miten OpenAI API tarjoaa enemmän joustavuutta ja integraatiomahdollisuuksia verrattuna valmiisiin käyttöliittymiin, kuten ChatGPT. Lopuksi esittelimme käytännön esimerkin siitä, miten tehdä yksinkertainen API-kutsu PHPä ja käsitellä vastauksen.
Seuraavissa luvuissa syvennymme API:n perusteisiin, parametrien säätämiseen ja siihen, miten voit rakentaa tehokkaita ja optimoituja sovelluksia hyödyntäen OpenAI:n tarjoamia mahdollisuuksia.