Documentación sin laberinto
Empieza por
lo que ya funciona.
Forma
Sigue la forma de la petición, inspecciona la respuesta esperada y mantén visible el trabajo asíncrono hasta que llegue a un estado terminal.
Tabla 1 — las rutas
Cinco rutas, tres comportamientos.
| Método | Ruta | Contrato | Devuelve | Comportamiento |
|---|---|---|---|---|
| POST | /v1/chat/completions | Compatible con OpenAI | Mensaje | Sincrónica |
| POST | /v1/messages | Nativo de Claude | Mensaje | Sincrónica |
| POST | /v1/images/generations | Generación | URL del resultado | Sincrónica |
| POST | /v1/images/edits | Multipart | URL del resultado | Sincrónica |
| POST | /v1/video/generations | Generación | Id de tarea | Asíncrona |
| GET | /v1/video/generations/{task_id} | Generación | Estado y luego URL | Sondear hasta el estado terminal |
Las rutas se listan tal como se publican. El catálogo activo y los identificadores de modelo de cada ruta se confirman en el punto de uso.
La que vas a escribir primero
Si tu cliente ya habla esta forma, lo único que cambia es el nombre del modelo en el cuerpo.
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."}]}'