Початок роботи

Цей посібник проведе користувача, що обслуговується самостійно, від реєстрації до першого запиту до API. Якщо вашу організацію підключає OmevAI, використовуйте доступ і ключ, надані під час керованого налаштування; кроки для роботи з API, описані нижче, залишаються такими ж.

1. Створіть обліковий запис для самообслуговування

1. Відкрийте cabinet.omev.be і натисніть Start free trial.
2. Введіть свою робочу електронну адресу й опишіть, як ви використовуєте ШІ. Надавати інформацію про компанію та очікуваний місячний обсяг не обов'язково.
3. Пройдіть перевірку браузера та надішліть форму.
4. Відкрийте лист від OmevAI. Він містить посилання для входу та шестизначний код; обидва способи підходять.
5. Після підтвердження кабінет створить обліковий запис і покаже початковий ключ API.

Пробний період для самообслуговування включає 5 доларів США кредиту на 10 днів і не вимагає платіжної картки. Текстовий API та API природної мови працюють на кожному ключі; зображення, відео та дослідницькі продукти вмикаються для ключа на запит.

2. Збережіть ключ

Скопіюйте повний ключ безпосередньо у свій менеджер паролів або систему керування секретами. Для початкового ключа на екрані Keys може бути доступна додаткова дія Show the key once. Після її використання буде відображатися лише маска ключа. Ключ, створений пізніше на екрані організації, потрібно скопіювати під час його створення.

Ніколи не розміщуйте ключ у JavaScript на стороні браузера, мобільному застосунку, публічному репозиторії, на знімках екрана чи в повідомленнях до служби підтримки. Приклади нижче припускають, що ключ зберігається на сервері як OMEV_API_KEY.

3. Перевірте, що може використовувати ключ

curl -sS https://llmapi.omev.be/v1/models \
  -H "Authorization: Bearer $OMEV_API_KEY"

Розробляйте рішення, використовуючи лише задокументовані публічні імена omev-*, які повертаються для вашого ключа. Продукти для генерації зображень з'являться тільки після того, як для них буде ввімкнено доступ. Ціни всіх продуктів наведено на сторінці Моделі та ціни.

4. Надішліть перший текстовий запит

curl -sS https://llmapi.omev.be/v1/chat/completions \
  -H "Authorization: Bearer $OMEV_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "omev-lite",
    "messages": [
      {"role": "system", "content": "Follow the requested format carefully."},
      {"role": "user", "content": "Summarise this text in five bullets: ..."}
    ],
    "temperature": 0.2,
    "max_tokens": 500,
    "stream": false
  }'

Відповідь міститься в choices[0].message.content. Дивіться розділ Моделі для прикладів на Python, вибору моделі, потокової передачі та структурованого JSON.

5. Протестуйте точний запит у Playground

Відкрийте Playground у веб-кабінеті, щоб протестувати той самий JSON, який надсилатиме ваш застосунок. Ви можете вставити наявну команду curl або створити запит у формі. Playground показує відповідь, кількість токенів, тривалість, тіло запиту та приклади коду для curl, Python і NodeJS.

У скопійованому коді ключ замасковано. Замініть маску на OMEV_API_KEY або посилання на ваш менеджер секретів, перш ніж запускати приклад поза браузером.

Playground перевіряє технічну відповідність майбутнього виклику API. Це не робоча черга й не окремий інтерфейс для постійної роботи зі штучним інтелектом. Використовуйте Chat окремо, коли потрібно оцінити якість відповідей на показових майбутніх запитах API.

6. Перегляньте використання та витрати

Облікові записи для самообслуговування використовують розділи Dashboard, Usage, Journal та Billing у веб-кабінеті. Останні виклики можуть з'являтися із затримкою в кілька хвилин.

Корпоративні клієнти також отримують доступ до usage.omev.be після створення організації та затвердження першого власника. Власник може запрошувати інших людей, не звертаючись до OmevAI для ручного додавання кожної електронної адреси.

7. Продовжуйте безпечно

• Використовуйте окремі ключі, якщо це дозволяє ваш кабінет і роль, і коли корисний роздільний контроль.
• Встановіть max_tokens, щоб обмежити кількість оплачуваних вихідних токенів, задайте тайм-аути та невелику максимальну кількість повторних спроб.
• Повторюйте запити з відповідями 429, тимчасовими 5xx та при тимчасових мережевих помилках зі зростаючою затримкою. Не повторюйте без змін запити, що повернули 400, 401, 403, 404 або 413.
• Перевіряйте структурований вивід у вашому власному застосунку.
• Зберігайте в логах ідентифікатори запитів і маски ключів, але ніколи не повні ключі чи конфіденційні запити (промпти).

Із запитаннями щодо доступу або невирішеними проблемами звертайтеся до support@omev.be. Вкажіть електронну адресу облікового запису, приблизний час і часовий пояс, ендпоінт, публічну модель, статус, ідентифікатор запиту (якщо є) та очищений від конфіденційних даних приклад.