API (Application Programming Interface) on rajapinta, joka mahdollistaa kahden ohjelmiston tai palvelun välisen viestinnän. Se määrittelee säännöt ja protokollat, joiden avulla sovellukset voivat pyytää ja vaihtaa tietoja toistensa kanssa ilman, että niiden sisäinen toiminta paljastuu.
ChatGPT on OpenAI:n kehittämä käyttöliittymä, joka tarjoaa helpon tavan kokeilla tekoälymalleja suoraan selaimessa. Vaikka se on kätevä työkalu, sillä on rajoituksia verrattuna API:kautta tapahtuvaan integrointiin.
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.