API Reference
Przegląd
Punkty końcowe i konwencje asynchronicznego API obrazów.
SeedRouter udostępnia modele obrazu, wideo, audio i tekstu przez jedno API i jeden klucz API. Modele obrazu, wideo i audio działają jako zadania asynchroniczne: wysyłasz żądanie, dostajesz ID zadania i odpytujesz je o wynik. Modele tekstowe odpowiadają od razu, w formacie żądań dostawcy modelu.
Adres bazowy
https://api.seedrouter.aiUżywaj HTTPS i wysyłaj treść żądań w JSON. Punkty końcowe audio przyjmują zamiast tego plik przesłany jako multipart/form-data.
Uwierzytelnianie
Wysyłaj klucz jako token Bearer w każdym żądaniu, także przy odpytywaniu zadań:
Authorization: Bearer YOUR_API_KEYPunkt końcowy Anthropic Messages przyjmuje klucz także w x-api-key, razem z nagłówkiem anthropic-version. Zobacz Uwierzytelnianie.
Punkty końcowe zadań multimedialnych
| Metoda | Ścieżka | Przeznaczenie |
|---|---|---|
| POST | /v1/images/generations | Wysyła zadanie generowania lub edycji obrazu: GPT Image, Nano Banana i Midjourney. |
| POST | /v1/videos/generations | Wysyła zadanie wideo: Seedance 2.5 i 2.0 (treść żądania ModelArk), Veo 3.1, Kling 3.0, MiniMax H3 i SD Video. |
| POST | /v1/audio/transcriptions | Wysyła plik audio do transkrypcji przez Whisper-1. |
| POST | /v1/audio/translations | Wysyła plik audio do tłumaczenia na angielski przez Whisper-1. |
| GET | /v1/tasks/{id} | Odczytuje stan i wynik zadania obrazu, wideo lub audio. |
Obrazy, wideo i audio referencyjne przekazujesz jako adresy URL w treści żądania. Żądanie obrazu staje się edycją, gdy zawiera obrazy wejściowe. Parametry każdego modelu znajdziesz w jego dokumentacji.
Punkty końcowe tekstu
| Metoda | Ścieżka | Format żądania |
|---|---|---|
| POST | /v1/chat/completions | OpenAI Chat Completions |
| POST | /v1/responses | OpenAI Responses |
| POST | /v1/messages | Anthropic Messages |
| POST | /v1beta/models/{model}:generateContent | Google Gemini |
| POST | /v1beta/models/{model}:streamGenerateContent | Google Gemini, strumieniowo |
| GET | /v1/models | Wyświetla listę dostępnych modeli |
Nie każdy model tekstowy obsługuje każdy format. Dokumentacja API modelu podaje formaty, które przyjmuje; na przykład Claude Opus 5.5 przyjmuje Chat Completions, Responses i Messages, a modele tekstowe Gemini korzystają ze ścieżek /v1beta.
Cykl życia żądania
Zadania multimedialne
- Wyślij żądanie. Odpowiedzią jest zadanie, a nie gotowy plik: zapisz jego
id. - Odpytuj zadanie, aż osiągnie stan końcowy. Zadania na
/v1/tasks/{id}zgłaszająprocessing, a potemcompletedlubfailed. - Odczytaj wynik. Obrazy są w
output.data[].url, wideo woutput.video_url, wynik Whisper woutput.url. Każdy link do wyniku prowadzi do magazynu SeedRouter.
W razie niepowodzenia sprawdź error.code i error.message. Nieudane zadania nie są naliczane. Nie ma webhooka o zakończeniu; odpytuj zadanie tak, jak opisano w Webhooks.
Żądania tekstowe
Żądanie tekstowe zwraca odpowiedź modelu w tej samej odpowiedzi, w oficjalnej strukturze odpowiedzi dostawcy. Ustaw stream na true albo użyj :streamGenerateContent dla Gemini, aby otrzymywać zdarzenia server-sent events (SSE). Modele tekstowe są rozliczane za tokeny.