Pierwsze kroki

Ta ścieżka prowadzi użytkownika samoobsługowego od rejestracji do pierwszego zapytania API. Jeśli Twoja organizacja jest podłączana przez OmevAI, użyj dostępu i klucza dostarczonych podczas zarządzanej konfiguracji; poniższe kroki dotyczące API są takie same.

1. Utwórz konto samoobsługowe

1. Otwórz cabinet.omev.be i wybierz Start free trial.
2. Wprowadź swój służbowy adres e-mail i opisz, jak używasz AI. Dane firmy i przewidywany miesięczny wolumen są opcjonalne.
3. Ukończ weryfikację przeglądarki i prześlij formularz.
4. Otwórz e-mail od OmevAI. Zawiera on link do logowania i sześciocyfrowy kod; obie metody działają.
5. Po weryfikacji panel klienta tworzy konto i wyświetla początkowy klucz API.

Samoobsługowy okres próbny obejmuje 5 USD środków na 10 dni i nie wymaga podawania karty płatniczej. API tekstowe i API języka naturalnego działają na każdym kluczu; obrazy, wideo i produkty badawcze są włączane dla klucza na życzenie.

2. Zapisz klucz

Skopiuj pełny klucz bezpośrednio do swojego menedżera haseł lub systemu zarządzania sekretami. Dla początkowego klucza ekran Keys może oferować dodatkową akcję Show the key once. Po wykorzystaniu tej jednorazowej opcji wyświetlenia, dostępna będzie już tylko maska. Klucz utworzony później na ekranie organizacji musi zostać skopiowany podczas jego tworzenia.

Nigdy nie umieszczaj klucza w kodzie JavaScript po stronie przeglądarki, w aplikacji mobilnej, w publicznym repozytorium, na zrzucie ekranu ani w wiadomości do wsparcia technicznego. Poniższe przykłady zakładają, że klucz jest przechowywany na serwerze jako OMEV_API_KEY.

3. Sprawdź, do czego klucz ma dostęp

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

Buduj aplikacje tylko w oparciu o udokumentowane publiczne nazwy omev-* zwrócone dla Twojego klucza. Produkty do generowania obrazów pojawią się dopiero po włączeniu dostępu do nich. Ceny wszystkich produktów znajdziesz na stronie Modele i ceny.

4. Wyślij pierwsze zapytanie tekstowe

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
  }'

Odpowiedź znajduje się w choices[0].message.content. Zobacz Modele, aby dowiedzieć się więcej o Pythonie, wyborze modeli, streamingu i ustrukturyzowanym JSON-ie.

5. Przetestuj dokładne zapytanie w Playground

Otwórz Playground w panelu klienta, gdy chcesz przetestować ten sam obiekt JSON, który wyśle Twoja aplikacja. Możesz wkleić istniejące polecenie curl lub zbudować zapytanie w formularzu. Playground pokazuje odpowiedź, liczbę tokenów, czas trwania, treść zapytania oraz przykłady kodu dla curl, Pythona i NodeJS.

Klucz w skopiowanym kodzie jest zamaskowany. Zastąp maskę OMEV_API_KEY lub odwołaniem do menedżera sekretów przed uruchomieniem przykładu poza przeglądarką.

6. Przejrzyj użycie i koszty

Konta samoobsługowe korzystają z zakładek Dashboard, Usage, Journal i Billing w panelu klienta. Pojawienie się ostatnich wywołań może zająć kilka minut.

Klienci korporacyjni otrzymują również dostęp do usage.omev.be po utworzeniu organizacji i zatwierdzeniu pierwszego właściciela. Właściciel może zapraszać dodatkowe osoby bez konieczności proszenia OmevAI o ręczne wprowadzanie każdego adresu e-mail.

7. Kontynuuj bezpiecznie

• Używaj osobnych kluczy, jeśli panel klienta i Twoja rola na to pozwalają, a oddzielna kontrola jest przydatna.
• Ustaw max_tokens, aby ograniczyć liczbę rozliczanych tokenów wyjściowych, skonfiguruj limity czasu (timeout) i niewielką maksymalną liczbę ponowień.
• Ponawiaj zapytania w przypadku odpowiedzi 429, tymczasowych błędów 5xx i przejściowych błędów sieciowych, stosując rosnące opóźnienie. Nie powtarzaj niezmienionego zapytania, które zwróciło błąd 400, 401, 403, 404 lub 413.
• Waliduj ustrukturyzowane dane wyjściowe we własnej aplikacji.
• Przechowuj w logach identyfikatory zapytań i maski kluczy, nigdy pełne klucze ani poufne prompty.

W przypadku pytań dotyczących dostępu lub nierozwiązanego problemu skontaktuj się z support@omev.be. Podaj adres e-mail konta, przybliżony czas i strefę czasową, endpoint, publiczny model, status, identyfikator zapytania (jeśli jest dostępny) oraz oczyszczony z danych wrażliwych przykład.