Doku ohne Labyrinth
Beginne mit
was bereits läuft.
Form
Folge der Anfrageform, prüfe die erwartete Antwort und halte asynchrone Arbeit sichtbar, bis sie einen Endzustand erreicht.
Tabelle 1 — die Pfade
Fünf Pfade, drei Verhaltensweisen.
| Methode | Pfad | Vertrag | Rückgabe | Verhalten |
|---|---|---|---|---|
| POST | /v1/chat/completions | OpenAI-kompatibel | Nachricht | Synchron |
| POST | /v1/messages | Claude-nativ | Nachricht | Synchron |
| POST | /v1/images/generations | Generierung | Ergebnis-URL | Synchron |
| POST | /v1/images/edits | Multipart | Ergebnis-URL | Synchron |
| POST | /v1/video/generations | Generierung | Task-ID | Asynchron |
| GET | /v1/video/generations/{task_id} | Generierung | Status, dann URL | Bis zum Endzustand abfragen |
Pfade sind wie veröffentlicht gelistet. Aktiver Katalog und Modell-Kennungen werden zur Laufzeit bestätigt.
Das, was du zuerst schreiben wirst
Wenn dein Client diese Form schon spricht, ändert sich nur der Modellname im Body.
POST /v1/chat/completions
curl https://aiwave.live/v1/chat/completions \
-H "Authorization: Bearer $AIWAVE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"your-model-id",
"messages":[{"role":"user",
"content":"Ship one representative request."}]}'