AI

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

Ссылка: AI

Вход/Регистрация

1. Откройте Вход.
2. Войдите через Apple, Google или код из письма. Новые пользователи регистрируются автоматически.
3. В одном аккаунте вы управляете услугами AI, балансом и платёжными документами.

Пополнить баланс

1. Откройте Способы оплаты и пополните баланс доступным способом.
2. Поддерживайте достаточный баланс для ежемесячной стоимости, указанной перед покупкой, и последующих продлений.

Купить услугу

1. Откройте AI.
2. Введите название приложения или интеграции и нажмите Продолжить.
3. Проверьте ежемесячную стоимость и подтвердите создание. Откройте заказ AI в Профиле, чтобы увидеть API-ключ и лимит запросов в минуту.

Подключить приложение

Безопасно задайте переменной AI_API_KEY значение созданного ключа. Храните его на сервере; не встраивайте в публичный код сайта или сборки мобильного приложения.

В клиентах с настраиваемым базовым URL API используйте https://yoosolutions.com/api/v1/ai и модель ai. Запрос обрабатывают провайдер и модель, назначенные вашему заказу; доступность функций зависит от этой модели.

curl --request POST 'https://yoosolutions.com/api/v1/ai/chat/completions' \
  --header "Authorization: Bearer ${AI_API_KEY}" \
  --header 'Content-Type: application/json' \
  --data '{"model":"ai","messages":[{"role":"user","content":"Кратко опиши ход этого проекта."}]}'

Ответ находится в поле choices[0].message.content JSON-ответа.

Поддерживаемые запросы

• Передавайте текст в messages. Сообщения пользователя также могут содержать части image_url с данными JPEG, PNG или WebP в base64; внешние URL изображений отклоняются.
• Используйте response_format со значением text, json_object или json_schema. Для ответа по JSON Schema требуется strict: true.
• Для потоковой передачи задайте stream: true. Чтобы включить статистику использования, также задайте stream_options.include_usage: true.
• Управляйте длиной ответа через max_completion_tokens. Если передаётся store, его значение должно быть false; другие недокументированные поля запроса отклоняются.
• Запросы не сохраняют состояние диалога. Передавайте необходимую историю разговора в messages каждого запроса.

Лимиты и оплата

• Размер запроса ограничен 20 MiB, время — 120 секундами, а ответ — 16384 выходными токенами; по умолчанию доступно 4096 выходных токенов.
• Лимит запросов в минуту, указанный в заказе, действует в скользящем окне 60 секунд и сохраняется при сбросе ключа.
• Продления оплачиваются с баланса. Если продление не оплачено, доступ к API блокируется до успешной оплаты. История списаний, счета и квитанции доступны в Профиле.

Управление услугой

• Редактировать меняет название услуги, не изменяя ключ, модель или лимит.
• Сбросить создаёт новый API-ключ и сразу отзывает старый. Обновите ключ в приложении; сброс не обнуляет лимит запросов.
• Удалить отзывает доступ к API и прекращает будущие списания за услугу.

Решение проблем

• 400: проверьте поля запроса, модель ai и формат сообщений.
• 401: проверьте bearer-ключ и обновите его после сброса.
• 402: проверьте баланс и оплату продления в Профиле.
• 429: перед повторной попыткой подождите количество секунд, указанное в заголовке Retry-After.
• 503: назначенная модель или провайдер недоступны. Повторите попытку позже или обратитесь в Поддержку.