OpenRouter предоставляет доступ к множеству API нейросетей, позволяя пользователям эффективно взаимодействовать с различными моделями. В этом гайде мы разберем, как получить структурированный вывод JSON, что особенно полезно при работе с данными нейросетей.

Подготовка

Перед тем как начать, убедитесь, что у вас есть:

  • Аккаунт на OpenRouter.
  • API-ключ формата sk-or-v1-..., который вы можете найти в разделе Keys вашего аккаунта.
  • Установленный OpenAI SDK или другой HTTP-клиент для отправки запросов.

Настройка API-запроса

Для получения структурированного вывода JSON, выполните следующие шаги:

  1. Определите базовый URL: Для всех запросов используйте https://openrouter.ai/api/v1.
  2. Выберите модель: Убедитесь, что вы выбираете модель в формате вендор/модель, например openai/gpt-4o-mini.
  3. Сформируйте запрос: Используйте следующий пример запроса для получения ответа от модели:
curl https://openrouter.ai/api/v1/chat/completions \
  -H "Authorization: Bearer sk-or-v1-..." \
  -H "Content-Type: application/json" \
  -d '{"model": "openai/gpt-4o-mini", "messages": [{"role": "user", "content": "Ваш запрос"}]}';

Проверка результата

После отправки запроса вы получите ответ в формате JSON. Убедитесь, что он содержит необходимые данные. Пример ответа:

{"id": "chatcmpl-...", "object": "chat.completion", "created": 1680000000, "model": "openai/gpt-4o-mini", "choices": [{"message": {"role": "assistant", "content": "Ответ нейросети"}, "finish_reason": "stop", "index": 0}]};

Типичные ошибки и их причины

Вот несколько распространенных ошибок, с которыми вы можете столкнуться:

  • Error 402 insufficient credits: Это происходит, если у вас нулевой баланс на аккаунте OpenRouter. Пополните баланс, чтобы избежать этой ошибки.
  • Неверный API-ключ: Убедитесь, что вы используете правильный ключ из вашего аккаунта.
  • Неправильное название модели: Проверьте, что вы используете полное название модели в формате вендор/модель.
Закончились кредиты? Пополните баланс OpenRouter за рубли — картой РФ или через СБП, зачисление автоматическое за пару минут. Пополнить OpenRouter →

Полезные советы

1. Регулярно проверяйте баланс своего аккаунта, чтобы избежать ошибок при выполнении запросов.

2. Изучите документацию на сайте OpenRouter для получения дополнительной информации о доступных моделях и их возможностях.

3. Экспериментируйте с различными параметрами запроса, чтобы получить наиболее подходящий для вас структурированный вывод JSON.

Заключение

Получение структурированного вывода JSON в OpenRouter — это простой и эффективный процесс, если следовать указанным шагам. Правильная настройка запросов и внимательное отношение к возможным ошибкам помогут вам добиться желаемых результатов в работе с нейросетями.