Korzystanie z SeedRouter przez agentów AI

Agent może korzystać z SeedRouter na trzy sposoby. Wszystkie korzystają z tego samego klucza API, salda, modeli i limitów oraz są rozliczane tak samo.

Aby uruchomić samego agenta na modelach tekstowych SeedRouter, zobacz Agenci programistyczni na SeedRouter.

Ustaw klucz raz

Utwórz klucz na stronie kluczy API i wyeksportuj go, aby agent mógł go odczytać bez umieszczania klucza w plikach projektu:

export SEEDROUTER_API_KEY=YOUR_API_KEY

Na stronie kluczy API jest także przycisk Połącz przez MCP, który wyświetla gotową konfigurację dla każdego klienta MCP.

Co agent robi w SeedRouter

1. Znajdź model: list_models przez MCP lub lista modeli w /llms.txt. Każdy model ze stroną docelową ma pod adresem https://seedrouter.ai/models/<slug>/llms.txt podsumowanie w zwykłym tekście z parametrami, cenami i przykładami.
2. Odczytaj schemat danych wejściowych: get_model_schema przez MCP lub strona dokumentacji modelu.
3. Używaj publicznych adresów URL mediów: punkty końcowe generowania przyjmują obrazy, wideo i audio referencyjne wyłącznie jako publiczne adresy URL http(s). Dane wejściowe Base64 są odrzucane, więc najpierw umieść lokalne pliki w dostępnym miejscu.
4. Sprawdź cenę: get_pricing przez MCP zwraca bieżące stawki modelu w USD, zanim cokolwiek zostanie wysłane.
5. Wyślij i czekaj: submit_task, a następnie get_task z wait_seconds: 50, aż zadanie się zakończy. Przy użyciu HTTP wyślij zadanie do punktu końcowego modelu i odpytuj GET /v1/tasks/{id} mniej więcej co trzy sekundy.

Nieudane zadania nie są naliczane. Wysłanie nie jest idempotentne: ponowienie żądania, którego odpowiedzi nie udało Ci się otrzymać, tworzy drugie zadanie i ponownie potrąca środki, więc najpierw sprawdź swoją historię zadań lub saldo.

Limity do uwzględnienia

Żądania mogą także podlegać ograniczeniu częstotliwości, co również zwraca HTTP 429. Przy HTTP 429 odczekaj czas podany w Retry-After, jeśli ten nagłówek jest obecny; w przeciwnym razie wydłużaj czas oczekiwania wykładniczo po każdej ponownej próbie, z losowym odchyleniem i maksymalnym czasem oczekiwania. Podejmuj decyzję na podstawie kodu statusu zamiast analizować treść błędów, ponieważ punkty końcowe tekstu odpowiadają w formacie błędów swojego protokołu. Proces wsadowy powinien utrzymywać kolejkę i wysyłać nowe zadania, gdy wykonywane się kończą, zamiast wysyłać wszystko naraz. Skontaktuj się z [email protected], jeśli potrzebujesz wyższego limitu.

Punkty dostępu do odczytu maszynowego