Documentação sem labirinto
Comece pelo
o que já funciona.
Forma
Siga o formato da requisição, inspecione a resposta esperada e mantenha o trabalho assíncrono visível até ele chegar a um estado terminal.
Tabela 1 — as rotas
Cinco rotas, três comportamentos.
| Método | Rota | Contrato | Retorna | Comportamento |
|---|---|---|---|---|
| POST | /v1/chat/completions | Compatível com OpenAI | Mensagem | Síncrona |
| POST | /v1/messages | Nativo do Claude | Mensagem | Síncrona |
| POST | /v1/images/generations | Geração | URL do resultado | Síncrona |
| POST | /v1/images/edits | Multipart | URL do resultado | Síncrona |
| POST | /v1/video/generations | Geração | Id da tarefa | Assíncrona |
| GET | /v1/video/generations/{task_id} | Geração | Status e depois URL | Consultar até o estado terminal |
As rotas são listadas conforme publicadas. O catálogo ativo e os identificadores de modelo de cada rota são confirmados no ponto de uso.
A que você vai escrever primeiro
Se o seu cliente já fala esse formato, a única coisa que muda é o nome do modelo no corpo.
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."}]}'