API Gol AI v1.0

Публичное API для распознавания знаменитостей по фото.

①Эндпоинт

②Заголовки

Заголовок	Обязательно	Описание
Authorization	Да	Bearer <твой API-ключ>
Content-Type	Да	application/json

③Тело запроса

Поле	Тип	Обязательно	Описание
image	string	Да	Фото в формате data URL (data:image/jpeg;base64,...) или чистый base64
model	string	Нет	Всегда используется auto — модель выбирается автоматически

Выбор модели

Распознавание выполняется автоматически (режим auto): сначала GPT 5.4, при сбое — Mistral. Возможность вручную указать модель недоступна — всегда используется авто-режим. Параметр model в запросе игнорируется.

④Пример (cURL)

curl -X POST https://golai.ru/api-celebrity \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"image":"data:image/jpeg;base64,/9j/4AAQSkZJRg..."}'

⑤Пример (Node.js)

const response = await fetch('https://golai.ru/api-celebrity', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({ image: base64Image })
});
const data = await response.json();
console.log(data.matches);

⑥Ответ

{
  "matches": [
    {
      "name": "Brad Pitt",
      "similarity": 92,
      "photo": "https://upload.wikimedia.org/..."
    },
    {
      "name": "George Clooney",
      "similarity": 78,
      "photo": "https://upload.wikimedia.org/..."
    }
  ],
  "modelUsed": "GPT 5.4"
}

Коды ошибок

Код	Описание
401	Неверный или отсутствующий API-ключ
400	Нет поля image
502	Нейросеть временно недоступна (попробуй позже)