AIWave
JA
APIキーを作成

迷路のないドキュメント

始める場所
すでに動いているもの。

形

リクエストの形に従い、期待されるレスポンスを検査し、非同期作業が最終状態に達するまで見えるままに保つ。

表1 — パス

五つのパス、 三つの挙動。

メソッドパス契約返り値挙動
POST/v1/chat/completionsOpenAI互換メッセージ同期
POST/v1/messagesClaudeネイティブメッセージ同期
POST/v1/images/generations生成結果URL同期
POST/v1/images/editsMultipart結果URL同期
POST/v1/video/generations生成タスクID非同期
GET/v1/video/generations/{task_id}生成ステータス、次にURL最終状態までポーリング

パスは公開時のもの。アクティブなカタログと各パスのモデルIDは使用時に確認する。

最初に書くことになるもの

クライアントがすでにこの形を話しているなら、変わるのはボディ内のモデル名だけ。

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."}]}'