Clarify text on your page

[Kembreg1405]

This text is not clear:

Gemini API PHP client does not come with an HTTP client. If you are just testing or do not have an HTTP client library in your project, you need to allow php-http/discovery composer plugin or install a PSR-18 compatible client library.

---

Please make the text clearer.

1. What is an HTTP client library?
2. Why would one need one?

[Plytas]

Gemini is LLM solution provided by Google. To interact with it you need to make HTTP requests. To use this package you need HTTP client to make those requests.

If you are willing to not use HTTP client and write your own HTTP requests (curl possibly?) then you might as well not use this package and interact with Gemini REST API directly.

[Kembreg1405]

Hi. Not entirely true.
All you need to interface with Gemini is a few lines of PHP code:

$apiKey='XXXXXXXXXXXXXX';
$url = "https://generativelanguage.googleapis.com/v1beta/models/gemini-1.5-pro-latest:generateContent?key=$apiKey";
$query['text']='Why is PHP composer about as beneficial as a chocolate teapot?';
$message['role']='user';
$message['parts']=array($query);
$data['contents']=array($message);
$payload=json_encode($data);
$headers=['Content-Type:application/json','X-GEMINI-APIKEY:'.$apiKey];
$ch=curl_init($url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $payload);
$response=curl_exec($ch);
curl_close($ch);
$result=json_decode($response,true);
echo $result['candidates'][0]['content']['parts'][0]['text'];

[Plytas]

Hi. Not entirely true.
All you need to interface with Gemini is a few lines of PHP code:

My reply is still true. As I said, you can write your own requests and interact with Gemini REST API. The code you provided seems to do exactly that. In that case you don't need this package and HTTP client.

[Kembreg1405]

Hi. An honest question because I am interested in knowing... If a few lines of code suffice, is there an advantage in using an SDK?

[Plytas]

The whole idea of an SDK is to not write these lines yourself. It provides you an abstraction that's much more readable and easier to maintain.

use GeminiAPI\Client;
use GeminiAPI\Resources\ModelName;
use GeminiAPI\Resources\Parts\TextPart;

$client = new Client('GEMINI_API_KEY');
$response = $client->generativeModel(ModelName::GEMINI_PRO)->generateContent(
    new TextPart('PHP in less than 100 chars'),
);

print $response->text();
// PHP: A server-side scripting language used to create dynamic web applications.
// Easy to learn, widely used, and open-source.

If you are comfortable with writing raw PHP and calling Gemini API directly, then by all means you can do that.