Что такое API Finder

API FInder — это универсальное решение для доступа к API ведущих сервисов в области искусственного интеллекта, таких как OpenAI, Anthropic и Gemini. Сервис выступает в роли посредника: запросы отправляются на наш сервер, который перенаправляет их через цепочку прокси-серверов в Европе. Мы получаем ответ от целевого сервиса и возвращаем его вам.

Для работы с API Finder не требуется создавать аккаунты в сторонних системах — управление и оплата происходит через ваш личный кабинет API Finder, а запросы нужно отправлять на наши серверы.


Для работы с API Finder на php можно использовать библиотеку - github


Ключ API

Для использования API Finder необходимо получить ключ. Для этого необходимо зарегистрироваться на сайте и перейти в раздел Ключ API.


Авторизация

Authorization: Bearer КЛЮЧ

Путь к API

Для того, чтобы использовать сервис API Finder, запросы необходимо отправлять по адресу https://apifinder.ru/api/v1

В зависимости от провайдера, к которому идет обращение, после домена также необходимо указывать соответствующий идентификатор, например: https://apifinder.ru/api/v1/openai.

Запрос баланса

Для удобства пользователей API FInder предоставляет доступ к балансу личного кабинета.

GET https://apifinder.ru/api/v1/user/balance

Headers

Authorization string
Bearer токен для авторизации. Пример: Bearer your_api_token
Curl
PHP
curl https://apifinder.ru/api/v1/user/balance -H "Authorization: Bearer КЛЮЧ"
<?php
$apiKey = 'КЛЮЧ';

$options = [
    'http' => [
        'header' => [
            'Content-Type: application/json',
            'Authorization: Bearer ' . $apiKey
        ],
        'method' => 'GET'
    ]
];

$context = stream_context_create($options);
$result = file_get_contents('https://apifinder.ru/api/v1/user/balance', false, $context);

Результат

{
    "success": true,
    "data": {
        "balance": 0
    }
}
{
    "success": true,
    "data": {
        "balance": 0
    }
}

Генерация текста OpenAI API

Все методы и форматы запросов и ответов в API Finder идентичны оригинальным от OpenAI. Таким образом, официальные SDK полностью совместимы с API Finder.

Для запросов к OpenAI в качестве пути к API необходимо использовать:.

https://apifinder.ru/api/v1/openai

Пример

POST https://apifinder.ru/api/v1/openai/v1/chat/completions

Headers

Authorization string
Bearer токен для авторизации. Пример: Bearer your_api_token

URL параметры

model string (required)
ID модели (например, "gpt-4", "gpt-3.5-turbo")
messages array (required)
Массив сообщений в чате, где каждое сообщение имеет роль и содержание
temperature float (option, default: 1.0)
Степень случайности (0.0 - детерминировано, 2.0 - очень случайно)
top_p float (option, default: 1.0)
Альтернатива temperature (ядерная выборка)
max_tokens integer (option)
Максимальное количество токенов в ответе

Результат

success boolean
Статус генерации.
data array
Массив с результатом запроса
Curl
PHP
Laravel
curl https://apifinder.ru/api/v1/openai/v1/chat/completions \
  -H "Authorization: Bearer КЛЮЧ" \
  -d '{
    "model": "gpt-3.5-turbo",
    "messages": [{"role": "user", "content": "Расскажи анекдот!"}],
    "temperature": 0.7
  }'
<?php
$apiKey = 'КЛЮЧ';
$url = 'https://apifinder.ru/api/v1/openai/v1/chat/completions';

$data = [
   'model' => 'gpt-3.5-turbo',
   'messages' => [
       ['role' => 'system', 'content' => 'Ты полезный ассистент, который отвечает на вопросы.'],
       ['role' => 'user', 'content' => 'Расскажи кратко о PHP.']
   ],
   'temperature' => 0.7,
   'max_tokens' => 150
];

$options = [
   'http' => [
       'header' => [
           'Authorization: Bearer ' . $apiKey,
           'Accept: application/json'
       ],
       'method' => 'POST',
       'content' => json_encode($data),
       'ignore_errors' => true
   ]
];

$context = stream_context_create($options);
$response = file_get_contents($url, false, $context);

if ($response === false) {
   $error = error_get_last();
   die('Ошибка запроса: ' . $error['message']);
}

$result = json_decode($response, true);

// Обработка ответа
if (isset($result['choices'][0]['message']['content'])) {
   echo "Ответ от ChatGPT:\n";
   echo $result['choices'][0]['message']['content'];
} else {
   echo "Ошибка в ответе API:\n";
   print_r($result);
}
?>
<?php
use Wilfreedi\ApiFinder\Facades\ApiFinder;

try {
    $params = [
        'model' => 'gpt-3.5-turbo',
        'messages' => [
            ['role' => 'system', 'content' => 'Ты полезный ассистент, который отвечает на вопросы.'],
            ['role' => 'user', 'content' => 'Расскажи кратко о PHP.']
        ],
        'temperature' => 0.7,
        'max_tokens' => 150
    ];
    $response = ApiFinder::openAI()->chat($params);
    print_r($response);
} catch (\Wilfreedi\ApiFinder\Exceptions\ApiException $e) {
    // Обработка ошибок API
    echo "API Error: " . $e->getMessage() . " (Status: " . $e->getCode() . ")\n";
}
?>

Результат

{
    "success": true,
    "data": {
        "id": "chatcmpl-123",
        "object": "chat.completion",
        "created": 1677652288,
        "choices": [
            {
              "index": 0,
              "message": {
                "role": "assistant",
                "content": "OpenAI API предоставляет доступ к мощным языковым моделям..."
              },
              "finish_reason": "stop"
            }
        ],
        "usage": {
        "prompt_tokens": 15,
        "completion_tokens": 42,
        "total_tokens": 57
        }
    }
}
{
    "success": true,
    "data": {
        "id": "chatcmpl-123",
        "object": "chat.completion",
        "created": 1677652288,
        "choices": [
            {
              "index": 0,
              "message": {
                "role": "assistant",
                "content": "OpenAI API предоставляет доступ к мощным языковым моделям..."
              },
              "finish_reason": "stop"
            }
        ],
        "usage": {
        "prompt_tokens": 15,
        "completion_tokens": 42,
        "total_tokens": 57
        }
    }
}
{
    "success": true,
    "data": {
        "id": "chatcmpl-123",
        "object": "chat.completion",
        "created": 1677652288,
        "choices": [
            {
              "index": 0,
              "message": {
                "role": "assistant",
                "content": "OpenAI API предоставляет доступ к мощным языковым моделям..."
              },
              "finish_reason": "stop"
            }
        ],
        "usage": {
        "prompt_tokens": 15,
        "completion_tokens": 42,
        "total_tokens": 57
        }
    }
}