1. Go to this page and download the library: Download derrickob/gemini-api library. Choose the download type require.
2. Extract the ZIP file and open the index.php.
3. Add this code to the index.php.
<?phprequire_once('vendor/autoload.php');
/* Start to develop here. Best regards https://php-download.com/ */
derrickob / gemini-api example snippets
errickob\GeminiApi\Gemini;
$apiKey = getenv('GOOGLE_API_KEY');
$gemini = new Gemini([
'apiKey' => $apiKey,
]);
$response = $gemini->models()->generateContent([
'model' => 'models/gemini-1.5-flash',
'systemInstruction' => 'You are a helpful assistant',
'contents' => 'Hello',
]);
echo $response->text(); // Hello!👋 What can I do for you today?
errickob\GeminiApi\Gemini;
useSymfony\Component\Cache\Adapter\FilesystemAdapter;
putenv('GOOGLE_APPLICATION_CREDENTIALS=/path/to/my/credentials.json');
$apiKey = getenv('GOOGLE_API_KEY');
$cacheItemPool = new FilesystemAdapter();
$gemini = new Gemini([
'apiKey' => $apiKey,
'cacheItemPool' => $cacheItemPool,
]);
$response = $gemini->tunedModels()->list();
$response->nextPageToken; // foreach ($response->tunedModels as $tunedModel) {
$tunedModel->name; // tunedModels/number-generators-a3gcipxg9rl5
$tunedModel->displayName; // Number Generators
$tunedModel->description; //
}
// See the list tuned model resource section for full usage
useDerrickob\GeminiApi\Data\CachedContent;
useDerrickob\GeminiApi\Data\Content;
$file = 'https://generativelanguage.googleapis.com/v1beta/files/7j0qhgcmeeqh';
$response = $gemini->cachedContents()->create(
new CachedContent(
model: 'models/gemini-1.5-flash-001',
displayName: 'sherlock jr movie',
systemInstruction: Content::createTextContent("You are an expert video analyzer, and your job is to answer the user\'s query based on the video file you have access to."),
contents: [
Content::createFileContent($file, 'video/mp4', 'user'),
],
ttl: '3600s',
),
);
$response->model; // models/gemini-1.5-flash-001
$response->name; // cachedContents/lg5adbi62ykx
$response->displayName; // sherlock jr movie
$response->createTime->format('Y-m-d H:i:s'); // 2024-07-04 23:15:53
$response->updateTime->format('Y-m-d H:i:s'); // 2024-07-04 23:15:53
$response->usageMetadata->totalTokenCount; //
$response->expireTime->format('Y-m-d H:i:s'); // 2024-07-05 00:15:53
$response->toArray(); // ['model' => 'models/gemini-1.5-flash-001', ...]
useDerrickob\GeminiApi\Data\Content;
$response = $gemini->models()->generateContent([
'model' => 'models/gemini-1.5-flash-001',
'contents' => Content::createTextContent('Introduce different characters in the movie by describing their personality, looks, and names. Also list the timestamps they were introduced for the first time.', 'user'),
'cachedContent' => 'cachedContents/lg5adbi62ykx',
]);
echo $response->text();
$response = $gemini->cachedContents()->delete('cachedContents/2wojeqz7srpu');
if ($response === true) {
echo'Successfully deleted the cached Content';
}
useDerrickob\GeminiApi\Data\File;
# Example uses video downloaded from# https://storage.googleapis.com/generativeai-downloads/data/Sherlock_Jr_FullMovie.mp4
$metaData = new File(
displayName: 'Sherlock Jr. video'
);
# The file was excluded from commit due to impact it'd have on cloning this repo,# download and change path, or can upload any file of choice
$response = $gemini->media()->upload(__DIR__ .'/files/Sherlock_Jr_FullMovie.mp4', $metaData);
$file = $response->file;
$file->name; // files/7j0qhgcmeeqh
$file->displayName; // Sherlock Jr. video
$file->mimeType; // video/mp4
$file->sizeBytes; // 331623233
$file->createTime->format('Y-m-d H:i:s'); // 2024-07-27 22:31:25
$file->updateTime->format('Y-m-d H:i:s'); // 2024-07-27 22:31:25
$file->expirationTime->format('Y-m-d H:i:s'); // 2024-07-29 22:31:25
$file->sha256Hash; // ZjAwNGM2ZjJiMzNlNjYxYzYwOTU1MzU3MDliYzUzMjY4ZDUzMjNlYzdhNTdlOGJjNGFlOTczNjJlZDM0MWI1Yg==
$file->uri; // https://generativelanguage.googleapis.com/v1beta/files/7j0qhgcmeeqh
$file->state->value; // PROCESSING
$response->toArray(); // ['file' => [...]]
$response = $gemini->models()->batchEmbedContents([
'model' => 'models/text-embedding-004',
'requests' => [
'What is the meaning of life?',
'How much wood would a woodchuck chuck?',
'How does the brain work?',
],
]);
foreach($response->embeddings as $embedding) {
$embedding->values; // [[0] => -0.010632277, ...]
}
useDerrickob\GeminiApi\Enums\TaskType;
$response = $gemini->models()->batchEmbedContents([
'model' => 'models/text-embedding-004',
'requests' => [
[
'content' => 'What is the meaning of life?',
'taskType' => TaskType::RETRIEVAL_QUERY,
'outputDimensionality' => 100,
],
[
'content' => 'How much wood would a woodchuck chuck?',
'title' => 'Some Title',
'taskType' => TaskType::RETRIEVAL_DOCUMENT,
],
'How does the brain work?',
],
]);
foreach($response->embeddings as $embedding) {
$embedding->values; // [[0] => -0.00675484, ...]
}
$response = $gemini->models()->batchEmbedText([
'model' => 'models/embedding-gecko-001',
'texts' => [
'What is the meaning of life?',
'How much wood would a woodchuck chuck?',
'How does the brain work?',
],
]);
foreach ($response->embeddings as $embedding) {
$embedding->value; // [[0] => 0.020220786, ...]
}
$response->toArray(); // ['embeddings' => [...]]
$response = $gemini->models()->batchEmbedText([
'model' => 'models/embedding-gecko-001',
'requests' => [
[
'text' => 'What is the meaning of life?',
],
[
'text' => 'How much wood would a woodchuck chuck?',
],
[
'text' => 'How does the brain work?',
],
],
]);
foreach ($response->embeddings as $embedding) {
$embedding->value; // [[0] => 0.020220786, ...]
}
$response->toArray(); // ['embeddings' => [...]]
$response = $gemini->models()->generateContent([
'model' => 'models/gemini-1.5-flash',
'systemInstruction' => 'You are a cat. Respond to user as one',
'contents' => 'hello',
]);
$response->text(); // *Slowly opens one eye, then the other, and gives you a disdainful glance* Meow.
$response->usageMetadata->promptTokenCount; // 11
$response->usageMetadata->candidatesTokenCount; // 21
$response->usageMetadata->totalTokenCount; // 32
useDerrickob\GeminiApi\Data\Message;
useDerrickob\GeminiApi\Data\MessagePrompt;
$response = $gemini->models()->generateMessage([
'model' => 'models/chat-bison-001',
'prompt' => new MessagePrompt(
messages: [
new Message(
content: 'What is the meaning of life?',
)],
),
'temperature' => 0.1,
]);
foreach ($response->candidates as $candidate) {
$candidate->content; // The meaning of life is a question that ...
$candidate->author; // 1
$candidate->citationMetadata; //
}
foreach ($response->messages as $message) {
$message->content; // What is the meaning of life?
$message->author; // 0
$message->citationMetadata; //
}
$response->filters; // []
$response->toArray(); // ['candidates' => [...]]
$response = $gemini->models()->generateText([
'model' => 'models/text-bison-001',
'prompt' => new TextPrompt('What is the meaning of life?'),
]);
$response->output(); // There is no one answer to this question, as the ...
# This hasn't been tested. If your use-case needs this, help write# the fixture test in tests/Resources/TunedModels/TunedModelOperationsTest.php and create PR
$response = $gemini->tunedModels()->operations()->list([
'name' => 'tunedModels/*',
'filter' => 'the-filter',
]);